Installing a New Server

Prerequisites:

  • 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 execute the following command:

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

    • Perform a media-based rpm install. 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 install.sh.
  5. Be sure you have execute permission on the files by typing the following command:

    chmod a+x install.sh

  6. Run install.sh.
  7. 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. For CentOS 5, CentOS 6, Red Hat Enterprise Linux 5, and Red Hat Enterprise Linux 6, you must modify a server property in order for the server to start successfully.
    1. Open the file SpectrumLocation/server/app/conf/spectrum-container.properties in a text editor.
    2. Change the property spectrum.index.bootstrap.system_call_filter to false.
    3. Save and close the file.
  9. 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:

        ./server.start

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

        ./server.start console

  10. 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.
  11. 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.