Changing the Endpoint of a Message Broker

The endpoint (port number) of a Message Broker is specified when you install it. If you later want to configure a Message Broker to use a different endpoint, you must edit the STMessageBroker68.ini file.

To change the endpoint number of a Message Broker:

Make the change to the STMessageBroker68.ini file for that Message Broker:
1. Open the STMessageBroker68.ini file in a text editor.
2. Add or edit the following line:
```
setopt conn_names tcp:servername:endpoint
```
  where
  
  servername
  
  Is the TCP/IP address or name of the computer where the Message Broker runs; you can use the keyword “_node” to designate the primary IP address of the local host independent of its host name. You can use the keyword "_any" to have the Message Broker listen on all available IP addresses of the local host.
  
  endpoint
  
  Is the new endpoint you want the Message Broker to use. Default is 5101.
  
  For example:
```
setopt conn_names tcp:_node:5523
```
3. Save and close the file. Your changes will take effect the next time you start the Message Broker.
If this Message Broker is part of a Message Broker cloud, be sure to edit the STMessageBroker68.ini files associated with the other Message Brokers in the cloud.
For each server configuration that has one or more profiles that use this Message Broker, create or edit each profile using one of the following methods (this technique works only if the server has successfully started in MPX mode):
Use the Server Administration tool to edit the affected profiles:
1. From Server Administration, select the server configuration.
2. Click Tools > Administration > Configure Server.
3. From the Event Handlers tab, select StarTeamMPX Transmitter as the event handler.
4. From the Profile list, select an affected profile.
5. Click Modify to open the Event Handlers Profile Properties dialog box.
6. In the Profile Properties list, double-click server_names.
7. In the Event Handler Property dialog box, edit the appropriate endpoints in the Property Value field.
Your changes take effect the next time you start the server configuration.
Edit the associated MPXEventTransmitter.xml file directly
This technique should be used when the server is not currently running or not running in MPX mode.
1. Open the MPXEventTransmitter.xml file in a text editor.
2. Edit the server_names parameter in each affected unicast profile to reflect the new endpoint.
3. Save and close the file.
Your changes take effect the next time you start the server configuration.
For each MPX Cache Agent that accesses this Message Broker, edit the MessageBroker group to change the appropriate server_names parameter.
1. Open the MPX Cache Agent’s XML file in a text editor.
2. Find the server_names parameter for the correct Message Broker. For example, it might look like the following: <server_names>tcp:12.34.56.78:5101</server_names>
3. Change the endpoint/port number portion of that line.