Configuring IBM IoT MessageSight servers as an HA pair by using the IBM IoT MessageSight Web UI

In this scenario, a server that has HA disabled is now paired with another server to act as its backup. System administrators can configure a pair of servers for high availability (HA) by using the High Availability page in the IBM® IoT MessageSight Web UI.

About this task

You can configure IBM IoT MessageSight servers for high availability by using the IBM IoT MessageSight Web UI or by using REST Administration APIs. For more information about using the REST Administration APIs to configure servers for high availability, see Configuring IBM IoT MessageSight servers as an HA pair by using REST Administration APIs.

In this scenario, Server A is already member of a cluster, and becomes the primary node. Server B becomes the standby node in the HA pair. Server A can be a server that has data on it. Server B must be a newly installed IBM IoT MessageSight server or you must complete Step 1 to remove any pre-existing data.

Procedure

  1. Optional: If Server B is a newly installed server, you do not need to perform this step. If Server B is not a newly installed server and has been used for messaging services, you must delete any JMS queues that exist on the server and then clean the store.
    1. If necessary, delete any existing JMS queues. For more information about deleting queues, see Configuring queues by using the IBM IoT MessageSight Web UI.
    2. Click Server Control in the Server menu.
    3. Click Clean store.
      This step cleans the store and restarts the server.
  2. Configure high availability on Server A:
    1. From the Server menu, select High Availability.
    2. Click Edit in the Configuration panel.
    3. Select High Availability Enabled.
    4. Complete the High Availability Group field.
      The value must be the same on Server A and Server B.
    5. Under Replication and Discovery Addresses:
      1. Type the IP address of the replication interface of the local node in Local Replication Address. For example, 192.0.2.0
      2. Type the IP address of the discovery interface of the local node in Local Discovery Address. For example, 192.0.3.0
      3. Type the IP address of the discovery interface on the other node (Server B) in the HA pair in Remote Discovery Address. For example, 192.0.3.2
    6. Expand the Advanced Settings section by clicking the twistie.
      1. Ensure that Auto-detect is selected as the Startup Mode.
      2. Select the When both nodes start in auto-detect mode, this node is the preferred primary node check box.
      3. In the Discovery Timeout field, type the amount of time in seconds that within which an server that is started in auto-detect mode has to connect to the other server in the HA pair.
      4. In the Heartbeat Timeout field, type the amount of time within which an server has to determine if the other server in the HA pair has failed.
    7. Click Save.
    8. Click Restart Later.
  3. Configure high availability on Server B:
    1. From the Server menu, select High Availability.
    2. Click Edit in the Configuration panel.
    3. Select High Availability Enabled.
    4. Complete the High Availability Group field.
      This value must match the value on Server A.
    5. Under Replication and Discovery Addresses:
      1. Type the IP address of the replication interface of the local node in Local Replication Address. For example, 192.0.2.2
      2. Type the IP address of the discovery interface of the local node in Local Discovery Address. For example, 192.0.3.2
      3. Type the IP address of the discovery interface on the other node (Server A) in the high availability pair in Remote Discovery Address. For example, 192.0.3.0
    6. Expand the Advanced Settings section by clicking the twistie.
      1. Ensure that Auto-detect is selected as the Startup Mode.
      2. Ensure that the When both nodes start in auto-detect mode, this node is the preferred primary node check box is not selected.
      3. In the Discovery Timeout field, type the amount of time in seconds that within which an server that is started in auto-detect mode has to connect to the other server in the HA pair.
      4. In the Heartbeat Timeout field, type the amount of time within which an server has to determine if the other server in the HA pair has failed.
    7. Click Save.
    8. Click Restart Later.
  4. Restart both IBM IoT MessageSight servers:
    Tip: As a best practice, restart the standby server first. Then restart the primary to limit the amount of time that the primary spends waiting for the standby to become available.
    1. Click Server Control in the Server menu.
    2. Restart the server by clicking Restart the server.

Results

When the HA pair is up and running, you can view the status of each server from the Status menu on the IBM IoT MessageSight Web UI. You can view further information on the status of the server by using the Server Control page. You can view further information about the HA role of the server by using the High Availability page.