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:
- The silent installer for Spectrum™ Technology Platform does not allow you to
specify the port; it can only be specified after installation.
- A port conflict occurs after installation.
- You want to try out a new version of Spectrum without removing your old one.
Since you cannot install them both, you can turn off the existing version and
install a Spectrum image that uses a different port.
- You need a proxy on port 8080 but have a limited number of ports to expose
externally, so you would like to move Spectrum without re-creating all your
settings and data flows.
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
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:
In spectrum-container.properties change the value of
spectrum.http.port to the new port number. This file is located
In the java.properties file change all the repository.host
ports and image.webapp.url. This file is located in
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.
Restart Spectrum so the ports and property changes can take effect.