- -set hdlm
Configure the boot disk environment by editing the following files:
/etc/fstab
/etc/lvm/lvm.conf (If LVM2 is used as a system disk)
/etc/opt/DynamicLinkManager/hdlm.conf
Boot loader configuration file
Initial RAM disk image file
- -shutdown
Specify this parameter to automatically stop the host after the boot disk environment is configured.
- -reboot
Specify this parameter to automatically restart the host after the boot disk environment is configured.
- Notes
-
For Red Hat Enterprise Linux 8 version 8.8 or later, before executing the utility for creating an HDLM boot disk environment (dlmbootstart), confirm that the value of multipath_component_detection in the /etc/lvm/lvm.conf file is not set to 1. If it is set to 1, change it to 0.
For Red Hat Enterprise Linux 7, Oracle Linux 7 or Oracle Unbreakable Enterprise Kernel 7, before executing the utility for creating an HDLM boot disk environment (dlmbootstart), confirm that the value of allow_changes_with_duplicate_pvs in the /etc/lvm/lvm.conf file is not set to 0. If it is set to 0, change it to 1.
If the processing of the utility that was run with the -set hdlm parameter specified ends normally, a backup of the file prior to the change will be created in /var/opt/DynamicLinkManager/backups.
You must restart the host immediately after the utility is executed. If the utility is executed without specifying the -shutdown or -reboot parameter, manually restart the host.
During execution of the utility, you can press Ctrl+C at the same time to stop configuration of the boot disk environment. In this situation, the status returns to the status before the utility was executed.
If you execute the utility with the -shutdown or -reboot parameter specified, the KAPL12946-I message appears when the utility ends and the host stops or restarts one minute later. During this time, you can use Ctrl+C to interrupt the stop or restart processing of the host. However, the utility keeps the settings of the boot disk environment in which HDLM is used, instead of returning to the status before execution.
Depending on the environment that you are using, internal processing of the utility might disable the swap. In this situation, even if you use Ctrl+C to stop the configuration of the boot disk environment, the statuses of the swap devices disabled by the utility do not revert to the statuses prior to execution of the utility, and the swap devices remain disabled.
-
- -set restore
Specify this parameter to restore the state prior to the execution of dlmbootstart -set hdlm, by using the backup file that was created during the execution of dlmbootstart -set hdlm. If the environment prior to the execution of dlmbootstart -set hdlm was a boot disk environment that uses a SCSI device, the boot disk environment that uses a SCSI device will be restored. If the environment prior to the execution of dlmbootstart -set hdlm was a boot disk environment that uses an HDLM device, the boot disk environment that uses an HDLM device will be restored.
If you run the utility with the -set restore parameter specified, the file that was changed by running the utility with the -set hdlm parameter specified will be overwritten by the backup file.
- Notes
The environment built by executing the utility with the -set hdlm parameter can only be used to return to the original status.
The initial RAM disk image file for the SCSI disk cannot be recreated. Also, if a user changes a file that was changed during execution of the utility with the -set hdlm parameter specified, the backup file will overwrite those user changes.
For this reason, after execution of dlmbootstart -set hdlm, if you make important changes to a file that was changed by dlmbootstart -set hdlm, take a backup of that file.
If the processing of the utility that was run with the -set restore parameter specified ends normally, the backup file in /var/opt/DynamicLinkManager/backups will be automatically deleted.
The backup file created during execution of the utility with the -set hdlm parameter specified has only one generation. If unintended stops occur repeatedly during configuration of the boot disk environment with the -set hdlm parameter specified, the utility does not return to the status before execution even if you execute dlmbootstart -set restore.
The file /etc/opt/DynamicLinkManager/hdlm.conf is not to be backed up. To create an initial RAM disk image file for SCSI after using this parameter to return to the original environment, set n for hdlm_dracut, which is defined in /etc/opt/DynamicLinkManager/hdlm.conf, and then execute the dracut command.