cl_convert command

Purpose

Upgrading PowerHA® SystemMirror® software to the newest version involves converting the Configuration Database from a previous release to that of the current release. When you install PowerHA SystemMirror, cl_convert is run automatically. However, if installation fails, you must run cl_convert from the command line. Root user privilege is required to run cl_convert.

Syntax

 [-F] -v < release> [-s< simulationfile>][-i]

Description

The command copies the previous version's ODM data to the new version's ODM structure. 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.

When the new version is installed, the install script adds the suffix OLD to the PowerHA SystemMirrorxxx classes stored in the /etc/objrepos directory, and it creates the new PowerHA SystemMirrorxxx classes for the new version. The install script issues the cl_convert command which converts the data in PowerHA SystemMirrorxxxOLD to the corresponding new classes in PowerHA SystemMirrorxxx.

You may run the cl_convert command from the command line, but it is expecting the PowerHA SystemMirrorxxx and PowerHA SystemMirrorxxxOLD ODM's to already exist.

You may want to run the cl_convert command with the -F option. If the option is not specified, the cl_convert command checks for configured data in the new ODM class PowerHA SystemMirrorcluster. If data is present, the command exits without performing the conversion. If the -F option is specified, the command will continue without checking for present data.

Note that cl_convert copies the PowerHA SystemMirrorxxx and PowerHA SystemMirrorxxxOLD ODM's to a temporary file ( /tmp/tmpodmdir ) for processing before writing the final data to the PowerHA SystemMirrorxxx ODM's. If cl_convert encounters any kind of error, the PowerHA SystemMirrorxxx ODM's are not overwritten. If no error occurs, the PowerHA SystemMirrorxxx ODM's are overwritten and the install script will remove the PowerHA SystemMirrorxxxOLD ODM's

Note that you must be in the conversion directory to run this command:

/usr/es/sbin/cluster/conversion

Also, cl_convert assumes that the correct value for ODMDIR is set. The results of cl_convert can be found in /tmp/clconvert.log.

Flags

-F: Force flag. Causes cl_convert to overwrite existing ODM object classes, regardless of the number of existing entries. Omitting this flag causes cl_convert to check for data in PowerHA SystemMirrorcluster (which there will always be from the previous configuration) and exit if data is encountered.
-v: Release version flag. Indicates the release number of the old version.
Important: Do not use the cl_convert command unless you know the version from which you are converting.
-s <simulation_file>: Simulation flag. Indicates that instead of writing the resulting ODM data back to the new PowerHA SystemMirrorxxx ODM's, write to the specified file in text format.
-i: Ignore copy flag. Specifies not to copy the PowerHA SystemMirrorxxxOLD data to the new PowerHA SystemMirrorxxx ODM's, but just operate directly on the new PowerHA SystemMirrorxxx ODM's. This is used primarily by clconvert_snapshot.

Note: The AIX® environmental variable ODMDIR must be set to the directory you want to convert.

Example

If a cluster is already configured for a previous release, during the installation of a new version of PowerHA SystemMirror., the installing script will call cl_convert as:

cl_convert -F -v <version of prior release>