Adding a new LU

To add a new LU (HDLM device) to the host on which the HDLM is installed:

1. Use the management program of the storage system to allocate an LU, which is not yet allocated to the relevant host, to a port of the storage system that has a path to the relevant host and configure the path.

   For more information on configuring the path, see the manual provided with the storage system.

2. When you want to add an LU without restarting the host, perform step 3 and step 4. When you want to add an LU while restarting the host, go to step 5.

3. Create a SCSI device for each path configured in step 1.

   Since the host has not been restarted, a SCSI device for the LU that was added in step 1 was not created. Execute the command for adding the device shown in the following table to manually create a SCSI device.

   Table. Adding or deleting a SCSI device

   Operation	Command
   Adding a device (for FC-SAN environments)	When using any of the following OS and HBA driver combinations: - Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Red Hat Enterprise Linux 9, Oracle Linux 7, Oracle Linux 8#1, Oracle Linux 9, or Oracle Unbreakable Enterprise Kernel 8 and a QLogic HBA driver - SUSE LINUX Enterprise Server and a QLogic HBA driver - Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Red Hat Enterprise Linux 9, Oracle Linux 7, Oracle Linux 8, Oracle Linux 9, or Oracle Unbreakable Enterprise Kernel 8 and an Emulex HBA driver - SUSE LINUX Enterprise Server and an Emulex HBA driver Execute the following command: # echo "- - -" > /sys/class/scsi_host/hostn/scan# # If LUs for which I/O processing is being performed exist, execute the echo command for each device as follows: # echo "b c d" > /sys/class/scsi_host/hostn/scan Execute the following command to check whether the OS has recognized any devices: # cat /proc/scsi/scsi If the OS has not recognized any devices, stop the I/O processing, and then execute the following commands in the order shown: # echo "1" > /sys/class/fc_host/hostn/issue_lip # echo "- - -" > /sys/class/scsi_host/hostn/scan If you are using Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Red Hat Enterprise Linux 9, Oracle Linux 7, Oracle Linux 8, or SUSE LINUX Enterprise Server, the devices might be automatically recognized by the OS hot plug function. If the devices are recognized, the above procedure is not necessary.
   Adding a device (for IP-SAN environments)	For a device added to the target for which no session is established with the iSCSI initiator Execute the following command to make the OS recognize the target: # iscsiadm -m discovery -t sendtargets -p IP-address-of-the-target Then, log in to the target to establish a session. # iscsiadm -m node -T target-name -p IP-address-of-the-target:port-number-of-the-target --login For a device added to the target for which a session is established with the iSCSI initiator Execute the following command: # iscsiadm -m session -R
   Deleting a device (for FC-SAN environments)	# dlmcfgmgr -o logical-device-file-name-of-the-relevant-HDLM-device # echo "scsi remove-single-device a b c d" > /proc/scsi/scsi # dlmcfgmgr -i logical-device-file-name-of-the-relevant-HDLM-device If you are using SUSE LINUX Enterprise Server 12, SUSE LINUX Enterprise Server 15, Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Red Hat Enterprise Linux 9, Oracle Linux 7, Oracle Linux 8, Oracle Linux 9, or Oracle Unbreakable Enterprise Kernel, the above procedure is not necessary for deleting a path that is in disconnected status.
   Deleting a device (for IP-SAN environments)	# echo "scsi remove-single-device a b c d" > /proc/scsi/scsi

   Legend:

   a: Host ID (host port number)

   b: Channel number (bus number)

   c: Target ID

   d: Lun (host LU number)

   n: host port number

   driver-name: qlaxxxx (driver name in use)

   #1

   Oracle Linux 8 Update 1 does not support QLogic HBA drivers.

4. Execute the HDLM-configuration definition utility (dlmcfgmgr -r).

   Based on the SCSI device created in step 3, an HDLM device for the path configured in step 1 is added.

   The following is an example of executing the dlmcfgmgr utility:

   # /sbin/dlmcfgmgr -r

5. Restart the host on which the HDLM is installed.

   If you performed step 3 and step 4, the host does not have to be restarted. Go to step 6.

   While restarting, the HDLM device mapped with the path configured in the above step 1 is added automatically.

6. Refer to /var/opt/DynamicLinkManager/log/dlmcfgmgr1.log or execute the dlmcfgmgr utility (dlmcfgmgr -v) to check if an LU was created with a new HDLM device name.

   The following is an example of executing the dlmcfgmgr utility:

   # /sbin/dlmcfgmgr -v