How to configure an EMS route.

How to configure an EMS route.

book

Article ID: KB0084788

calendar_today

Updated On:

Products Versions
TIBCO Enterprise Message Service -
Not Applicable -

Description

Resolution:
Description:
=========
1). Enable routing in the tibemsd.conf file on both servers (routing=enabled).

2). Create the route on both servers to point to the other server (create route name url=URL zone_name=zone_name zone_type=1hop|mhop properties)

Where:
  
name is the name of the server at the other end of the route; it also becomes the name of the route.

URL specifies the other server by its URL—including protocol and port.

zone_name specifies that the route belongs to the routing zone with this name. When absent, the default value is default_mhop_zone

The zone type is either 1hop or mhop. When omitted, the default value is mhop.

properties is a space-separated list of properties for the route. Each property has the syntax:
  prop_name=value


If authorization is enabled on any routed EMS Servers, after setting the server password, you also must make sure that on that server there is a user/password that matches the name of the EMS Server that you are creating a route to. Assume  
there are two servers named EMS-SERVER1 and EMS-SERVER2 and in both of them authorization is enabled. In that case, in the users.conf of EMS-SERVER1 you should have a user EMS-SERVER2 with password of EMS-SERVER2, and in users.conf of EMS-SERVER2, you should have a user called EMS-SERVER1 with password of user EMS-SERVER1.

3). Use the tibemsadmin tool to connect to EMS-SERVER1 and execute the following command:

a). set server password=&ltserver1_password>

b). create user EMS-SERVER2 password=&ltserver2_password> (if user "EMS-SERVER2" is not already created) or

c). set password EMS-SERVER2 < server2_password> (if user "EMS-SERVER2" has already been created in user.conf).

d). set server authorization=enabled


4). Use the tibemsadmin tool to connect to EMS-SERVER2 and execute the following command:

a). set server password=&ltserver2_password>

b). create user EMS-SERVER1 password=&ltserver1_password> (if the user "EMS-SERVER1" is not already created) or

c). set password EMS-SERVER1 < server1_password> (if user "EMS-SERVER1" has already been created in user.conf).

d). set server authorization=enabled

There are sample config files for working with routes, "tibemsdroute-1.conf" and "tibemsdroute-2.conf" in the &ltEMS>/bin directory for reference.

Environment:
==========
All

Issue/Introduction

How to configure an EMS route.