Migrating a cluster configuration

You can migrate the cluster that you created and configured on the VIOS logical partition that has Version 2.2.0.11, Fix Pack 24, Service Pack 1 to the VIOS logical partition that has Version 2.2.1.0. By performing this task, you can restore the previous shared storage pool mappings with a new shared storage pool and database versions.

To migrate a cluster that you created and configured on the VIOS logical partition that has Version 2.2.0.11, Fix Pack 24, Service Pack 1 to the VIOS logical partition that has Version 2.2.1.0, or later:

  1. Create a backup of the cluster that you want to migrate on the VIOS logical partition that has Version 2.2.0.11, Fix Pack 24, Service Pack 1. For example:
    viosbr -backup -file oldCluster -clustername clusterA
    Save the backup file that is generated on a different system. For example: oldCluster.clusterA.tar.gz.
  2. Reinstall the VIOS logical partition that has Version 2.2.1.0, or later.
    Note: Do not change the physical volumes that are used for the storage pool.
  3. Migrate the backup file that was created in step 1 to the VIOS logical partition that has Version 2.2.1.0, or later. For example:
    viosbr -migrate -file oldCluster.clusterA.tar.gz
    This step migrates the backup file to the VIOS logical partition with VIOS Version 2.2.1.0, or later. For example: oldCluster_MIGRATED.clusterA.tar.gz.
  4. Clean the physical volume that will be used as the cluster repository disk. For example:
    cleandisk -r hdisk9
    Note: Do not change the physical volumes that are used for the storage pool.
  5. Note: With VIOS Version 2.2.2.0, and later, you do not need to restore the network devices prior to restoring a cluster when you are migrating a cluster configuration. Hence, if you are using VIOS Version 2.2.2.0, and later, skip this step.
    Restore the network devices by using the migrated backup file. For example:
    • viosbr -restore -file oldCluster_MIGRATED.clusterA.tar.gz -clustername clusterA -repopvs hdisk9
      -type net
    • viosbr -restore -file oldCluster_MIGRATED.clusterA.tar.gz -clustername clusterA -subfile 
      clusterAMTM9117-MMA0206AB272P9.xml -type net
  6. Restore the cluster by using the migrated backup file. For example:
    • viosbr -restore -file oldCluster_MIGRATED.clusterA.tar.gz -clustername clusterA -repopvs hdisk9
    • viosbr -restore -file oldCluster_MIGRATED.clusterA.tar.gz -clustername clusterA -subfile 
      clusterAMTM9117-MMA0206AB272P9.xml
    After a successful restore operation, the cluster and all shared storage pool mappings are configured as in the VIOS logical partition that has Version 2.2.0.11, Fix Pack 24, Service Pack 1.
  7. Verify that the cluster restored successfully by listing the status of the nodes in the cluster. For example:
    cluster -status -clustername clusterA
  8. List the storage mappings on the VIOS. For example:
    lsmap -all
    Note: To migrate a cluster from VIOS Version 2.2.1.3 to VIOS Version 2.2.2.0, ensure that the rolling update procedure is completed.



Last updated: Thu, October 15, 2020