Virtual media commands

Access to the iLO 3 virtual media is supported through the CLP. The virtual media subsystem is located at /map1/oemhp_vm1. See the user guide for more information.

Targets

You can access the following sub-components of the virtual media.

Target	Description
`/map1/oemhp_vm1/floppydr1`	Virtual floppy or key drive device
`/map1/oemhp_vm1/cddr1`	Virtual CD-ROM device

Properties

Property	Access	Description
`oemhp_image`	Read/Write	The image path and name for virtual media access. The value is a URL with a maximum length of 80 characters.
`oemhp_connect`	Read	Displays if a virtual media device is already connected through the CLP or scriptable virtual media.
`oemhp_boot`	Read/Write	Sets the boot flag. The valid values are: Never—Do not boot from the device. The value is displayed as `No_Boot`. Once—Boot from the device only once. The value is displayed as `Once`. Always—Boot from the device each time the server is rebooted. The value is displayed as `Always`. Connect—Connect the virtual media device. Sets oemhp_connect to `Yes` and oemhp_boot to `Always`. Disconnect—Disconnects the virtual media device and sets the oemhp_boot to `No_Boot`.
`oemhp_wp`	Read/Write	Enables or disables the write-protect flag. Boolean values accepted.
`oemhp_applet_connected`	Read	Indicates if the Java™ applet is connected.

Image URL

The oemhp image value is a URL. The URL, which is limited to 80 characters, specifies the location of the virtual media image file on an HTTP server and is in the same format as the scriptable virtual media image location.

URL example:

protocol://username:password@hostname:port/filename

The protocol field is mandatory and must be either HTTP or HTTPS.
The username:password field is optional.
The hostname field is mandatory.
The port field is optional.
The filename field is mandatory.

The CLP performs only a cursory syntax verification of the <URL> value. You must visually verify the URL is valid.

Examples

set oemhp_image=http://imgserver.company.com/image/dosboot.bin
set oemhp_image=http://john:abc123@imgserver.company.com/VMimage/installlDisk.iso

iLO 1.60 CLI support

The vm simple CLI commands are still supported for virtual media:

vm device insert path—Inserts an image
vm device eject—Ejects an image
vm device get—Gets the status of the virtual media
vm device set boot access—Sets the status of the virtual media
Command options:
- Valid device names are floppy or cdrom
  
  NOTE: USB key drives must be used with the floppy keyword syntax.
- The path is the URL to the media image
- Boot options are boot_once, boot_always, no_boot, connect, or disconnect
- Access options are write_protect or write_allow.
For more information about how to use these commands, see the commands INSERT_VIRTUAL_MEDIA, EJECT_VIRTUAL_MEDIA, GET_VM_STATUS, and SET_VM_STATUS in the section"Using RIBCL."

Tasks

Insert a floppy USB key image into the Virtual Floppy/USBKey:
cd /map1/oemhp_vm1/floppydr1

show

set oemhp_image=http://my.imageserver.com/floppyimg.bin

set oemhp_boot=connect

show

This example executes the following commands:
- Change the current context to the floppy or key drive.
- Show the current status to verify that the media is not in use.
- Insert the desired image into the drive.
- Connect the media. The boot setting always connects automatically.
Eject a floppy or USB key image from the Virtual Floppy/USBKey:
cd /map1/oemhp_vm1/floppydr1

set oemhp_boot=disconnect

This example executes the following commands:
- Change the current context to the floppy or key drive.
- Issue the disconnect command that disconnects the media and clears the oemhp_image.
Insert a CDROM image into the virtual CD-ROM:
cd /map1/oemhp_vm1/cddr1

show

set oemhp_image=http://my.imageserver.com/ISO/install_disk1.iso

set oemhp_boot=connect

show

This example executes the following commands:
- Change the current context to the CD-ROM drive.
- Show the current status to verify that the media is not in use.
- Insert the desired image into the drive.
- Connect the media. The boot setting always connects automatically.
Eject a CD-ROM image from the Virtual CD-ROM:
cd /map1/oemhp_vm1/cddr1

set oemhp_boot=disconnect

This example executes the following commands:
- Change the current context to the CD-ROM drive.
- Issue the disconnect command that disconnects the media and clears the oemhp_image.
Insert a CD-ROM image and set for single boot:
cd /map1/oemhp_vm1/cddr1

set oemhp_image=http://my.imageserver.com/ISO/install_disk1.iso

set oemhp_boot=connect

set oemhp_boot=once

show

This example executes the following commands:
- Change the current context to the CD-ROM drive.
- Show the current status to verify that the media is not in use.
- Insert the desired image into the drive.
- Connect the media. The boot setting always connects automatically.
- Override the boot setting to Once.
Eject a CD-ROM image from the virtual CD-ROM in a single command:
set /map1/oemhp_vm1/cddr1 oemhp_boot=disconnect

If you attempt to disconnect when the drive is not connected, you receive an error.