Previous page

Next page

Locate page in Contents

Print this page

Optical Disk Drive Management Parameters

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

Syntax

pctl set ID | VM_name --device-add cdrom --image image_name

[ --iface ide | scsi ] [ --position number ]

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

pctl set ID | VM_name --device-add cdrom --device device_name

[ --iface ide | scsi ] [ --position number ]

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

pctl set ID | VM_name --device-set cdromN

{ --device name | --image name } [ --iface ide | scsi ]

[ --position number ][ --enable | --disable ]

[ --connect | --disconnect ]

Parameters

Name

Description

ID

The virtual machine ID.

name

The virtual machine name.

--device-add

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

Modifies the parameters of an existing virtual optical disk.

cdrom

Specifies the virtual device type (in this instance, a CD or DVD drive).

cdrom N

The name of the DVD/CD drive to modify. The N postfix indicates the drive index number. To obtain the list of the available drives, use the pctl list command with the --info option.

--device name

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

--image name

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 number

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

  • for IDE devices: 0:0 , 0:1 , 1:0 , 1:1 ;
  • for SCSI device: 0:0 , 1:0 , 2:0 , 3:0 , 4:0 , 5:0 , 6:0 .

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.

--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.

Links

General Syntax , Virtual Device Management , Legend