Installing a New Server - spectrum_platform - 23 - 23.1

Spectrum Installation Guide for Linux

Product type
Product family
Spectrum > Spectrum Platform
Product name
Spectrum Technology Platform
Spectrum Installation Guide for Linux
Topic type
How Do I
First publish date


  • Before installing Spectrum Technology Platform, be sure to read the release notes. The release notes contains important compatibility information as well as release-specific installation notes.
  • Apply all the latest updates available for your operating system, especially those that resolve issues with Java.

To install a new server:

  1. Download Spectrum Technology Platform using the download instructions contained in your welcome email or the release announcement email.
  2. Extract the downloaded file to a temporary location on the server where you want to install Spectrum Technology Platform.
  3. Change the directory to the location of
  4. Be sure you have permission to run the files by typing the following command:
    chmod a+x
  5. Run
  6. The installer guides you through the installation process.
    • If you are setting up an environment where the configuration database is installed on a separate server choose Server only. Otherwise choose Standard installation.
    • When prompted, select the modules that you want to install.
      • Make sure that Spectrum Technology Platform Server is selected.
      • If you are installing the SAP module, you must also install Advanced Matching (Universal Name Data Normalization and Advanced Matching). Enterprise Tax is optional. Universal Addressing is only required if you will be using the SAP service SAPValidateAddressWithCandidates.
      • To use the Context Graph module, you must license and install the Neo4j Graph Database management system separately in a standalone or cluster configuration. After you complete the the Spectrum installation, configure the Context Graph Repository Configuration settings in the Spectrum Management Console to address the Neo4j server.

        For more information, see Installing Context Graph.

    • When prompted, enter the HTTP port that you want to use then press Enter. The default is 8080. For a complete listing of ports used by see Network Ports.
  7. Start the server.
    Note: If you are installing a cluster, you do not need to start the server.
    1. Change the working directory to the bin directory of where Spectrum Technology Platform is installed.

      For example:

      cd /usr/g1/tst/server/bin

    2. Source the setup file.

      For example:

      . ./setup
    3. Start the Spectrum Technology Platform server.
      • To start Spectrum Technology Platform in the background, type the following command:


      • To start Spectrum Technology Platform in the foreground, type the following command:

        ./server.start console

  8. To ensure that Spectrum Technology Platform has started, open the log file SpectrumDirectory/server/logs/spectrum-server.log and look for this message:
    INFO  [Server] Spectrum(TM) Technology Platform (Version version build) Started
    Important: Do not attempt to stop the server until after it has fully started for the first time. Stopping the server before it performs an initial startup can cause your installation to become unusable.
  9. Apply all the updates for the platform and any modules you have installed. For a listing of updates, see Spectrum Technology Platform Updates.
Note: Further module-level configurations might be required in some cases. For more information, refer to the installation section of the respective module guides.