Modifying the secure TLS/SSL port used by MQTT

IBM® Sametime® Advanced uses the MQTT protocol for broadcast community events. When encryption is enabled using TLS/SSL, MQTT is configured to use port 8990; you can change the port setting if needed for your deployment.

Procedure

Complete the steps that apply to your Sametime Advanced configuration:
  • One stand-alone Sametime server:
    1. On the Sametime server, log in to the WebSphere® Integrated Solutions Console as the WebSphere administrator.
    2. In the navigation tree, click Applications > Application Types > WebSphere enterprise applications > Sametime Advanced Application -> Initialize parameters for servlets.
    3. Locate the SSLmqttPort field.
    4. Change the port value as needed.
    5. Click OK to save the new port setting.
    6. Save the change to the master configuration by clicking the Save link in the "Messages" box at the beginning of the page.
    7. Restart the server.
  • A cluster of Sametime servers that all use the same secure port for MQTT:
    1. On the cluster's deployment manager, log in to the WebSphere Integrated Solutions Console as the WebSphere administrator.
    2. In the navigation tree, click Applications > Application Types > WebSphere enterprise applications > Sametime Advanced Application -> Initialize parameters for servlets.
    3. Locate the SSLmqttPort field.
    4. Change the port value as needed.
    5. Click OK to save the new port setting.
    6. Save the change to the master configuration by clicking the Save link in the "Messages" box at the beginning of the page.
    7. In the navigation tree, click System Administration > Nodes.
    8. In the nodes table, select all of the nodes in the cluster.
    9. Click the Full Resynchronize button at the beginning of the table.
  • A cluster of Sametime servers in which each server uses a different port setting for secure MQTT Connections:

    If the servers in your cluster use different ports for MQTT Connections or if you are using vertical clustering, you must update the servers individually as explained in the IBM technote Setting broadcast tools port in vertical cluster.

    For example, if you configured a vertical cluster with multiple instances of Sametime hosted on the same computer, you would have been forced to select a different MQTT port for each cluster member; however, this would prevent clients from properly connecting to the cluster members and must be corrected using the technique explained in the technote.