Copyright © Cloud Software Group, Inc. All Rights Reserved

Adding an EMS Server to a Domain

Use this procedure to create a new mapping for a TIBCO Enterprise Message Service server so that it can be administered using the TIBCO Administrator GUI as part of an administration domain.

TIBCO Domain Utility can verify the connection to the TIBCO Enterprise Message Service server only if Domain Utility is running on the machine on which the EMS server is installed. Before adding an EMS server to a domain: • Start the EMS server using the TIBCO_HOME\ems\bin\tibemsd command. • Using the tibemsadmin command-line utility, connect to the server and establish an EMS administration user name and password.

When adding an EMS Server to administration domain in a 64-bit environment, TIBCO Domain Utility must be enabled to use 64-bit libraries. See the TIBCO Runtime Agent Installation Guide for information about enabling TIBCO applications to run in 64-bit mode.

To Add an EMS Server Using the GUI

1.	Start Domain Utility on the machine on which the EMS server to be added is running and click the Next button on the main screen.

2.	Under Category, click TIBCO EMS Plugin, then click Add TIBCO EMS Server.

3.	Click Next and in the screen that appears, select an administration domain.

4.	Provide the Administrator credentials for the domain and click Next.

5.	A screen appears that describes the machine on which the TIBCO Enterprise Message Service software is installed. See EMS Server Machine Fields for field descriptions. Change these values if required and click Next.

6.	Provide information about the TIBCO Enterprise Message Service server. See EMS Server Fields for field descriptions.

7.	Click Next. A summary of the values you provided is displayed. Click the Test button to verify the values.

8.	Click Next to add the server to the domain.

9.	Click Finish to end the session.

To Add an EMS Server Using the Command Line Utility

1.	Create a working directory that will hold the XML file that defines configuration options.

2.	Copy the following file to your working directory working-dir-path\: TRA_HOME\template\domainutility\cmdline\AddJMSServer.xml

3.	Open AddJMSServer.xml in a text editor.

The parameters are explained in the next section. After changing the parameters, save the file and exit the text editor.

4.	Execute the following command to apply your changes to the domain:

   domainutilitycmd -cmdFile working-dir-path\AddJMSServer.xml

EMS Server Machine Fields

 

Machine Name	Provide the machine name on which the TIBCO Enterprise Message Service server is running. This must be the actual name and cannot be the IP address or an alias to the machine.
Cluster	The name of the container in which the Hawk agent will appear in the display by default. The display will create the container if it does not already exist. This allows for grouping of multiple agents. The default name for the container is the IP subnet address. The cluster name must be enclosed within quotes, if the name contains spaces.
OS Name	Operating system.
OS Version	Operating system version.

EMS Server Fields

 

Version	Provide the version number of the TIBCO Enterprise Message Service server you are installing. This version number will be displayed in the TIBCO Administrator GUI.
Executable File	Provide the full path to the TIBCO Enterprise Message Service server executable (tibemsd). For most Microsoft Windows systems, this path name is TIBCO_HOME/ems/bin/tibemsd.exe. Note that forward slashes are required.
Configuration File	Provide the full path of the server instance’s configuration file. The location of the working directory is inferred from the location of the configuration file. The configuration file tibemsd.conf locates in the EMS configuration directory that is defined during the installation of the specific version of TIBCO Enterprise Service. For example, the configuration file defaults to TIBCO_HOME/ems/6.0/bin/tibemsd.exe for a default installation of TIBCO Enterprise Message Service 6.0.0. Refer to TIBCO Enterprise Message Service Installation for the default location of tibemsd.conf on Unix and Windows platforms.
User Name	Specify the user account name authorized to administer the TIBCO Enterprise Message Service server.
Password	Specify the password for the user account given in User Name.
Port	Provide the port number on which the administration server is sending and receiving messages. Default is 7222.

Copyright © Cloud Software Group, Inc. All Rights Reserved