Changing the SSL Configuration

After installation, you can enable or disable SSL by running the Update SSL and Connector Settings utility.

If you enable or disable SSL, you do not need to restart the server, as the server will automatically restart itself when you save changes in the Update SSL utility.

Enabling SSL on the Vocera Voice Server affects how Vocera Messaging Platform and clients connect to the server. If you enable SSL, there is additional configuration required to allow Vocera Messaging Platform and clients to connect to the Vocera Voice Server. For details, see Vocera Messaging Platform Administration Guide.

Important: If you are changing the SSL configuration on a Vocera Voice Server cluster, you should update the standby nodes before updating the active node. Update one standby node at a time. After you restart the server and the Vocera Control Panel finishes starting, wait until the status indicator displays the Standby status and a blue icon before updating the next standby node. When all the standby nodes have been updated, update the SSL configuration on the active node of the cluster. When you restart the active node, it will automatically failover to a standby node, causing only a brief outage.

To enable or disable SSL:

  1. Launch the Update SSL utility using either of two methods:
    1. Run [vocera_drive]:\vocera\reports\tools\ConnectorConfig.exe
    2. Use the Update SSL and Connector settings shortcut located from the Windows Start Menu.
    The Update Tomcat Settings dialog displays.
  2. In the Update Tomcat Setting dialog, select the checkbox next to Enable SSL or uncheck the box to disable SSL.
  3. Click Apply Changes.

    When you click Apply Changes, Apache 2.4 and Tomcat 9 services are stopped, the necessary registry entries and shortcuts are updated, and Apache 2.4 and Tomcat 9 services are restarted.

  4. If you have a cluster installation, follow the previous steps to enable or disable SSL on every other machine in the cluster.
    Tip: Make sure you update the active node last.
  5. If you change the SSL settings for Vocera Voice Server and also have Vocera Messaging Platform, make sure the VMP Server is properly configured to connect with the Vocera Voice Server. In the VMP Administrator, reconfigure options under System Options > Integrations > Vocera Voice, and then restart the server. See the Vocera Messaging Platform Administration Guide for details.
All changes made by the Update SSL utility is saved to a log file named ConnectorConfig_5_2.log in the [SystemDrive]\InstallLogs-Vocera directory.