Upgrade installation of HDLM in a boot disk environment

To perform an upgrade installation of HDLM in a multi-path boot disk environment that uses an HDLM device, and to set up the environment:

This subsection explains how to perform an upgrade installation of HDLM and specify environment settings in a multi-path configuration boot disk environment using the HDLM device.

Note that if settings are incorrect, the OS might not start. For details about what action to take if the OS cannot be started from an HDLM device, see BOOT_PERFORMING_AN_UPGRADE_INSTALLATION_OF_HDLM=GUID-068BB27C-E7E0-41F4-8C4C-55E8865333AE=2=EN=.html.

The name of the boot loader configuration file used in these procedures differs depending on the boot loader and OS. The following table lists the names of the boot loader configuration files.

1. Log in to Linux as a user with root permissions.

2. Check that the HDLM boot disk environment is used.

   Execute the following command to check the root (/) information.

   # /bin/mount | /bin/grep -w /

   If an HDLM device is output, the HDLM boot disk environment is used.

   If an HDLM device is not output, execute the following command:

   # /sbin/dmsetup deps {output-device}

   If the command terminates abnormally, the HDLM boot disk environment is not used.

   If the command terminates normally, a list containing the items major and minor is output.

   Execute the /bin/cat /proc/devices | /bin/grep -w {major} command with the value major specified for the argument.

   If sddlmfdrv is output, the HDLM boot disk environment is used.

   If sddlmfdrv is not output, the HDLM boot disk environment is not used.

3. If the HDLM LVM boot disk environment is used, check the /etc/lvm/lvm.conf file.

   Check the values of the items below. If an incorrect value is set, change it to the correct value.

   Record the original values, because they are necessary when removing HDLM.

   • For Red Hat Enterprise Linux 9 or Oracle Linux 9:

     • global_filter = [ "a|sddlm[a-p][a-p].*|", "r|/dev/sd|" ]

     • types = [ "sddlmfdrv", 16 ]

     • md_component_detection = 0

     • allow_changes_with_duplicate_pvs = 1

     • multipath_component_detection=0

     • use_devicesfile=0

   • For Red Hat Enterprise Linux 8, Oracle Linux 8 or SUSE LINUX Enterprise Server 15 SP2 or later:

     • global_filter = [ "a|sddlm[a-p][a-p].*|", "r|/dev/sd|" ]

     • types = [ "sddlmfdrv", 16 ]

     • md_component_detection = 0

     • allow_changes_with_duplicate_pvs = 1

     • multipath_component_detection=0 (For Red Hat Enterprise Linux 8.8 or later, Oracle Linux 8.8 or later, or SUSE LINUX Enterprise Server 15 SP5 or later)

   • For SUSE LINUX Enterprise Server 12, SUSE LINUX Enterprise Server 15 SP1 or earlier, Red Hat Enterprise Linux 7 or Oracle Linux 7 :

     Specify 1 for allow_changes_with_duplicate_pvs. For details, see NOTES_ON_USING_LVM2=GUID-91F95B7F-B4F1-4A73-A110-536AD5C219CC=5=EN=.html.

     If you want to use use_lvmetad=0 for operation, specify filter, not global_filter.

     • filter = [ "a|sddlm[a-p][a-p].*|", "r|/dev/sd|" ]

     • write_cache_state = 0

     • types = ["sddlmfdrv", 16 ]

     • md_component_detection = 0

4. If the environment is using LVM, disable the LVM cache. For details, see NOTES_ON_USING_LVM2=GUID-91F95B7F-B4F1-4A73-A110-536AD5C219CC=5=EN=.html.

5. Check that the HDLM device or the logical volume that was created on the HDLM device is specified in the definition of the /etc/fstab file.

   Make sure that the mount points for the HDLM management-target devices are defined so that the HDLM device will be mounted:

   The following shows an example of the /etc/fstab file:

                               :
                               :
   /dev/sddlmaa2   /     ext2    defaults       1 1
                               :
                               :
   /dev/sddlmaa4   /tmp  ext2    defaults       1 2
                               :
                               :

   Note that, in the HDLM boot disk environment, the following format restrictions, depending on the OS, apply to the device names that can be specified in the mount point for the root (/) partition. If a different format is used, change the item to the correct format.

   Table. Device name format that can be specified for the root partition (/) in the /etc/fstab file

   OS	HDLM boot disk environment
   	Without LVM	With LVM
   Red Hat Enterprise Linux 7, 8, 9 Oracle Linux 7, 8, 9	/dev/{HDLM device}	/dev/mapper/{VG}-{LV}
   SUSE LINUX Enterprise Server 12, 15		UUID={UUID-value} or /dev/{VG}/{LV}

6. Execute the swapoff command to disable a swap device.

   An example of executing the command to disable all swap devices is as follows:

   # /sbin/swapoff -a

   In an environment where all of the following conditions are met, if you perform the step while a swap device is enabled, the host might take a while to stop.

   Make sure to disable the swap, and then perform the step.

   • Either of the following OSs is used:

     • Red Hat Enterprise Linux 7, 8, 9

     • Oracle Linux 7, 8, 9

     • SUSE LINUX Enterprise Server 12, 15

   • An upgrade installation is performed for a version of HDLM earlier than 8.6.2-01.

   • An HDLM device is enabled as a swap device.

7. Perform an upgrade installation of HDLM.

   To perform an upgrade installation, specify installux.sh or the installhdlm utility that are stored on the HDLM DVD-ROM. The following shows an example of performing an upgrade installation when the mount point for the DVD-ROM is /media/cdrom.

   1. To run installux.sh:

      # /media/cdrom/installux.sh -update

   2. To run the installhdlm utility:

      # /media/cdrom/HDLM_Linux/installhdlm -update

8. Restart the host.

   Execute the following command to restart the host.

   # /sbin/shutdown -r now

9. Check that the HDLM boot disk environment is used.

   For details on how to check the environment, see step 8 in BOOT_SETTING_UP_XEN=GUID-07C2F5FE-7561-46DC-B423-A2C9B671F65B=5=EN=.html.