Installing a New Server


  • 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. If you are installing Spectrum™ Technology Platform on Red Hat Enterprise Linux 6 or 7, Oracle Linux 6 or 7, or CentOS 6 or 7, you must install the 32-bit glibc runtimes before installing Spectrum™ Technology Platform. There are two ways to install the 32-bit glibc runtimes:
    • Using your local yum repository run this command:

      yum install -y libstdc++.i686 libstdc++-devel.i686 libstdc++-devel.x86_64 zlib.i686 zlib.x86_64

    • Perform an rpm install from media. Install the following:
      • libstdc++.i686
      • libstdc++-devel.i686
      • libstdc++-devel.x86_64
      • zlib.i686
      • zlib.x86_64
  2. Download Spectrum™ Technology Platform using the download instructions contained in your welcome email or the release announcement email.
  3. Extract the downloaded file to a temporary location on the server where you want to install Spectrum™ Technology Platform.
  4. Change the directory to the location of
  5. Be sure you have permission to run the files by typing the following command:
    chmod a+x
  6. Run
  7. The installer guides you through the installation process. Note the following:
    The installer guides you through the installation process. Note the following:
    • 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 is selected.
      • If you are installing the SAP Module you must install Advanced Matching Module. The Enterprise Tax Module is optional. The Universal Addressing Module is only required if you will be using the SAP module service SAPValidateAddressWithCandidates.
    • 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 Spectrum™ Technology Platform see Network Ports.
  8. 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

  9. To ensure that Spectrum™ Technology Platform has started, open the log file <Spectrum Installation Location>/server/app/repository/logs/wrapper.log and look for this message:
    INFO  [Server] Pitney Bowes 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.
  10. Apply all the updates for the platform and any modules you have installed. For a listing of updates, see the Update Summary on the Pitney Bowes support website.