Previous page

Next page

Locate page in Contents

Print this page

Optical Disk Drive Management Options

This group of options is used to add and configure virtual optical disk drives, such as DVD or CD drives.

Syntax

prlctl set <vm_ID|vm_name> { --device-add cdrom | --device-set cdrom <N> }

{ --device <dev_name> | --image <file> } [ --iface < ide | scsi> ]

[ --position <pos> ] [ --subtype < buslogic | lsi-spi | lsi-sas >]

[ --enable | --disable ] [ --connect | --disconnect ]

Options

Name

Description

<vm_ID|vm_name>

The virtual machine ID or name.

--device-add cdrom

Adds a DVD/CD drive to the virtual machine. You can connect up to four IDE devices and up to seven SCSI devices to a virtual machine. This includes virtual hard disks and DVD/CD drives.

--device-set cdrom <N>

Modifies the parameters of an existing virtual optical disk. The N postfix indicates the drive index number. To obtain the list of the available drives, use the prlctl list command with the --info option.

--device <dev_name>

The name of the physical optical disk to connect to the virtual machine.

--image <file>

The name of an existing disk image file to mount in the virtual machine. Currently, the following image file formats are supported: .iso , .cue , .ccd , and .dmg . The image must not be compressed and/or encrypted.

--iface <ide | scsi>

Interface type:

  • ide — IDE disk.
  • scsi — SCSI disk (default).

--position <pos>

The SCSI, SATA or IDE device identifier to be used for the DVD/CD drive. The allowed ID ranges are the following:

  • IDE devices: 0-3
  • SATA devices: 0-5
  • SCSI device: 0-6

You can use one of the following formats for specifying IDs: ID : bus , ID - bus , ID . For example, if you specify 3:0 (or 3-0 or 3) as number for a SCSI drive, the guest OS will see the drive as having ID 3 on SCSI bus 0.

--subtype < buslogic | lsi-spi | lsi-sas >

Virtual hard disk subtype.

--enable

Enables the specified DVD/CD drive. All newly added drives are enabled by default (provided the --disable option is omitted).

--disable

Disables the specified optical disk drive. The disk drive itself is not removed from the virtual machine configuration.

--connect

Automatically connect the specified optical disk drive during the virtual machine startup process.

--disconnect

Do not automatically connect the specified optical disk drive during the virtual machine startup process.