clconvert_snapshot command

Purpose

The command copies the previous version's ODM data from the snapshot_file to the format of the new version's ODM structure.

Syntax

clconvert_snapshot -v release -s < snapshotfile >

Description

You can run clconvert_snapshot to upgrade cluster snapshots from a previous version of PowerHA® SystemMirror® to the most recent version of PowerHA SystemMirror. The command by default assumes you are converting to the latest version of the software.

If fields were deleted in the new version, the data is saved to /tmp/cl_convert_PowerHA SystemMirror_OLD . The command then ensures that the data is in the correct form for the new version.

Once a snapshot file has been upgraded, it is assigned the same name as the previous version and cannot be reverted back to the previous version. A copy of the old version of the snapshot will be saved for you with the same original name plus the .old extension.

You must be in the /usr/es/sbin/cluster/conversion directory on the same node that took the snapshot to run the clconvert_snapshot command.

Once the snapshot file has been upgraded and all of the nodes in the cluster have the current level installed, the upgraded snapshot can be applied and then the cluster can be brought up.

The script clconvert_snapshot creates an old version of the ODMs and populates those ODMs with the values from the user-supplied snapshot file. It then calls the same commands that cl_convert uses to convert those ODMs to the current version. A new snapshot is taken from the upgraded ODMs and copied to the user supplied snapshot file.

The clconvert_snapshot is not run automatically during installation, and must always be run from the command line.

Table 1. clconvert_snapshot flags
Flag	Description
-v	Release version flag. Specifies the release number from which the conversion is to be performed. Important: Do not use the clconvert_snapshot command unless you know the version from which you are converting.
-s	Snapshot file flag. Specifies the snapshot file to convert. If you do not specify a path, for the snapshot file, the command uses the path specified in the $SNAPSHOTPATH variable. The default is /usr/es/sbin/cluster/snapshots.

Example

Run the following command to convert a PowerHA SystemMirror 5.3 snapshot to a current PowerHA SystemMirror snapshot named "mysnapshot."

clconvert_snapshot -v 5.3 -s mysnapshot

The file "mysnapshot" is in turn placed in the directory specified by the $SNAPSHOTPATH environment variable. If a $SNAPSHOTPATH variable is not specified, the file is put in /usr/es/sbin/cluster/snapshots.