vxddladm(1M) vxddladm(1M)
NAME
vxddladm - Device Discovery Layer subsystem administration
SYNOPSIS
/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 disablescsi3
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 excludearray all
vxddladm get namingscheme
vxddladm gettune {all | tunable}
vxddladm includearray libname=libname
vxddladm includearray vid=vendor-id pid=product-id
vxddladm includearray vid=vendor-id
vxddladm includearray pid=product-id
vxddladm includearray all
vxddladm listexclude [all]
vxddladm listforeign
vxddladm listjbod [vid=vendor-id [pid=product-id]]
vxddladm listsupport [all | libname=libname]
vxddladm listversion [all | libname=libname]
vxddladm modescsi3
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|osn} [persistence={yes|no}]
[mode={default|legacy|new}]
vxddladm settune tunable=value
vxddladm start eventsource
vxddladm stop eventsource
DESCRIPTION
The vxddladm utility is an administrative interface to the dynamic array support facility of the Device Discovery Layer (DDL). This util-
ity 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 Veri-
tas Dynamic Multipathing (DMP) feature. Such foreign devices can be made available as simple disks to VxVM by using the vxddladm addfor-
eign 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 cre-
ated.
After adding or removing foreign device entries, use either the vxdisk scandisks command or the vxdctl enable command to discover the for-
eign devices as simple disks. These disks then behave in the same way as autoconfigured disks.
KEYWORDS
addforeign
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:
-a Suppresses any entries for matching devices in the OS-maintained device tree that are found by the VxVM autodiscovery mecha-
nism. This is the default action if no option is specified to addforeign.
-f Retains any entries for matching devices found by the VxVM autodiscovery mechanism, and suppresses any foreign device
entries that are defined.
-n Does not suppress any entries. Duplicate entries for foreign devices are allowed.
addjbod 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.
disablescsi3
Disables the discovery of SCSI3 disks in the JBOD category.
enablescsi3
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.
excludearray
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.
get namingscheme
Returns the current setting of the disk device naming scheme.
gettune Returns the value of a specified DDL tunable parameter. If all is specified, a list of all the DDL tunables and their values is
displayed.
includearray
Includes the array libraries previously excluded by excludearray. These can be used for device discovery operations.
listexclude
Lists information about the disk array libraries excluded from device discovery functionality.
listforeign
Lists information about foreign devices that have been defined to VxVM.
listjbod Lists information about the types of disks supported in JBOD category (DISKS).
listsupport
Lists summary information about supported disk arrays. The libname attribute can be used to display a detailed list of
attributes for a specified library.
listversion
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.
modescsi3 Displays the mode for SCSI3 disk discovery. By default, devices are discovered in active/active mode.
rmforeign 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.
rmjbod 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|osn} [persistence={yes|no}]
Bases the name of a device on the enclosure name (ebn), or on the device name that is used by the operating system (osn). The
change is immediate, and does not require vxconfigd to be restarted.
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).
VxVM commands display device names according the current naming scheme. If operating system-based naming is selected, all VxVM
commands that list DMP node devices will display device names according to the mode that is specified:
default The same format is used as in the input to the command (if this can be determined). Otherwise, legacy names are used.
This is the default mode.
legacy Only legacy names (in c#t#d# format) are displayed.
new Only new (agile) names (in disk## format) are displayed.
settune Sets the value of the specified DDL tunable parameter. This value takes precedence over any value that is set using the method
provided by the operating system. The changed value is persistent across reboots of the system.
The following tunable parameter may be changed for DDL:
monitor_fabric
Controls whether the Event Source daemon (vxesd) uses the Storage Networking Industry Association (SNIA) HBA API. This
API allows DDL to improve the performance of failover by collecting information about the SAN topology and by monitor-
ing fabric events.
If set to on, DDL uses the SNIA HBA API. (Note that the vendor-provided ASL must also support the use of the SNIA HBA
API.)
If set to off, the SNIA HBA API is not used.
The default setting is off for releases prior to 5.0 that have been patched to support this DDL feature. The default
setting is on for 5.0 and later releases.
start eventsource
stop eventsource
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.
ATTRIBUTES
The attribute all selects all objects for an operation.
Other attributes are specified using the format attribute=value.
blockdir Absolute pathname of a directory that contains block device entries for foreign devices.
blockpath Absolute pathname of the block device for a foreign device.
chardir Absolute pathname of a directory that contains character device entries for foreign devices.
charpath Absolute pathname of of a character device for a foreign device.
dir Absolute pathname of a directory that contains character and block device entries for foreign devices.
dirname Equivalent to dir.
length Size of the field containing unique disk serial number.
libname Name of the array library on which the operation is to be performed.
offset Offset on the page code.
opcode SCSI opcode.
pagecode Page code for SCSI command.
path Absolute pathname of a single character or block device for a foreign device.
pathname Equivalent to path.
pid Product ID of the disk array.
policy Sets the policy of the specified device to aa (active/active) or ap (active/passive).
vid Vendor ID of the disk array.
NOTES
If you specify values for vid or pid to the excludearray or includearray operations, this excludes or includes all arrays that are sup-
ported 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.
FILES
/etc/vx/darecs Used to store records for foreign devices.
SEE ALSO
vxconfigd(1M), vxdctl(1M), vxdisk(1M), vxdiskadm(1M), vxdmpadm(1M)
VxVM 5.0.31.1 24 Mar 2008 vxddladm(1M)
