Changing an HDLM device name

Dynamic Link Manager (for Linux®) User Guide

Version
9.0.x
Audience
anonymous
Part Number
MK-92DLM113-64
ft:lastEdition
2025-11-06

This subsection describes how to change HDLM device names.

An HDLM device name is assigned depending on the HDLM specifications when dlmcfgmgr is executed the first time after the OS recognizes a new LU. You can execute the HDLM device name replacement utility (dlmchname) to change the HDLM device name. For details about the dlmchname utility, see Utility reference.

  1. Create a device name replacement definition file based on the current HDLM device configuration information. When the dlmchname utility is executed with the -o parameter, a device name replacement definition file (/etc/opt/DynamicLinkManager/dlmchname.conf) is created based on the current HDLM device configuration information.

    # /opt/DynamicLinkManager/bin/dlmchname -o
  2. Check the current HDLM device configuration information, and then identify the HDLM device name to be changed.

    Execute the view operation of the HDLM command. In the execution results, check the correspondence between the LUs and HDLM devices, and then identify the HDLM device name to be changed.

    An execution example is as follows:

    # /opt/DynamicLinkManager/bin/dlnkmgr view -lu
    Product       : VSP_Ex00
    SerialNumber  : 416032
    LUs           : 3
    
    iLU    HDevName Device    PathID Status
    000090 sddlmab  /dev/sda  000004 Online
                    /dev/sdd  000005 Online
                    /dev/sdj  000008 Online
                    /dev/sdg  000009 Online
    000091 sddlmac  /dev/sdb  000006 Online
                    /dev/sde  000007 Online
                    /dev/sdh  000010 Online
                    /dev/sdk  000011 Online
    000092 sddlmaa  /dev/sdc  000000 Online
                    /dev/sdf  000001 Online
                    /dev/sdi  000002 Online
                    /dev/sdl  000003 Online
    KAPL01001-I The HDLM command completed normally. Operation name = view(-vstv), completion time = yyyy/mm/dd hh:mm:ss

    Note that LUs that are not managed by HDLM are not output. Therefore, configure the setting so that LUs are managed by HDLM before the check. If you can identify the correspondence between LUs and HDLM devices, edit the device name replacement definition file in step 3.

  3. Edit the device name replacement definition file.

    Change HDLM device names specified in the device name replacement definition file (/etc/opt/DynamicLinkManager/dlmchname.conf) by using an editor such as vi.

    In the following example, the name of the HDLM device whose the serial number is 85011299 and whose iLU is 0090 was identified as sddlmab in step 2 and is then changed to sddlmad.

    (Before change)

    # /bin/cat /etc/opt/DynamicLinkManager/dlmchname.conf
    3585011299 0090 sddlmab
    3585011299 0091 sddlmac
    3585011299 0092 sddlmaa

    (After change)

    # /bin/cat /etc/opt/DynamicLinkManager/dlmchname.conf
    3585011299 0090 sddlmad
    3585011299 0091 sddlmac
    3585011299 0092 sddlmaa

    Lines for which the HDLM device name is not changed can be deleted from the dlmchname.conf file, without causing any problems.

    To change the name of an HDLM device used as a boot disk, go to step 5.

  4. Stop access to the HDLM device whose name is to be changed.

    To stop access to the HDLM device, perform the following operations:

    • Unmount the HDLM device if the HDLM device is mounted.

    • Deactivate the volume group if the HDLM device is used in an LVM.

    • Stop applications that are using the HDLM device.

    To prevent I/Os from causing failures during HDLM device name replacement, execute the dlmcfgmgr utility (dlmcfgmgr -o) so that the HDLM device is not managed.

    If you execute the dlmcfgmgr utility (dlmcfgmgr -o), execute the dlmcfgmgr utility (dlmcfgmgr -i) so that the HDLM device is managed again after the dlmchname utility.

  5. Execute the dlmchname utility.

    To change the name of an HDLM device that is a member of an LVM volume group, execute the dlmchname utility and then the vgscan command.

    To change the name of an HDLM device that is not used as a boot disk

    Execute the dlmchname utility as follows to change the HDLM device name.

    # /opt/DynamicLinkManager/bin/dlmchname
    To change the name of an HDLM device that is used as a boot disk

    Execute the dlmchname utility with the -f parameter.

    # /opt/DynamicLinkManager/bin/dlmchname -f

    To change the name of an HDLM device that is not used as a boot disk, go to step 8.

  6. Edit the setting files in which the HDLM device name is specified.

    When changing the name of an HDLM device that is used as a boot disk, check and edit the /etc/fstab file.

  7. Reboot the host.

    When changing the name of an HDLM device that is used as a boot disk, you must reboot the host.

    # shutdown -r now
  8. Check that the HDLM device name has been changed in the current HDLM device configuration information.

    Execute the view operation of the HDLM command. In the execution results, check that the HDLM device name has been changed.

    An execution example is as follows:

    # /opt/DynamicLinkManager/bin/dlnkmgr view -lu
    Product       : VSP_Ex00
    SerialNumber  : 416032
    LUs           : 3
    
    iLU    HDevName Device    PathID Status
    000090 sddlmad  /dev/sda  000004 Online
                    /dev/sdd  000005 Online
                    /dev/sdj  000008 Online
                    /dev/sdg  000009 Online
    000091 sddlmac  /dev/sdb  000006 Online
                    /dev/sde  000007 Online
                    /dev/sdh  000010 Online
                    /dev/sdk  000011 Online
    000092 sddlmaa  /dev/sdc  000000 Online
                    /dev/sdf  000001 Online
                    /dev/sdi  000002 Online
                    /dev/sdl  000003 Online
    KAPL01001-I The HDLM command completed normally. Operation name = view(-vstv), completion time = yyyy/mm/dd hh:mm:ss
    

    Note that LUs that are not managed by HDLM are not output. Therefore, configure the setting so that the LUs are managed by HDLM before the check.

  9. Access the HDLM device whose name was changed, and then check that the HDLM device can be used.

    Check that applications that access the HDLM device whose name was changed are running normally.