Provision utility and its application for hostname and/or IP changes (4301559)

Shareplex embeds the hostname and/or IP address of the Source and/or the Target machine in a number of the files in the vardir directory that are used in replication.

Therefore replication will fail when hostname and/or IP Address changes on Source and/or Target.

Provision utility provides a solution to re-use the existing replication when the IP and/or hostname change. It is a standalone utility.

IP and/or hostname change on either Source OR Target.

Provision Utility should be run on all the machines that are affected.

Examples:

With A and B as source servers and C as target server.

1. When hostname and/or IP Address changes on A, run provision on Source server A and Target Server C.

2. When hostname and/or IP Address changes on A and B, run provision on Source server A and Target server C with the new details of A and run provision on Source server B and Target server C with the new details of B.

3. When hostname and/or IP Address changes on C, run provision on Source servers A and B and Target server C with the new details of C.

NOTE:

1. Shutdown Shareplex on the affected machines before running Provision utility.

2. Best practice is to test it in the test environment and with “–n” option (dry run) on production prior to implementing it on production.

3. Provision utility should be run from the PRODDIR/util directory. Make sure the permissions are set to executable. Also check the cksum on the provision utility file.
If the utility is not downloaded in a Binary format and cksum does not match, it will fail with the error below.

Change 0xac180319 to 0xa055f14 in RS.0a010305.131
copy RS.0a010305.131 to /u92/splex2200/temp/RS.0a010305.131
RS.0a010305.131 changed
Segmentation Fault(coredump)

4. If on Version 7.0 and below, add this new parameter to the end of param-defaults file (it is located in $SP_SYS_PRODDIR/data) if it doesn’t exist.

SP_CFP_DEBUG I live int() 0x00000000

If it is not set, provision utility fails with error.

"slg: can't fetch debug flag for cfp module

Couldn't retrieve logging parameters

Error initializing shareplex modules"

5. Manually remove the 0 byte RS files(from $SP_SYS_VARDIR/rim) before running the provision utility to prevent the following error.

"Fatal error occurred while reading /var/splex/gleast/rim/RS.0aaa182c.36 asked for 32 bytes, got 0 Aborting provision"

6. After running the utility for a hostname change, it might not update the "hostname" column in SHAREPLEX_ACTID table with the new hostname details.
If it is not changed, Update the SHAREPLEX_ACTID table manually with the new hostname.

Login to the DB as Shareplex User and run

Update SHAREPLEX_ACTID set HOST_NAME = '<New Host Name>'

7. When running Provision on AIX, EXTSHM environment variable must be set to “ON”

$export EXTSHM=ON

8. To run the utility, execute the following command:

Usage provision: -f <from hostname>[:from ipaddress] -t <to hostname>[:to ipaddress] -n

The parameters in square brackets [ ] are optional.

Parameters in detail:

-f <from hostname>: From hostname. Required. If the required ip address cannot be obtained from the network, it can be specified

-t <to hostname>: To hostname. Required. If the required ip address cannot be obtained from the network, it can be specified

-n: Optional. When this is used, the utility will not change anything. It will only report the changes that will be made.

For example:

> provision -f prodold -t prodnew