Go to main content

Oracle® VM Server for SPARC 3.6 Administration Guide

Exit Print View

Updated: September 2019
 
 

Managing the Physical Devices in a Virtual Storage Area Network

You can create a virtual SAN instance that represents all of or a subset of the physical devices that are reachable by an initiator port. By default, a virtual SAN instance represents the set of all physical devices that are reachable by the specified initiator port.

    You can use the ldm add-vsan or ldm set-vsan command to specify the mask property, which controls how vSAN instances are created. You can create vSAN instances in the following ways:

  • mask=off. Create a vSAN instance that represents the set of all physical devices that are reachable by the specified initiator port. This method is used by default to create vSAN instances.

  • mask=on. Create a vSAN instance that represents a subset of the physical devices that are reachable by the specified initiator port.

When you use the ldm set-vsan command to specify the value of the mask property, the virtual SAN automatically notifies the virtual SCSI HBA instance that you changed the property value. If you change the mask property value to off, all devices that are reachable by the virtual SAN's initiator port become members of the virtual SAN. If you change the mask property value to on, the content of the virtual SAN's mask property value is reset to remove all physical device identification data. To populate the mask property with identification data, run the ldm add-vsan-dev command for each physical device you want to add to the virtual SAN.


Note - When you issue the ldm set-vsan command, any running I/O commands are terminated gracefully. Subsequent I/O requests to a previously known vSAN member return an error stating that the device is no longer reachable.

When a virtual SAN instance has its mask property set to on, use the ldm add-vsan-dev command to add one or more physical devices with associated WWNs to the virtual SAN instance. Use the ldm remove-vsan-dev command to remove a physical device with the specified WWN from the virtual SAN. Run the ldm remove-vsan-dev command for each physical device that you want to remove from the virtual SAN instance.

You can use the ldm list-vsan command to obtain information about a virtual SAN. The ldm list-vsan command lists the members of the specified virtual SAN. When mask=on, the output shows the WWN of each virtual SAN member. When mask=off, the output states that the mask property value is off.

Obtaining Worldwide Numbers

Use the ldm list-hba -u command to view a device's worldwide number (WWN) and all the paths that reference the device's WWN.

The following example shows information about the physical devices in the primary domain. The example output shows both the paths that reference the naa.600c0ff0000000000089d513107ecb00 WWN of the physical device.

primary# ldm list-hba -u primary
DOMAIN
primary
 
naa.600c0ff0000000000089d513107ecb00
    MB/RISER1/PCIE4/HBA0/PORT0,0/w216000c0ff8089d5,0
    MB/RISER1/PCIE4/HBA0,1/PORT0,0/w216000c0ff8089d5,0
...

By including the –l option, the ldm list-hba -u -l command shows per-path and per-device metadata that you can use to identify a specific physical device within your system's topology.

primary# ldm list-hba -u -l primary
DOMAIN
primary
 
naa.600c0ff0000000000089d513107ecb00
    MB/RISER1/PCIE4/HBA0/PORT0,0/w216000c0ff8089d5,0
    [/pci@0/pci@0/pci@8/pci@0/pci@2/SUNW,qlc@0/fp@0,0/ssd@w216000c0ff8089d5,0]          (c0t600C0FF0000000000089D513107ECB00d0s0)
    MB/RISER1/PCIE4/HBA0,1/PORT0,0/w216000c0ff8089d5,0
    [/pci@0/pci@0/pci@8/pci@0/pci@2/SUNW,qlc@0,1/fp@0,0/ssd@w216000c0ff8089d5,0]        (c0t600C0FF0000000000089D513107ECB00d0s0)
...

By using the metadata in the previous example output, you can add the device associated with this WWN to the my_vsan virtual SAN.

In the following example, first create the my_vsan virtual SAN on the my_domain domain. Then, add the physical device associated with the naa.600c0ff0000000000089d513107ecb00 WWN to the my_vsan virtual SAN:

primary# ldm add-vsan mask=on $iport_path my_vsan my_domain
primary# ldm add-vsan-dev my_vsan naa.600c0ff0000000000089d513107ecb00