Changing the HTTP Port Number for Spectrum Spatial

The HTTP port is used to access all Spectrum web services, whether via REST or SOAP, and for the Welcome page, sample apps and Spatial Manager.

After Spectrumâ„¢ Technology Platform is installed, you can change the existing port settings that were assigned during installation by manually editing the global, startup, and individual service configuration files. There are several reasons you may need to change the port number:

Note: This task is only for experienced administrators who have application server experience changing port numbers, as network port conflicts can result in module components failing to start. One indication that a component has failed to start is if it does not appear in the Management Console. To troubleshoot the problem, look at the Spectrum Server wrapper log. This log shows which port is causing the problem. You can find the Spectrum Server wrapper log in: <install folder>\server\app\repository\logs\wrapper.log.

To make Spectrum run under the new HTTP port, a number of entries in properties and configuration files need to be changed. To change the service configurations, you must have WebDAV file editing enabled on the server. WebDAV is available on Windows and Linux servers but may need to be installed.

To change the port number:

  1. In spectrum-container.properties change the value of spectrum.http.port to the new port number. This file is located in <install_folder>/server/app/conf.
  2. In the java.properties file change all the repository.host ports and image.webapp.url. This file is located in <install_folder>/server/modules/spatial.
  3. Using WebDAV editing while Spectrum is running, open the repository contents as a drive letter and edit the service configurations that are located in the Configuration folder at the root of the repository. Change the old port number to the new one in each service configuration. There are one or two references to the port number in each configuration.

    If you are relocating the server so it can use a different port, it is likely that Spectrum server is not running. You will not be able to edit the service configuration files until the server is running. You will need to start the server, edit the configurations and restart the server again.

    Note: Be sure you are editing what is in the Configuration folder in the repository, not in the Configuration folder in your Spectrum installation.
  4. Restart Spectrum so the ports and property changes can take effect.