Procedure for replacing HBAs

Dynamic Link Manager (for Linux®) User Guide

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

To replace HBAs:

Before you can replace HBAs, the paths that pass through the HBAs to be replaced must be blocked. The following procedure is used for replacing HBAs.

  1. Check the WWN information of the HBAs to be replaced.

    Execute the following command:

    # /opt/hitachi/drivers/hba/hfcmgr -g
    Time:yyyy/mm/dd hh:mm:ss
                 ...
                 ...
    Model        : HFC0402-E
    Parts Number : 3HAC82101-A
    Firmware     : 260803
        WWPN:2400000047010278 Device:hfcldd0 [LinkUp]
        WWPN:240000004701027a Device:hfcldd1 [LinkUp]
    
    Model        : HFC0402-E 
    Parts Number : 3HAC82101-A
    Firmware     : 260803
        WWPN:2400000047010270 Device:hfcldd2 [LinkUp]
        WWPN:2400000047010272 Device:hfcldd3 [LinkUp]

    The number that follows a WWPN keyword is the port WWN information of an HBA.

    The following steps assume that the HBAs whose WWN information is underlined above are to be replaced.

  2. Execute the view operation of the dlnkmgr command (dlnkmgr view -path -hbaportwwn) to check the information about the paths that pass through the HBAs you want to replace.

    See the port WWN information of the HBAs you checked in step 1 and HBAPortWWN displayed as the execution result to check the host port number and the bus number displayed in PathName.

    In PathName, the leftmost number is the host port number. The number between the period to the right of the host port number and the next period is the bus number.

    Specify the host port number and the bus number when you place the path in the Offline(C) status in step 3.

    In this execution example, the host port number and the bus number corresponding to the port WWN information of the HBAs to be replaced (the underlined section) are shaded.

  3. Execute the offline operation of the dlnkmgr command (dlnkmgr offline -hba) to place in Offline(C) status all paths that pass through the HBA ports that you identified in step 2.

    For the -hba parameter, specify the host port number and the bus number by separating them with a period.

    The following shows an example of placing the path (host port number is 0000 and path number is 0000) in the Offline(C) status.

    # /opt/DynamicLinkManager/bin/dlnkmgr offline -hba 0000.0000

    After you have executed the offline operation, execute the view operation of the dlnkmgr command (dlnkmgr view -path -hbaportwwn) to confirm that all the paths passing through the HBAs being replaced are in Offline(C) status.

    # /opt/DynamicLinkManager/bin/dlnkmgr view -path -hbaportwwn
  4. Replace the HBAs.

  5. Execute the dlmcfgmgr utility (dlmcfgmgr -r) to change the HDLM device configuration.

    # dlmcfgmgr -r
  6. Execute the view operation of the dlnkmgr command (dlnkmgr view -path -hbaportwwn) to confirm that the new paths have been added.

    In the above figure, new paths that have been added are indicated by shading.

    Although the information about the old paths (underlined information) that were placed in Offline(C) status before the HBAs were replaced remains, this information will be deleted in step 8.

  7. Execute the dlmcfgmgr utility (dlmcfgmgr -v) to confirm that new SCSI devices have been added.

    New SCSI devices that have been added are indicated by shading in the above figure.

    Although the information about the old SCSI devices (the underlined information) before the HBAs were replaced remains, this information will be deleted when step 8 is performed.

  8. Execute the dlmcfgmgr utility (dlmcfgmgr -u) to delete the information about the old paths and SCSI devices.

    In the -u parameter, specify an HDevName device for which old SCSI device information is displayed in step 7. Note that you need to execute the utility for each HDevName device that contains old SCSI device information.

    The following shows an example of the command you execute if the HDevName value is /dev/sddlmaa:

    # dlmcfgmgr -u /dev/sddlmaa
  9. Execute the view operation of the dlnkmgr command (dlnkmgr view -path -hbaportwwn) to confirm that all the old information for the paths that were placed in Offline(C) status has been deleted.

    # /opt/DynamicLinkManager/bin/dlnkmgr view -path -hbaportwwn
  10. Execute the dlmcfgmgr utility (dlmcfgmgr -v) to confirm that all the old SCSI device information has been deleted.

    # dlmcfgmgr -v

    HBA replacement has been completed.

    If you have restarted the host after HBA replacement, update the path information as described in Updating the path information after the host is restarted.