|
|
|
|
|
vxddladm - Device Discovery Layer subsystem administration
/etc/vx/bin/vxddladm keyword [attribute[=value] ...]
vxddladm [-a | -f | -n] addforeign
{dir=pathname | path=pathname}
vxddladm [-a | -f | -n] addforeign
{dirname=pathname | pathname=pathname}
vxddladm [-a | -f | -n] addforeign
blockdir=pathname chardir=pathname
vxddladm [-a | -f | -n] addforeign
blockpath=pathname charpath=pathname
vxddladm addjbod vid=vendor-id [pid=product-id]
[opcode=scsi_opcode] [pagecode=page_code]
[offset=page_offset] [length=sno_length]
[policy={aa|ap}]
vxddladm enablescsi3 [policy={aa|ap}]
vxddladm excludearray libname=libname
vxddladm excludearray vid=vendor-id pid=product-id
vxddladm excludearray vid=vendor-id
vxddladm excludearray pid=product-id
vxddladm includearray libname=libname
vxddladm includearray vid=vendor-id pid=product-id
vxddladm includearray vid=vendor-id
vxddladm includearray pid=product-id
vxddladm listjbod [vid=vendor-id [pid=product-id]]
vxddladm listsupport [all | libname=libname]
vxddladm listversion [all | libname=libname]
vxddladm rmforeign {dir=pathname | path=pathname}
vxddladm rmforeign {dirname=pathname | pathname=pathname}
vxddladm rmforeign blockdir=pathname chardir=pathname
vxddladm rmforeign blockpath=pathname charpath=pathname
vxddladm rmjbod vid=vendor-id [pid=product-id]
vxddladm set namingscheme={ebn|gdn|osn} [persistence={yes|no}]
The vxddladm utility is an administrative interface to the dynamic array support facility of the Device Discovery Layer (DDL). This utility lists the types of arrays supported, adds or removes array support from DDL, and allows dynamic addition of JBOD support for disks from different vendors. It additionally lists supported JBODs, and allows addition or removal of JBOD support. The vxddladm utility is also used to customize the set of array libraries that can participate in device discovery.
DDL cannot discover some devices that are controlled by third-party drivers (for example, EMC PowerPath and RAM disks). Additionally, it may be preferable to use the multipathing capability that is provided by the third-party drivers for some arrays rather than use the Veritas Dynamic Multipathing (DMP) feature. Such foreign devices can be made available as simple disks to VxVM by using the vxddladm addforeign command. This command also has the effect of bypassing DMP for the specified devices.
If a foreign device has alias devices in the OS-maintained device tree, DDL/DMP creates additional disk access records that point to the same physical device. As such additional records are usually not required, you can specify the -a option to prevent them from being created.
After adding or removing foreign device entries, use either the vxdisk scandisks command or the vxdctl enable command to discover the foreign devices as simple disks. These disks then behave in the same way as autoconfigured disks.
Adds an entry to the list of foreign devices that are not autoconfigurable by VxVM.
See the ATTRIBUTES section for a description of the attributes that can be used with addforeign: blockdir, blockpath, chardir, charpath, dir, dirname, path and pathname. All directory and device arguments to these attributes must be specified as absolute pathnames. Device paths may include the * wildcard.
One of the following options may also be specified to define how alternate device entries that are discovered by VxVM are to be treated:
Suppresses any entries for matching devices in the OS-maintained device tree that are found by the VxVM autodiscovery mechanism. This is the default action if no option is specified to addforeign.
Retains any entries for matching devices found by the VxVM autodiscovery mechanism, and suppresses any foreign device entries that are defined.
Does not suppress any entries. Duplicate entries for foreign devices are allowed.
Adds disks having the specified VID and PID in the JBOD category (DISKS). The policy option may be specified to handle JBOD arrays in either active/active (aa) or active/passive (ap) mode. By default, JBOD disks are handled as active/active arrays.
Disables the discovery of SCSI3 disks in the JBOD category.
Initiates the method to discover SCSI3-conformant disks. Such disks, if found, are categorized in the JBOD category. The method comes into effect when the discovery operation is subsequently invoked.
The policy option may be specified to discover devices in active/active (aa) or active/passive (ap) mode. By default, devices are discovered in active/active mode.
Excludes the specified array libraries from participating in device discovery. This does not remove the specified libraries from the system. As a result, vxddladm listsupport displays the corresponding disk arrays.
Includes the array libraries previously excluded by excludearray. These can be used for device discovery operations.
Lists information about the disk array libraries excluded from device discovery functionality.
Lists information about foreign devices that have been defined to VxVM.
Lists information about the types of disks supported in JBOD category (DISKS).
Lists summary information about supported disk arrays. The libname attribute can be used to display a detailed list of attributes for a specified library.
Lists the version numbers of array support libraries and the minimum VxVM release that is required for each library. The libname attribute can be used to request that the information is to be displayed only for the specified library.
Displays the mode for SCSI3 disk discovery. By default, devices are discovered in active/active mode.
Removes a matching entry from the list of foreign directories and devices. See the ATTRIBUTES section for a description of the attributes that can be used with rmforeign: blockdir, blockpath, chardir, charpath, dir, dirname, path and pathname.
Removes disk with the specified VID and PID from the JBOD category (DISKS). These disks are categorized as OTHER_DISKS and are not multipathed.
set namingscheme={ebn|gdn|osn} [persistence={yes|no}]
Bases the name of a device on the enclosure name (ebn), on the device name that is used by the operating system (osn), or on Global Device Naming (GDN) (gdn). The change is immediate, and does not require vxconfigd to be restarted.
The gdn setting enables the coordination of device and enclosure names across systems that are managed by a common Storage Foundation Management Server (SFMS) in a Storage Foundation Volume Server environment. If this setting is enabled on SFMS-managed systems, VxVM uses the same name for each device on all the systems. GDN is also used in the SFMS interface.
Note
GDN is intended for use only with the Storage Foundation Volume Server software.
The optional persistence argument allows you to select whether the names of disk devices that are displayed by VxVM remain unchanged after disk hardware has been reconfigured and the system rebooted. By default, enclosure-based naming and operating system-based naming are persistent (yes). GDN is always persistent, and cannot be made non-persistent.
Bases the name of a device on the enclosure name (ebn), on the device name that is used by the operating system (osn), or on Global Device Naming (GDN) (gdn). The change is immediate, and does not require vxconfigd to be restarted.
Starts or stops the event source daemon. This daemon passes disk-related events to DDL. For example, if a disk is added, removed, or changed, DDL invokes the device discovery actions that are related to that disk event.
The attribute all selects all objects for an operation.
Other attributes are specified using the format attribute=value.
Absolute pathname of a directory that contains block device entries for foreign devices.
Absolute pathname of the block device for a foreign device.
Absolute pathname of a directory that contains character device entries for foreign devices.
Absolute pathname of of a character device for a foreign device.
Absolute pathname of a directory that contains character and block device entries for foreign devices.
Size of the field containing unique disk serial number.
Name of the array library on which the operation is to be performed.
Absolute pathname of a single character or block device for a foreign device.
Sets the policy of the specified device to aa (active/active) or ap (active/passive).
If you specify values for vid or pid to the excludearray or includearray operations, this excludes or includes all arrays that are supported by the corresponding array library.
The value for vid and pid should be taken from the output of the vxddladm listsupport command. These values may be different from the actual vid and pid values of the disks within an array.
See the vxdiskadm(1M) manual page for information on using the vxdiskadm command to suppress or unsuppress individual devices from the view of VxVM, or to disable or enable multipathing for these devices.
Used to store records for foreign devices.
vxconfigd(1M), vxdctl(1M), vxdisk(1M), vxdiskadm(1M), vxdmpadm(1M)