setdrlink

Specify a non-default link to be used for DR replication in an HA configuration.

Purpose

By default, high availability configurations use the 10 Gb link eth20 for replicating data between the HA group and a DR appliance.

Advanced users, who are networking experts, can choose to use a different interface for replication. The setdrlink command is used to configure the alternative interface. You might, for example, choose to use one of the 40 Gb links for replication.

The command sets a new interface from that moment forward, so that any crtdrprimary and crtdrsecondary commands set up a DR configuration using the newly specified interface. Any queue managers configured to use DR before this point will continue to use the default interface, rather than the new one, unless you remove and recreate the DR configuration for those queue managers.

Syntax

Read syntax diagramSkip visual syntax diagram setdrlink -rreplicationIP-d

Parameters

-r replicationIP
Specifies the IP address of the interface to be used for replication. You must specify the IP address using ip v4 dotted decimal notation (for example, 192.0.2.8).
-d
Return to the default configuration.

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 IP address specified must map to a valid local interface or aggregation interface, otherwise the command fails. (You cannot specify a VLAN interface.)
  • The local interface should be at least a 10 Gb link, otherwise your are warned that performance might be poor.
  • You must select the same interface for both appliances in your HA group if you are using a floating IP address to replicate data. If you are not using a floating IP address, you do not have to use the same interface on both appliances..
  • If link aggregation interfaces are used for the DR interface then the aggregation interface names must be the same on both of the HA appliances.

Example

The following example shows the IP address 192.0.2.15 being allocated for replication in the HA configuration:

setdrlink -r 192.0.2.15