Registering Fault Tolerant EMS Servers

The TEA Agent for TIBCO Enterprise Message Service™ can register TIBCO Enterprise Message Service servers that have been set up for fault-tolerance. The TEA Agent for TIBCO Enterprise Message Service only supports fault tolerance in pairs of TIBCO Enterprise Message Service servers.

You can set up a pair of TIBCO Enterprise Message Service servers for fault tolerance by configuring one server as the primary server and another one as the secondary server. Upon startup, the first server to start reaches the active state and the other the standby state. The active server accepts client connections, and interacts with clients to deliver messages. If the active server fails, the standby server becomes active and resumes operation in its place.

Prerequisites

  • The two TIBCO Enterprise Message Service servers should be set up for fault tolerance before registering them with the TEA Agent for TIBCO Enterprise Message Service.
  • The server URL in tibemsd.conf file must explicitly contain the IP address or "localhost" in it, for example tcp://localhost:7222, or you must explicitly mention the IP address instead of "localhost". If you leave out the IP address or localhost from the URL, the servers will fail to register with the TEA server.
  • Both the TIBCO Enterprise Message Service servers must be running when registering them with the TEA Agent for TIBCO Enterprise Message Service.

To register a pair of fault tolerant TIBCO Enterprise Message Service with the TEA agent for TIBCO Enterprise Message Service, follow these steps:

Procedure

  1. Make sure that the primary and secondary TIBCO Enterprise Message Service servers have been set up for fault tolerance. If not, follow the instructions in the chapter on Fault Tolerance in TIBCO Enterprise Message Service User’s Guide.
  2. Start the TIBCO Enterprise Message Service servers by running the following command from their bin directory: tibemsd.exe -config <path-to-tibemsd.conf>
  3. Start the TEA server.
  4. Start the TEA Agent for TIBCO Enterprise Message Service from <TIBCO_HOME>\tea\agents\ems\<version>\bin directory.
  5. Register the TIBCO Enterprise Message Service servers with the TEA Agent for TIBCO Enterprise Message Service as follows:
    1. In the TEA web user interface, click the TIBCO Enterprise Message Service product card to open the Server Management page.
    2. Click the Register Server button.
    3. Fault Tolerant: Select this check box.
    4. Server Name: Enter the name of the TIBCO Enterprise Message Service server.
    5. Primary URL: Enter the URL for the TIBCO Enterprise Message Service server that has been configured as the primary server. Make sure this URL matches the URL set in the tibemsd.conf file in the EMS server exactly. The IP address or hostname of the server must explicitly appear in the URL.
    6. Secondary URL: Enter the URL for the secondary TIBCO Enterprise Message Service server. Make sure this URL matches the URL set in the tibemsd.conf file in the EMS server exactly.
    7. Username and Password: Enter the user name and password for the TIBCO Enterprise Message Service servers.
    8. Click Register Server.
    Note: If the EMS server is configured using the JSON mode, in the TIBCO Enterprise Administrator UI, you will not be able to expand the server tree in the standby mode. However, this is not the case with the active mode.

    If the EMS server is configured using the classic configuration, that is by using the conf file, in the TIBCO Enterprise Administrator UI, you can drill down the server tree both in the standby and active modes.