Unattended installation of HDLM

Dynamic Link Manager (for Linux®) User Guide
Version
9.0.x
Audience
anonymous
Part Number
MK-92DLM113-64
ft:lastEdition
2025-11-06

When you perform a new installation, re-installation, or upgrade installation of HDLM, you can choose an unattended installation. An unattended installation enables a user to install HDLM without entering information.

The procedure for performing an unattended installation of HDLM is described below. Note that preparations before installing HDLM are required. For details about the preparations before performing a new installation of HDLM, see Preparations for a new installation of HDLM. For details about the preparations before performing a re-installation or an upgrade installation of HDLM, see Preparations for an upgrade installation or re-installation of HDLM.

  1. Log on to Linux as the root user.

  2. If the environment is using LVM, disable the LVM cache. For details, see Notes on using LVM2.

  3. Make sure that no HDLM devices are being used.

    In the case of a re-installation or an upgrade installation, run the following command and make sure either that 0 is displayed for Used for sddlmfdrv or that sddlmfdrv is not displayed.

    # /sbin/lsmod
Module                  Size  Used by
      :
      :
sddlmfdrv              254092  0

    If sddlmfdrv is displayed and a value other than 0 is displayed for Used, perform both of the following procedures so that the HDLM devices can no longer be used.

  4. In the following cases, prepare the license key or the license key file:

    • If you are installing HDLM for the first time

    • If you are upgrading or re-installing HDLM after the licensing term has expired

    If the directory that contains the license key or the license key file is specified in the installation information settings file, you can use any storage directory name and file name. The license key file or license key is not deleted after the installation.

    For an unattended installation, you can specify any directory to store the license key file. For details, see Editing an installation-information settings file.

  5. Insert the DVD-ROM and mount it.

    If the DVD-ROM was not automatically mounted, execute the mount command to mount the DVD-ROM to the fixed mount point.

    The following shows an example of command execution when the mount point is /media/cdrom:

    # mount /dev/cdrom /media/cdrom

    The following table lists the fixed mount points for each distribution.

    Table. Mount point for each distribution

    Distribution

    Mount point

    Red Hat Enterprise Linux 7, 8, 9

    /media/cdrom

    SUSE LINUX Enterprise Server

    /media/cdrom

    If the DVD-ROM is automatically mounted:

    /media/media-volume-id #

    Note 1

    HDLM cannot be installed if the DVD-ROM is mounted to a mount point other than the above.

    Note 2

    To copy the DVD-ROM to a directory, and then install HDLM from that directory, copy the DVD-ROM to a directory with the same name as the mount point noted above. If the file permissions or the directory structure differs, HDLM cannot be installed.

    #

    This refers to the volume name for the CD-ROM or other media, formatted for ISO-9660 file systems. Use the volname command to check media-volume-id.

    The following shows an execution example for when media-volume-id is VOL01234.

    # volname /dev/cdrom
VOL01234
#

  6. Check the version of HDLM.

    Execute installux.sh or the HDLM installation utility (installhdlm) stored on the HDLM DVD-ROM to check the version of HDLM that will be installed.

    The following example shows how to execute the command when the mount point for the DVD-ROM is /media/cdrom:

    • When executing installux.sh

      # /media/cdrom/installux.sh -v

    • When executing the installhdlm utility

      # /media/cdrom/HDLM_Linux/installhdlm -v

    A command execution example is described below. x.x.x-xx is the version of HDLM.

    KAPL09177-I HDLM version: x.x.x-xx

  7. Create an installation information settings file.

    Edit the installation information settings file based on your desired settings. Specify any settings that are not specified in this file after installing HDLM, as necessary.

    To use the sample file, copy it from the DVD-ROM to a directory on the hard disk. Note that the sample file name can be changed to any name.

    The following shows an installation execution example for when the DVD-ROM mount point is /media/cdrom.

    # cp -p /media/cdrom/HDLM_Linux/config/sample_installhdlm.conf /any-directory/any-file-name

    For details about how to edit the installation information settings file, which is used by the installhdlm utility, see Editing an installation-information settings file.

    Note

    If the QLogic 8400 Series (FCoE) is used to connect the host and the storage system, do not specify to restart the host.

  8. Perform the installation.

    Execute installux.sh or the installhdlm utility stored on the HDLM DVD-ROM to start installation.

    The following shows an installation execution example for when the DVD-ROM mount point is /media/cdrom.

    • When executing installux.sh

      # /media/cdrom/installux.sh -f /any-directory/installation-information-settings-file

    • When executing the installhdlm utility

      # /media/cdrom/HDLM_Linux/installhdlm -f /any-directory/installation-information-settings-file

    Note that, if you edited the installation information settings file in step 7 so that the host is restarted, the host is automatically restarted.

  9. Make sure that HDLM is installed.

    Execute the following command to display detailed information about the installed package.

    # rpm -qi HDLM
