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.	The displayed screen 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. Select Secure (SSL) Connection if required. Click Next.

SSL is a protocol for transmitting encrypted data over the Internet or an internal network. SSL works by using public and private keys to encrypt data that is transferred over the SSL connection.

7.	Provide values in the field for configuring the SSL connection. 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

 

Table 22 Fields for Adding EMS Server Machine

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

 

Table 23 Fields for Adding EMS Server

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.
Secure (SSL) Connection	Select the Secure (SSL) Connection check box to secure the communication between networks.

SSL Parameters

The following parameters are set when configuring SSL for a domain that uses an Enterprise Message Service server.

 

Table 24 Fields for Adding SSL Connection

Do Not Verify Host	Specifies whether the client should verify the server’s certificate. When cleared, the client should verify the server’s certificate. This is recommended. When selected, the client establishes secure communication with the server, but does not verify the server’s identity.
Trusted	A list of CA certificates to trust as issuers of server certificates. Supply only CA root certificates.
Identity	The client’s digital certificate. Supply a certificate in either the PEM or PKCS#12 format. You must also supply a private key file in the Private Key field if you supply a PEM-formatted certificate here.
Private Key	The name and location of the client’s private key file. This key must be in the PKCS#8 format.
Password	The password for the client’s private key.
Do Not Verify Hostname	Specifies whether the client should verify the name in the CN field of the server’s certificate. When cleared, the client should verify the name of the connected host or the name specified in the Expected Hostname field against the value in the server’s certificate. If the names do not match, the connection is rejected. When selected, the client establishes secure communication with the server, but does not verify the server’s name.
Expected Hostname	The name the client expects in the CN field of the server’s certificate. If this parameter is not set, the expected name is the hostname of the server. The value of this parameter is used when the Do Not Verify Hostname parameter is cleared.
Cipher Suite Names	Specifies the cipher suites that the client can use. Supply a list of cipher names by clicking Add and selecting from the pull down menu that is displayed. Remove an entry from the list by selecting the entry and clicking Remove. Make an in place change to the list by selecting an entry and clicking Edit. Select a replacement entry from the pull down menu that appears. For more information, see "Specifying Cipher Suites" in the TIBCO Enterprise Message Service User’s Guide.

Copyright © Cloud Software Group, Inc. All Rights Reserved