This section explains how to upgrade the multipath software (ETERNUS Multipath Driver or PowerPath) in the system where the ETERNUS Multipath Driver or Dell EMC PowerPath device is registered to GDS.
All user operations must be stopped for taking this procedure.
Back up the system disks and the data of customers before taking the following steps.
Displaying class information
Execute the following command on all the nodes to check the configuration information of created classes.
# sdxinfo -C
OBJ NAME TYPE SCOPE SPARE
------ ------- -------- ----------- ----
class class00 shared node1:node2 0
class class01 shared node1:node2 0
class class02 local node1 0 |
Stopping applications
Stop all the applications that are accessing the disks of storage units to which the multipath software to be upgraded is applied.
Also, execute the umount(1M) command to unmount the file systems created on the disks of these storage units.
Stopping RMS
Take the following steps to stop RMS.
3-1) Execute the following command on any one of the nodes where RMS is running to stop RMS.
# hvshut -a |
3-2) Execute the following command on all the nodes to check that RMS is correctly stopped and the message "RMS is not running." is output.
# hvdisp -a |
3-3) Set up to avoid the automatic startup of RMS until the multipath software is upgraded.
Execute the following command on all the nodes where RMS is used. # hvsetenv HV_RCSTART 0 |
Backing up GDS configuration information
Take the following steps to back up the GDS configuration information.
Specify any directory other than /tmp or its subdirectories for mydir in the subsequent procedure.
4-1) Back up class configuration information.
For all the classes where the disks of storage units to which the multipath software to be upgraded is applied are registered, execute the following command on any one of the nodes that is included in the class scope.
You can check the class scope in the SCOPE field output by executing the sdxinfo -C command executed in step 1.
# sdxconfig Backup -c classname -o /mydir/classname.bkup |
4-2) Stop volumes.
For all the classes where the disks of storage units to which the multipath software to be upgraded is applied are registered, execute the following command on any one of the nodes that is included in the class scope.
Shared classes:
# sdxvolume -F -c classname -e allnodes |
Local classes:
# sdxvolume -F -c classname |
4-3) Change shared classes to local classes.
For all the shared classes where the disks of storage units to which the multipath software to be upgraded is applied are registered, execute the following command on any one of the nodes that is included in the class scope.
# sdxattr -C -c classname -a type=local |
4-4) Remove classes.
For all the classes where the disks of storage units to which the multipath software to be upgraded is applied are registered, execute the following command on the same node as step 4-3).
# sdxconfig Remove -c classname |
Switching to single-user mode
Execute the following command to switch the mode to single-user mode.
# /usr/sbin/shutdown -i0 -g0 -y : : ok boot -s : : # mountall -l |
Upgrading Multipath Software
Upgrade the multipath software.
PowerPath must be upgraded by Dell EMC engineers.
After the multipath software is upgraded, check that both the multipath device and the native device name are not changed before and after the upgrade.
If these device names have been changed, change them back to the original names before the upgrade. For PowerPath, contact Dell EMC engineers.
Switching to multi-user mode
Execute the following command on all the nodes to switch the mode to multi-user mode.
# /usr/sbin/shutdown -i6 -g0 -y |
Setting excluded device list
If the excluded device list is not created after upgrading PowerPath, create it.
Take this step on all the nodes where the disks of Dell EMC storage units are registered to the class.
For how to create the excluded device list, see "A.2.26 To Use Dell EMC Storage Units."
Restoring GDS configuration information
Take the following steps to restore the GDS configuration information.
9-1) Restore the class configuration information.
For all the classes where the disks of storage units to which the upgraded multipath software is applied are registered, execute the following command on any one of the nodes that is included in the class scope.
You can check the class scope in the SCOPE field output by the sdxinfo -C command executed in step 1.
# sdxconfig Restore -c classname -i /mydir/classname.bkup |
When the above command is executed, the classes will be restored as local classes on the node where the command was executed.
9-2) Restart the system.
Execute the following command on the same node as step 9-1).
# /usr/sbin/shutdown -i6 -g0 -y |
9-3) Change local classes to shared classes.
For all the shared classes where the disks of storage units to which the upgraded multipath software is applied are registered, change the local classes that were restored in step 9-1) to shared classes.
For the classes whose TYPE fields are listed as shared in the output of the sdxinfo -C command when it was executed in step 1), execute the following command on the same node as step 9-1).
# sdxattr -C -c classname -a type=shared,scope=nodename1:nodename2 |
9-4) Set up the classes to be used as RMS resources.
For all the shared classes where the disks of storage units to which the upgraded multipath software is applied are registered, execute the following command on any one of the nodes that is included in the class scope.
# /opt/SMAW/SMAWRrms/bin/hvgdsetup -a classname |
Checking restored classes
Execute the following command on all the nodes to check that all the restored classes are correctly displayed.
# sdxinfo -C |
Starting RMS
Take the following steps to start RMS.
11-1) Execute the following command on any one of the nodes to start RMS.
# /opt/SMAW/SMAWRrms/bin/hvcm -a |
11-2) Execute the following command on all the nodes to check that RMS has correctly started.
# hvdisp -a |
11-3) To start RMS automatically during node startup, execute the following command on all the nodes where RMS is used.
# hvsetenv HV_RCSTART 1 |
Starting applications
Execute the mount(1M) command to mount the file systems on the disks of storage units to which the upgraded multipath software is applied.
Also, start the applications that use the disks of these storage units.
