Registering Fault Tolerant EMS Servers

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

You can set up a pair of EMS servers for fault tolerance by configuring one server as the primary server and another one as the secondary server. On 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.

Before you begin
  • The two EMS servers must 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 omit the IP address or localhost from the URL, the servers fail to register with the TEA server.
  • Both the EMS servers must be running when registering them with the TEA agent for TIBCO Enterprise Message Service.

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

    Procedure
  1. Make sure that the primary and secondary EMS servers have been set up for fault tolerance. If not, follow the instructions in the "Fault Tolerance" topic in the TIBCO Enterprise Message Service User Guide.
  2. Start the EMS 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 EMS 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. Select the Fault Tolerant check box.
    4. Server Name: Enter the name of the EMS server.
    5. Primary URL: Enter the URL for the EMS 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 EMS 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 TEA UI, you cannot expand the server tree in the standby mode. However, this is not the case with the active mode.

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