Description

This article outlines the legacy process for customizing DMPNODEs, which has since been replaced with the enhanced vxdmpadm CLI:

To specify a customized name for an enclosure, use the following syntax:

# vxdmpadm setattr enclosure enc_name name=custom_name

This is useful for storage arrays like Huawei or xtremio, which do not support AVID
https://docs.infoscale.com/support/en_US/article.100050936

Legacy content:

The Veritas Volume Manager (VxVM) vxgetdmpnames CLI command enables the user to customize the Veritas disk access (da) name.

This document attempts to explain the steps required to customize the da name for the VxVM encapsulated bootdisk to make identification easier.


Steps
 

1.] Redirect the output from the "vxgetdmpnames dmpnodename=" to a file.

# vxdisk list

DEVICE       TYPE            DISK         GROUP        STATUS
disk_0     auto:sliced     rootdisk     rootdg       online                     <<<< da-name to be customized/renamed
emc0_02c3    auto:cdsdisk    -            -            online
emc0_02c4    auto:cdsdisk    -            -            online
emc0_02c5    auto:cdsdisk    -            -            online
emc0_02c6    auto:cdsdisk    -            -            online
emc0_027a    auto:cdsdisk    -            -            online

In this instance da-name "disk_0" relates to the VxVM encapsulated bootdisk.

# vxgetdmpnames dmpnodename=disk_0 > /tmp/disks

2.] Edit the file created above and change the "name=" content to reflect the new da-name.

# more /tmp/disks

enclosure vendor=SEAGATE product=ST373307LSUN72G serial=DISKS name=disk
        dmpnode serial=30353033423959314D320000 name=disk_0


The name (name=disk_0) details are changed within the file to reflect the new da-name of "bootdisk", i.e. "name=bootdisk":

# cat /tmp/disks
enclosure vendor=SEAGATE product=ST373307LSUN72G serial=DISKS name=disk
        dmpnode serial=30353033423959314D320000 name=bootdisk           <<<<<<

3.] Using the below "vxddladm" command to import the amended file contents:

4.] Validate that VxVM is now reporting the customized da-name, ie bootdisk in the first column of the "vxdisk list" CLI output:

# vxddladm assign names file=/tmp/disks

# vxdisk list

DEVICE       TYPE            DISK         GROUP        STATUS
bootdisk     auto:sliced     rootdisk     rootdg       online                     <<< the da-name was changed from "disk_0" to "bootdisk"
emc0_02c3    auto:cdsdisk    -            -            online
emc0_02c4    auto:cdsdisk    -            -            online
emc0_02c5    auto:cdsdisk    -            -            online
emc0_02c6    auto:cdsdisk    -            -            online
emc0_027a    auto:cdsdisk    -            -            online


Additional information:

If the DMP persistence option is turned on, as reported by the "vxddladm get namingscheme" CLI command, the /etc/vx/disk.info will contain/retain the original da-name (i.e. disk_0 in this instance).

# vxddladm get namingscheme

NAMING_SCHEME       PERSISTENCE    LOWERCASE      USE_AVID
============================================================
Enclosure Based            Yes                         Yes                          Yes


Sample output

# grep disk_0 /etc/vx/disk.info
SEAGATE%5FST373307LSUN72G%5FDISKS%5F30353033423959314D320000 c2t1d0 0x4800000 0x2 disk_0 Disk DISKS

The /etc/vx/dmpnames.info file will hold a persistent list of the customized VxVM da-names:


Sample output:

# more /etc/vx/dmpnames.info
SEAGATE%5FST373307LSUN72G%5FDISKS%5F30353033423959314D320000 bootdisk

Note: The CLI command "vxddladm -c assign names" will not impact the customized VxVM da-names. However any customized VxVM/DMP enclosure names will be lost when running this command.
 

How to customize the name of a Veritas Volume Manager (VxVM) encapsulated bootdisk or any disk using vxgetdmpnames