Message Queue Connection Configuration

Upgrade Guide › Upgrading Server and Endpoint Components › Upgrade from CA ControlMinder r12.0 SP1 › Upgrade the Distribution Host (DH) › How to Configure Message Routing Settings › Message Queue Connection Configuration

Message Queue Connection Configuration

To route messages from the Message Queue on the Distribution Server to the Enterprise Management Server conversely, you modify the existing Message Queue settings in your enterprise.

Example: Configuring the Message Queue Connection Settings on the Distribution Server

This example shows you how to configure the Message Queue server settings on the Distribution Server. You configure the Message Queue to send messages to the Enterprise Management Server by defining the parameters of the Message Queue that is running on the Enterprise Management Server.

Follow these steps:

On the Distribution Server, do one of the following:
- (Windows 2003 Server) Select Start, Programs, TIBCO-CA_AC, TIBCO EMS 5.1, Start EMS Administration Tool.
- (UNIX) Do the following:
  1. Navigate to the following directory, where DistServerInstallDir is the directory in which you installed the Distribution Server:
```
   DistServerInstallDir/MessageQueue/tibco/ems/5.1/bin
```
  2. Run the following command:
```
   tibemsadmin
```
    The TIBCO EMS Administration Tool command prompt window opens.
Connect to the Message Queue using either of the following:
- Enter the following command to connect using SSL:
```
connect ssl://localhost:7243
```
- Enter the following command to connect using TCP:
```
connect tcp://localhost:7222
```
A login name prompt appears.
Enter admin.
A password prompt appears.
Enter the password that you provided when you installed the Distribution Server.
When prompted, enter a new password for the Message Queue server.
Define the Message Queue password.
```
set server password= 
```
Example: set server password=<C0mp1ex>
Create a user named ENTM-NAME and assign a password to the user.
```
create user ENTM-NAME password=acserver_user-passwd
```
Example: create user EMS-SERVER password=<acserver_user-passwd>

Important! Specify the same name that you defined in the 'server' parameter of the tibemsd.conf file on the Enterprise Management Server.
Do the following:
1. Enter the following command:
```
add member ac_server_users ENTM_NAME
```
  The user you created is added to the ac_server_users group.
2. Enter the following command:
```
add member ac_endpoint_users ENTM_NAME
```
  The user you created is added to the ac_endpoint_users group.
3. Enter the following command:
```
add member report_publishers ENTM_NAME
```
  The user you created is granted permissions to read and publish messages to CA ControlMinder queues.
Restart the Distribution Server.
The changes you made are applied.

Example: Configure the Message Queue Connection Settings on the Enterprise Management Server

This example shows you how to configure the Message Queue server settings on the Enterprise Management Server. You configure the Message Queue to send messages to the Distribution Server.

In this example the term DS-NAME relates to the name of the Distribution Server computer and the term ENTM-NAME relates to name of the Enterprise Management Server. When you define the message queue server settings, you replace the name with the server actual names, as defined in the 'server' token in the tibemsd.conf file.

Follow these steps:

On the Enterprise Management Server, do one of the following:
- (Windows 2003 Server) Select Start, Programs, TIBCO-CA_AC, TIBCO EMS 5.1, Start EMS Administration Tool.
- (UNIX) Do the following:
  1. Navigate to the following directory, where ACServerInstallDir is the directory in which you installed the Enterprise Management Server:
```
   ACServerInstallDir/MessageQueue/tibco/ems/5.1/bin
```
  2. Run the following command:
```
   tibemsadmin
```
    The TIBCO EMS Administration Tool command prompt window opens.
Connect to the Message Queue using either of the following:
- Enter the following command to connect using SSL:
```
connect ssl://localhost:7243
```
- Enter the following command to connect using TCP:
```
connect tcp://localhost:7222
```
A login name prompt appears.
Enter admin.
A password prompt appears.
Enter the password that you provided when you installed the Enterprise Management Server.
Define the Message Queue password.
```
set server password=entm_server-passwd
```
Example: set server password=<ENTM_SERVER_NAME-passwd>
For each Distribution Server, create a user named DS-NAME and assign a password to the user.
```
create user DS-NAME password=dist_server_user
```
Example: create user EMS-Server password=<C0mp1ex>

Important! Specify the same name that you defined in the 'server' parameter of the tibemsdf.conf file on the Enterprise Management Server.
Do the following:
1. Enter the following command:
```
add member ac_server_users DS_NAME
```
  The user you created is added to the ac_server_users group.
2. Enter the following command:
```
add member ac_endpoint_users DS_NAME
```
  The user you created is added to the ac_endpoint_users group.
3. Enter the following command.
```
add member report_publishers DS_NAME
```
  The user you created is granted permissions to read and publish messages to CA ControlMinder queues.
Restart the Distribution Server for the changes to take effect.
You have configured the message queue connection settings on the Enterprise Management Server.

Note: For information about message routing, refer to the TIBCO Enterprise Message Service User's Guide. Tibco documentation is installed as part of the Message Queue and is located at ACServerInstallDir/MessageQueue/tibco/ems/5.1/doc.