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 ActiveMQMessageBroker.ini file.

To change the endpoint number of a Message Broker:

Make the change to the ActiveMQMessageBroker.ini file for that Message Broker:
1. Open the ActiveMQMessageBroker.ini file in a text editor.
2. Add or edit the following line:
```
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 0.0.0.0 to designate the primary IP address of the local host independent of its host name.
  
  endpoint
  
  Is the new endpoint you want the Message Broker to use. Default is 61616.
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 ActiveMQMessageBroker.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 ActiveMQ MPX 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.