Create a virtual disk server (vds) to allow importing virtual disks into a logical domain.

For example, the following command adds a virtual disk server (primary-vds0) to the control domain (primary).

primary$ ldm add-vds primary-vds0 primary

Create a virtual console concentrator service (vcc) for use by the virtual network terminal server daemon (vntsd) and as a concentrator for all logical domain consoles.

For example, the following command would add a virtual console concentrator service (primary-vcc0) with a port range from 5000 to 5100 to the control domain (primary).

primary$ ldm add-vcc port-range=5000-5100 primary-vcc0 primary

Create a virtual switch service (vsw) to enable networking between virtual network (vnet) devices in logical domains. Assign a GLDv3-compliant network adapter to the virtual switch if each of the logical domains needs to communicate outside the box through the virtual switch.

For example, the following command would add a virtual switch service (primary-vsw0) on network adapter driver e1000g0 to the control domain (primary).

primary$ ldm add-vsw net-dev=e1000g0 primary-vsw0 primary

This command automatically allocates a MAC address to the virtual switch. You can specify your own MAC address as an option to the ldm add-vsw command. However, in that case, it is your responsibility to ensure that the MAC address specified does not conflict with an already existing MAC address.

If the virtual switch being added replaces the underlying physical adapter as the primary network interface, it must be assigned the MAC address of the physical adapter, so that the Dynamic Host Configuration Protocol (DHCP) server assigns the domain the same IP address. See Enabling Networking Between the Control/Service Domain and Other Domains.

primary$ ldm add-vsw mac-addr=2:04:4f:fb:9f:0d net-dev=e1000g0 primary-vsw0 primary

Verify the services have been created by using the list-services subcommand. Your output should look similar to the following.

primary$ ldm list-services primary
VDS
    NAME             VOLUME         OPTIONS          DEVICE
    primary-vds0
 
VCC
    NAME             PORT-RANGE
    primary-vcc0     5000-5100
 
VSW
    NAME             MAC               NET-DEV   DEVICE     MODE
    primary-vsw0     02:04:4f:fb:9f:0d e1000g0   switch@0   prog,promisc

Assign cryptographic resources to the control domain.

The following example would assign one cryptographic resource to the control domain, primary. This leaves the remainder of the cryptographic resources available to a guest domain.

primary$ ldm set-mau 1 primary

Assign virtual CPUs to the control domain.

For example, the following command would assign 4 virtual CPUs to the control domain, primary. This leaves the remainder of the virtual CPUs available to a guest domain.

primary$ ldm set-vcpu 4 primary

Assign memory to the control domain.

For example, the following command would assign 1 gigabyte of memory to the control domain, primary. This leaves the remainder of the memory available to a guest domain.

primary$ ldm set-memory 1G primary

Add a logical domain machine configuration to the system controller (SC).

For example, the following command would add a configuration called initial.

primary$ ldm add-config initial

Verify that the configuration is ready to be used at the next reboot.

primary$ ldm list-config
factory-default [current]
initial [next]

This list subcommand shows that the factory-default configuration set is currently being used and the initial configuration set will be used once you reboot.

Print out the addressing information for all interfaces.

primary# ifconfig -a

Plumb the virtual switch. In this example, vsw0 is the virtual switch being configured.

primary# ifconfig vsw0 plumb

(Optional) To obtain the list of all virtual switch instances in a domain, you can list them.

primary# /usr/sbin/dladm show-link | grep vsw
vsw0            type: non-vlan  mtu: 1500       device: vsw0

Unplumb the physical network device assigned to the virtual switch (net-dev), which is e1000g0 in this example.

primary# ifconfig e1000g0 down unplumb

To migrate properties of the physical network device (e1000g0) to the virtual switch (vsw0) device, do one of the following:

• If networking is configured using a static IP address, reuse the IP address and netmask of e1000g0 for vsw0.

  
  

  primary# ifconfig vsw0 IP_of_e1000g0 netmask netmask_of_e1000g0 broadcast + up

  
  

• If networking is configured using DHCP, enable DHCP for vsw0.

  
  

  primary# ifconfig vsw0 dhcp start

  
  

Make the required configuration file modifications to make this change permanent.

primary# mv /etc/hostname.e1000g0 /etc/hostname.vsw0
primary# mv /etc/dhcp.e1000g0 /etc/dhcp.vsw0

Use the svcadm(1M) command to enable the virtual network terminal server daemon, vntsd(1M).

# svcadm enable vntsd

Use the svcs(1) command to verify that the vntsd is enabled.

# svcs -l vntsd
fmri         svc:/ldoms/vntsd:default
enabled      true
state        online
next_state   none
state_time   Sat Jan 27 03:14:17 2007
logfile      /var/svc/log/ldoms-vntsd:default.log
restarter    svc:/system/svc/restarter:default
contract_id  93
dependency   optional_all/error svc:/milestone/network (online)
dependency   optional_all/none svc:/system/system-log (online)

Create a logical domain.

For example, the following command would create a guest domain named ldg1.

primary$ ldm add-domain ldg1

Add CPUs to the guest domain.

For example, the following command would add four virtual CPUs to guest domain ldg1.

primary$ ldm add-vcpu 4 ldg1

Add memory to the guest domain.

For example, the following command would add 512 megabytes of memory to guest domain ldg1.

primary$ ldm add-memory 512m ldg1

Add a virtual network device to the guest domain.

For example, 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 subsequent set-vnet or remove-vnet subcommands.

• primary-vsw0 is the name of an existing network service (virtual switch) to which to connect.

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. Exporting loopback (lofi) devices as block devices is not supported in this release of Logical Domains software. The following examples show a physical disk and a file.

• Physical Disk Example. The first example adds a physical disk with these specifics.

  
  

  primary$ ldm add-vdsdev /dev/dsk/c0t0d0s2 vol1@primary-vds0

  
  

  Where:

  • /dev/dsk/c0t0d0s2 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 device 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 device 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 second example is exporting a file as a block device.

  
  

  primary$ ldm add-vdsdev path-to-file/filename vol1@primary-vds0

  
  

  Where:

• path-to-file/filename is the path name of the actual file exported as a block 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 device 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 device 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 virtual disk server device to which to connect.

• primary-vds0 is the name of the existing virtual disk server to which to connect.

Set auto-boot and boot-device variables for the guest domain.

The first example command sets auto-boot\? to true for guest domain ldg1.

primary$ ldm set-var auto-boot\?=true ldg1

The second example command sets boot-device to vdisk for the guest domain ldg1.

primary$ ldm set-var boot-device=vdisk 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    -----  5001   4    512M 

To find the console port of the guest domain, you can look at the output of the preceding list-domain subcommand.

You can see under the heading Cons that logical domain guest 1 (ldg1) has its console output bound to port 5001.

Start the guest domain ldg1.

primary$ ldm start-domain ldg1

Connect to the console of a guest domain. There are several ways you can do this.

• You can log into the control domain and connect directly to the console port on the local host:

  
  

  $ ssh admin@controldom.domain $ telnet localhost 5001

  
  

• You can also connect to a guest console over a network if it is enabled in the vntsd(1M) SMF manifest. For example:

  
  

  $ telnet host-name 5001

  
  

  A Service Management Facility manifest is an XML file that describes a service. For more information about creating an SMF manifest, refer to the Solaris 10 System Administrator Collection.

  
  

  ---

  Note - To access a non-English OS in a guest domain through the console, the terminal for the console must be in the locale required by the OS.

  ---