1. Overview of the Oracle VM Server for SPARC Software
2. Installing and Enabling Software
4. Setting Up Services and the Control Domain
Virtual Disk Identifier and Device Name
Export a Physical Disk as a Virtual Disk
Export a Physical Disk Slice as a Virtual Disk
File or Volume Exported as a Full Disk
File or Volume Exported as a Single-Slice Disk
Export a ZFS Volume as a Single-Slice Disk
Exporting Volumes and Backward Compatibility
Summary of How Different Types of Back Ends Are Exported
Guidelines for Exporting Files and Disk Slices as Virtual Disks
Using the Loopback File (lofi) Driver
Directly or Indirectly Exporting a Disk Slice
Configuring Virtual Disk Multipathing
Configure Virtual Disk Multipathing
Export a CD or DVD From the Service Domain to the Guest Domain
Export an ISO Image From the primary Domain to Install a Guest Domain
Virtual Disk and the format(1M) Command
Configuring a ZFS Pool in a Service Domain
Examples of Storing Disk Images With ZFS
Create a Disk Image Using a ZFS Volume
Create a Disk Image Using a ZFS File
Assign the ZFS Volume or File to a Guest Domain
Creating a Snapshot of a Disk Image
Create a Snapshot of a Disk Image
Using Clone to Provision a New Domain
Using Volume Managers in a Logical Domains Environment
Using Virtual Disks on Top of Volume Managers
Using Virtual Disks on Top of Solaris Volume Manager
Using Virtual Disks When VxVM Is Installed
Using Volume Managers on Top of Virtual Disks
Using ZFS on Top of Virtual Disks
Using Solaris Volume Manager on Top of Virtual Disks
Using VxVM on Top of Virtual Disks
12. Performing Other Administration Tasks
A. Oracle VM Server for SPARC Physical-to-Virtual Conversion Tool
B. Oracle VM Server for SPARC Configuration Assistant
C. Logical Domains Manager Discovery
D. Using the XML Interface With the Logical Domains Manager
This section describes adding a virtual disk to a guest domain, changing virtual disk and timeout options, and removing a virtual disk from a guest domain. See Virtual Disk Back End Options for a description of virtual disk options. See Virtual Disk Timeout for a description of the virtual disk timeout.
# ldm add-vdsdev [options={ro,slice,excl}] [mpgroup=mpgroup] \ backend volume-name@service-name
# ldm add-vdisk [timeout=seconds] [id=disk-id] disk-name volume-name@service-name ldom
You can specify an ID of a new virtual disk device by setting the id property. By default, ID values are automatically generated, so set this property if you need to match an existing device name in the OS. See Virtual Disk Identifier and Device Name.
Note - A back end is actually exported from the service domain and assigned to the guest domain when the guest domain (ldom) is bound.
A virtual disk back end can be exported multiple times either through the same or different virtual disk servers. Each exported instance of the virtual disk back end can then be assigned to either the same or different guest domains.
When a virtual disk back end is exported multiple times, it should not be exported with the exclusive (excl) option. Specifying the excl option will only allow exporting the back end once. The back end can be safely exported multiple times as a read-only device with the ro option.
Caution - When a virtual disk back end is exported multiple times, applications running on guest domains and using that virtual disk are responsible for coordinating and synchronizing concurrent write access to ensure data coherency. |
The following example describes how to add the same virtual disk to two different guest domains through the same virtual disk service.
# ldm add-vdsdev [options={ro,slice}] backend volume1@service-name # ldm add-vdsdev -f [options={ro,slice}] backend volume2@service-name
Note that the second ldm add-vdsdev command uses the -f option to force the second export of the back end. Use this option when using the same back-end path for both commands and when the virtual disk servers are located on the same service domain.
The disk-name can be different for ldom1 and ldom2.
# ldm add-vdisk [timeout=seconds] disk-name volume1@service-name ldom1 # ldm add-vdisk [timeout=seconds] disk-name volume2@service-name ldom2
For more information about virtual disk options, see Virtual Disk Back End Options.
# ldm set-vdsdev options=[{ro,slice,excl}] volume-name@service-name
For more information about virtual disk options, see Virtual Disk Back End Options.
# ldm set-vdisk timeout=seconds disk-name ldom
# ldm rm-vdisk disk-name ldom
# ldm rm-vdsdev volume-name@service-name