Change ports for JazzSM post-installation

Answer

1) Stop the distribution if it is running, back it up - or at the very least, create backups of the following files:


<JAZZ_INSTALL_DIR>/profile/properties/portdef.props
<JAZZ_INSTALL_DIR>/profile/config/cells/JazzSMNode01Cell/nodes/JazzSMNode01/serverindex.xml
<JAZZ_INSTALL_DIR>/profile/config/cells/JazzSMNode01Cell/virtualhosts.xml
<JAZZ_INSTALL_DIR>/profile/config/cells/JazzSMNode01Cell/applications/isc.ear/deployments/isc/com.ibm.tivoli.rest.war/WEB-INF/web.xml
<JAZZ_INSTALL_DIR>/profile/installedApps/JazzSMNode01Cell/isc.ear/com.ibm.tivoli.rest.war/WEB-INF/web.xml
<JAZZ_INSTALL_DIR>/ui/properties/ActiveMQBroker.properties
../omnibus_webgui/waapi/etc/waapi.init

2) <JAZZ_INSTALL_DIR>/profile/properties/portdef.props

The portdef.props file contains the connection port values the server is currently using.
Edit it and change the values as required.

For example:

WC_defaulthost_secure=19319
WC_defaulthost=19310
WC_adminhost_secure=19311
WC_adminhost=19315
BOOTSTRAP_ADDRESS=19312
SOAP_CONNECTOR_ADDRESS=16313
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=19321
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=19323
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=19322
ORB_LISTENER_ADDRESS=19320
DCS_UNICAST_ADDRESS=19318
IPC_CONNECTOR_ADDRESS=19314
REST_NOTIFICATION_PORT=19324

3) <JAZZ_INSTALL_DIR>/profile/config/cells/JazzSMNode01Cell/nodes/JazzSMNode01/serverindex.xml

Edit the EndPoint port entries in serverindex.xml to match the values set above.

4) <JAZZ_INSTALL_DIR>/profile/config/cells/JazzSMNode01Cell/virtualhosts.xml

Edit virtualhosts.xml and change the port numbers for the HostAlias entries

5) In the following files, grep for '16' and change the relevant port assignments

<JAZZ_INSTALL_DIR>/profile/config/cells/JazzSMNode01Cell/applications/isc.ear/deployments/isc/com.ibm.tivoli.rest.war/WEB-INF/web.xml
<JAZZ_INSTALL_DIR>/profile/installedApps/JazzSMNode01Cell/isc.ear/com.ibm.tivoli.rest.war/WEB-INF/web.xml
<JAZZ_INSTALL_DIR>/ui/properties/ActiveMQBroker.properties


For WebGUI:

5) ../omnibus_webgui/waapi/etc/waapi.init

Edit waapi.init and change the values for waapi.port and waapi.secureport.

6) Restart the server and you should be able to connect using the equivalent port you set for the WC_defaulthost value

You can run netstat -an to verify none of the old values are in use. If you find any, the following command, run in the <JAZZ_INSTALL_DIR> for the value in question will show which of the files above still need to be altered.

In the below example, the default REST_NOTIFICATION_PORT value 16324 is used:

Note: There are other files where the installation values are recorded, however the ones listed above are the ones referenced during server operation.