Performing a re-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

To perform a re-installation of HDLM:

The following is the procedure for a re-installation. Some preparations before installing HDLM are required. For details about such preparations, see Preparations for an upgrade installation or re-installation of HDLM.

The license key is required when you re-install HDLM after the valid license period has expired.

Log on to Linux as the root user.
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  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.
- Preparations for an upgrade installation or re-installation of HDLM
- Operations on HDLM-managed devices
Prepare the license key.

Store the license key file (*.plk) in the /var/tmp directory, under the name hdlm_license.
```
/var/tmp/hdlm_license
```
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.

For details about how to create the license key, see Performing a new installation of HDLM.

For details about the license key, see Parameters.

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
#

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.
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 12.
When you want to install HDLM without restarting the host, go to step 11. When you want to install HDLM with restarting the host, then go to step 12.
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

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.

If you have performed steps 11, go to step 14.
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 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:
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 perform step 13:

Go to step 19.

If you performed step 13:

Go to step 20.

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

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 on the HDLM device belongs to the vg01 volume group:
```
# vgchange -ay vg01 
vgchange -- volume group "vg01" successfully activated
```
Mount the logical volume on the HDLM device.

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.