prepareha (prepare appliance for HA group)

Prepares an appliance to be part of an HA group that uses a unique, generated key for communication between appliances.

Purpose

You use the prepareha command to prepare an appliance to be part of an HA group that uses a new, generated key for communication. You run it on the appliance that you do not run crthagrp on.

Syntax

Read syntax diagramSkip visual syntax diagram prepareha -s SecretText -a IPAddress -ttimeout

Parameters

-a IPAddress
Specifies the IP address of the HA group primary interface on other appliance in the group. You must specify the IP address using ip v4 dotted decimal notation (for example, 192.0.2.8).
The command is run on only one appliance. The IP address specified must be that of the appliance that the command is not run on.
-s SecretText
Specifies a string that is used to generate a short-lived password. The password is used to set up the unique key for the two appliances. After prepareha is run, crthagrp must be run first on the other appliance in the HA group, specifying the same -s SecretText argument.
-t timeout
Specifies the time period in seconds that you have to run the crthagrp command on the other appliance in the group. It defaults to 600 (that is, ten minutes).

Usage Notes

  • This command must be run from the IBM® MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
  • The appliances must be connected to each other with cables inserted in the correct ports. For more information about configuring the appliance hardware for HA, see Configuring the hardware for high availability.

Examples

  • The following example shows the creation of an HA group for appliances appl1 and appl2 where a new, unique key is generated for communication between the appliances. The HA group primary interface of appl2 has the IP address 192.0.2.8, the HA group primary interface of appl1 has the IP address 192.0.2.7.

    The following command is run from appl1:

    
prepareha -s AGEW1823510HH -a 192.0.2.8

    The following command is run from appl2:

    
crthagrp -s AGEW1823510HH -a 192.0.2.7