- Oracle VM Server for SPARC 3.6 Administration Guide
- Setting Up Guest Domains
- Creating and Starting a Guest Domain
- How to Create and Start a Guest Domain
How to Create and Start a Guest Domain
- Create a logical domain.
The following command would create a guest domain named
ldg1
.primary# ldm add-domain ldg1
- Add CPUs to the guest domain.
Do one of the following:
-
Add virtual CPUs.
The following command would add eight virtual CPUs to guest domain
ldg1
.primary# ldm add-vcpu 8 ldg1
-
Add whole cores.
The following command would add two whole cores to guest domain
ldg1
.primary# ldm add-core 2 ldg1
-
- Add memory to the guest domain.
The following command would add 2 gigabytes of memory to guest domain
ldg1
.primary# ldm add-memory 2G ldg1
- Add a virtual network device to the guest domain.
The following command would add a virtual network device with these specifics to the guest domain
ldg1
.primary# ldm add-vnet vnet1 primary-vsw0 ldg1
Where:
-
vnet1
is a unique interface name to the logical domain, assigned to this virtual network device instance for reference on subsequentset-vnet
orremove-vnet
subcommands. -
primary-vsw0
is the name of an existing network service (virtual switch) to which to connect.
Note:
Steps 5 and 6 are simplified instructions for adding a virtual disk server device (vdsdev
) to the primary domain and a virtual disk (vdisk
) to the guest domain. To learn how ZFS volumes and file systems can be used as virtual disks, see How to Export a ZFS Volume as a Single-Slice Disk and Using ZFS With Virtual Disks. -
- Specify the device to be exported by the virtual disk server as a virtual disk to the guest domain.
You can export a physical disk, disk slice, volumes, or file as a block device. The following examples show a physical disk and a file.
-
Physical Disk Example. This example adds a physical disk with these specifics:
primary# ldm add-vdsdev /dev/dsk/c2t1d0s2 vol1@primary-vds0
Where:
-
/dev/dsk/c2t1d0s2
is the path name of the actual physical device. When adding a device, the path name must be paired with the device name. -
vol1
is a unique name you must specify for the device being added to the virtual disk server. The volume name must be unique to this virtual disk server instance because this name is exported by this virtual disk server to the clients for adding. When adding a device, the volume name must be paired with the path name of the actual device. -
primary-vds0
is the name of the virtual disk server to which to add this device.
-
-
File Example. This example exports a file as a block device.
primary# ldm add-vdsdev backend vol1@primary-vds0
Where:
-
backend is the path name of the actual file exported as a block device. When adding a device, the back end must be paired with the device name.
-
vol1
is a unique name you must specify for the device being added to the virtual disk server. The volume name must be unique to this virtual disk server instance because this name is exported by this virtual disk server to the clients for adding. When adding a device, the volume name must be paired with the path name of the actual device. -
primary-vds0
is the name of the virtual disk server to which to add this device.
-
-
- Add a virtual disk to the guest domain.
The following example adds a virtual disk to the guest domain
ldg1
.primary# ldm add-vdisk vdisk1 vol1@primary-vds0 ldg1
Where:
-
vdisk1
is the name of the virtual disk. -
vol1
is the name of the existing volume to which to connect. -
primary-vds0
is the name of the existing virtual disk server to which to connect.
Note:
The virtual disks are generic block devices that are associated with different types of physical devices, volumes, or files. A virtual disk is not synonymous with a SCSI disk and, therefore, excludes the target ID in the disk label. Virtual disks in a logical domain have the following format:cNdNsN
, wherecN
is the virtual controller,dN
is the virtual disk number, andsN
is the slice. -
- Set the
auto-boot?
andboot-device
variables for the guest domain.Note:
When setting theboot-device
property value, only use lowercase characters even if the name of the virtual disk contains uppercase characters.The following example command sets
auto-boot?
totrue
for guest domainldg1
.primary# ldm set-var auto-boot\?=true ldg1
The following example command sets
boot-device
tovdisk1
for guest domainldg1
.primary# ldm set-var boot-device=vdisk1 ldg1
- Bind resources to the guest domain
ldg1
and then list the domain to verify that it is bound.primary# ldm bind-domain ldg1 primary# ldm list-domain ldg1 NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME ldg1 bound ----- 5000 8 2G
- To find the console port of the guest domain, you can look at the output of the preceding
list-domain
subcommand.The value in the
CONS
column shows that logical domain guest 1 (ldg1
) has its console output bound to port5000
. - Connect to the console of a guest domain from another terminal by logging into the control domain and connecting directly to the console port on the local host.
$ ssh hostname.domain-name $ telnet localhost 5000
- Start the guest domain
ldg1
.primary# ldm start-domain ldg1