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
|