sethaint

Purpose

You use the sethaint command to specify a floating IP address that can be used by applications to connect to an HA queue manager, regardless of which appliance in an HA group it is actually running on. You also use sethaint to delete an existing floating IP address.

Parameters

-m QueueManager

Identifies the HA queue manager that you are creating or deleting the floating IP address for.

-a

Specifies that you are adding the address specified by the -f and -l options.

-d

Specifies that you are deleting the floating IP address for the specified queue manager.

-f floatingIP

Specifies the floating IP address. You must specify the IP address using ip v4 dotted decimal notation (for example, 192.0.2.8).

-l LocalInterface

Specifies the name of the local interface that is used to connect to the queue manager on the two appliances in the HA group. For example, eth22. You can also specify an aggregate interface name, provided that the name obeys certain naming rules (see link-aggregation).

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.
• You can run the sethaint command only once for each queue manager. You can only define one floating IP address for IBM MQ traffic on a queue manager
• Both appliances in the HA pair must be active when you run this command.
• The local interface that you specify can be a physical interface that exists on both appliances and has a static IP address configured. You can also specify an aggregate interface that exists with the same name on each appliance. The name of the aggregate interface must obey certain rules to be used for this purpose, see link-aggregation. You cannot specify a VLAN interface.
• The floating IP address must be a valid IPv4 address that is not already defined on either appliance, and it must belong to the same subnet as the static IP addresses defined for the local interface.
• A message warns you that the queue manager has restarted when you add a floating IP address.

Example

The following example shows the floating IP address 192.0.2.15 being allocated for queue manager QM1 and associated with the local interface eth22:

sethaint -m QM1 -a -f 192.0.2.15 -l eth22
AMQ3495W:  The queue manager (QM1) will be restarted.
The sethaint command succeeded.