To perform an upgrade installation of HDLM:
The following is the procedure for an upgrade installation. The preparations before installing HDLM are required. For details about the preparations before installing HDLM, see Preparations for an upgrade installation or re-installation of HDLM.
A license key is required if you perform an upgrade installation of HDLM from a version earlier than 5.4 or if you install HDLM 5.4 or a later version after the valid license period has expired.
Log on to Linux as the root user.
If the environment is using LVM, disable the LVM cache. For details, see Notes on using LVM2.
Make sure that no HDLM devices are being used.
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 0If 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.
Prepare the license key.
If a permanent license key has already been entered or if the license key has not yet expired, go to step 5.
If the license key has expired, perform either of the following operations to store the license key file in the designated directory.
Store the license key file (*.plk) in the /var/tmp directory, under the name hdlm_license.
/var/tmp/hdlm_license
Execute the following commands to create the license key file (dlm.lic_key) in the /etc/opt/DynamicLinkManager directory.
If the /etc/opt/DynamicLinkManager directory does not exist, use the mkdir command to create the directory.
# mkdir /etc/opt/DynamicLinkManager # echo "license-key" > /etc/opt/DynamicLinkManager/dlm.lic_key
- Notes on the license key for a re-installation:
-
When a permanent license key has been entered, you do not need to create the license key file.
When a temporary or emergency license key has been entered, the expiration date for the key is displayed.
If the temporary license key or the emergency license key is expired, you need to update the license key file (dlm.lic_key) in the /etc/opt/DynamicLinkManager directory.
When the license key file is not found during installation, the following message appears, and the process continues: KAPL09090-W This operation will now be continued without updating the license.
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 #
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
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
When executing the installhdlm utility
# /media/cdrom/HDLM_Linux/installhdlm
The KAPL09093-I message is displayed to confirm that you want to perform an upgrade installation. Check the HDLM version, and if it is correct, enter y.
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.
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.
When you want to set the HDLM driver options, run the dlmsetopt utility for setting HDLM driver option.
For details on this utility, see dlmsetopt utility for setting HDLM driver options.
If you performed this step, go to step 14.
When you want to install HDLM without restarting the host, go to step 13. When you want to install HDLM with restarting the host, then go to step 14.
Execute the dlmstart utility for starting HDLM.
For details, see dlmstart utility for starting HDLM.
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
If the PATH environment variable is not set, specify an absolute path to execute commands and utilities.
If you have performed steps 13, go to step 16.
Restart the host.
Execute the following command to restart the host:
# shutdown -r now
A path will be established in the HDLM device and the HDLM manager will start.
If you have edited the /etc/fstab file as described in Operations required for devices to be managed by HDLM, return the lines you commented out (by placing a hash mark (#) at the beginning) to their original state.
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.
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 do not use the volume management software, go to step 24.
For details on other settings for the volume management software, see Settings for LVM2.
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
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
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.
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.