Name        : HDLM
Version     : x.x.x.x.xxx
Release     : xx  
     :

    If HDLM Version is x.x.x.x.xxx, the installed version of HDLM is correct. x.x.x.x.xxx indicates the HDLM version that was installed.

  10. If IP-SAN is used for the connection between the host and the storage system, change iscsi_boot=n, written in the /etc/opt/DynamicLinkManager/hdlm.conf file, to iscsi_boot=y.

    In addition, if the QLogic 8400 Series (FCoE) is used to connect the host and the storage system, in the /etc/opt/DynamicLinkManager/hdlm.conf file, change fcoe_boot=n to fcoe_boot=y.

  11. If you want to set the HDLM driver options, run the dlmsetopt utility.

    For details on this utility, see dlmsetopt utility for setting HDLM driver options.

  12. Add /opt/DynamicLinkManager/bin in the environment variable PATH in the environment setup file for the shell used by the root user.

    Add the following code to the PATH environment variable in the environment settings file for the root user. This makes executing the HDLM commands and HDLM utilities easier.

    When the BourneAgain shell or Korn shell is used:

    PATH=$PATH:/opt/DynamicLinkManager/bin ; export PATH

    When the C shell is used:

    set path= ( $path /opt/DynamicLinkManager/bin )

    If the PATH environment variable is not set, specify an absolute path to execute commands and utilities.

  13. If you have edited the /etc/fstab file as described in Operations required for devices to be managed by HDLM, add the line show below to change the setting from a SCSI device specification to an HDLM device specification.

    The Linux functionality that adds LABEL= or UUID= to a SCSI device is not supported in HDLM. Do not use this functionality.

    An example of how to edit the /etc/fstab file is shown in the following figure:

    Add the shaded line shown in the above figure.

  14. Specify the settings required for using the volume management software.

    If you performed the operations described in Deactivating the volume group, perform the following steps to activate the volume group:

    If you did not edit the installation information settings file in step 7 so that the host is restarted:

    Go to step 17.

    If you edited the installation information settings file in step 7 so that the host is restarted:

    Go to step 18.

    If you do not use the volume management software, go to step 20.

    For details on other settings for the volume management software, see Settings for LVM2.

  15. Activate the volume group.

    In the following example, the logical volume subject to the move belongs to the vg01 volume group:

    # vgchange -ay vg01
vgchange -- volume group "vg01" successfully activated

  16. Mount the logical volume that was moved.

    In the following example, the logical volume is /dev/vg01/lvol1 and the command mounts the volume on /mnt/lvol1:

    # mount /dev/vg01/lvol1 /mnt/lvol1

  17. Specify the settings required for using virtual environments.

    If you are using Xen, set up Xen to use HDLM devices in domainU. If you are using KVM, register HDLM devices into the hardware configuration file.

    For details on operating environments for the virtual environments supported by HDLM, see Virtual environments supported by HDLM. For details on how to set up a virtual environment, see Settings for Xen or Settings for KVM.

  18. Specify the settings required for operations in a cluster configuration.

    For a cluster configuration, change the logical device file names of SCSI devices specified in the cluster to logical device file names of HDLM devices.

    For details on setting the cluster software, see Settings for Oracle.