Location Intelligence

Spectrum Spatial Analyst

™

Version 12.1

Installation Guide for

Linux
The topics covered in this guide are:

Contents:

Package Content 2
Spectrum Spatial Analyst Documentation 2
Supported Languages 2
System Requirements 3
Installation 4
Uninstalling Spectrum Spatial Analyst 16
Spectrum Spatial Analyst Services 17
Frequently Asked Questions 18
 Getting Started

Package Content

The package of Spectrum Spatial Analyst for Linux contains following items:
1. Installation Guide
2. Application (Analyst.bin)

Spectrum Spatial Analyst Documentation

After installation, all the documentation for Spectrum Spatial Analyst can be accessed from Home
tab of Spectrum Spatial Analyst Administration Console.
The following documents are available with this release of Spectrum Spatial Analyst:
• Spectrum Spatial Analyst Installation Guide for Windows
• Spectrum Spatial Analyst Installation Guide for Linux
• Spectrum Spatial Analyst Administration Guide
• Spectrum Spatial Analyst User's Guide
• Spectrum Spatial Analyst Release Notes
You can also found Spectrum™ Spatial Analyst documents at support.pb.com.

Supported Languages

Spectrum Spatial Analyst supports the following languages:

• cy (Welsh) (not for Admin Console)
• da (Danish)
• de (German)
• en (English- default)
• en_AU (English- Australian)
• en_GB (English- British)
• fi (Finnish)

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 2

 Getting Started

• fr (French)
• nl (Dutch)
• pt (Portuguese)
• es (Spanish)
• ja (Japanese)
• it (Italian)
• tr (Turkish)
To launch either the Spectrum Spatial Analyst Admin Console or Spectrum Spatial Analyst in one
of these languages, add a “lang” parameter to the end of the URL.

https://<server>:<port>/connect/analyst/?lang=en-gb

For example, http://UbUntU-x64-14:8010/connect/analyst/?lang=en-gb

System Requirements

Server Requirements

Spectrum Spatial Analyst requires Spectrum Technology Platform 12.1 with the Location Intelligence
Module to be installed and accessible to the server on which Spectrum Spatial Analyst is being
installed. Analyst can also be deployed to the same server as Spectrum if desired.
The following are the server requirements:
Operating Systems
• Linux Ubuntu 14 and 15
• CentOS 7.0
• RHEL 6.5 and 7.1
64-bit
The server requires a 64-bit system.
Note: 32-bit systems are not supported.

Disk Space
Spectrum Spatial Analyst will use 1GB of system space for installer package and installation.

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 3

 Getting Started

Memory
Spectrum Spatial Analyst applications will use minimum of 3GB RAM. Please make sure the server
on which Analyst is installed has enough RAM to run other processes.
Additional Requirements
Java 8 Oracle JDK 8u102
Set JAVA_HOME environment variable
Append $JAVA_HOME/bin to PATH variable.
Administrator rights

Pre-requisites

It is assumed that you have root privileges (via sudo) to complete the configuration.
You will need to know whether you are running a 32 bit or a 64 bit OS:
uname -m
• x86_64: 64 bit kernel
• i686: 32 bit kernel

Note: The installer for Spectrum Spatial Analyst 12.1 will only upgrade from versions 12.0 and
12.0.1 Customers who are migrating from previous versions of Analyst will need to upgrade
to 12.0 first, and also ensure that they run the label migration utility that was made available
with Spectrum Spatial Analyst 12.0.
For more information about installation of Spectrum refer to:
• Installation Guide for Linux

Installation

This section explains you the steps to install he Spectrum Spatial Analyst on a Unix server (Ubuntu)
You can install Spectrum Spatial Analyst in any one of the following two ways:
1. Console
2. Installation Wizard

Note- Only root user can install Spectrum Spatial Analyst application.

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 4

 Getting Started

Installation through Console

To install Spectrum Spatial Analyst through console on RHEL, CentOS or Ubuntu, follow the steps
given below:
1. Download Spectrum Spatial Analyst using the download instructions in your welcome letter.
2. Extract the downloaded file to a temporary location (for example, /analyst) on the server where
you want to install Spectrum Spatial Analyst.
3. Run the following command from the terminal window:

sudo ./Analyst.bin -i console

where, Analyst.bin is the file name of the installer.

4. It will prompt to install, press Enter to continue. Enter your administration password to proceed.
5. Accept the Terms & Conditions.
6. Enter the desired location to install Analyst or press Enter to accept the default path (/root in this
case).
7. Enter the type of Analyst Access Mode and press Enter.
8. Press 1 for Guest and Secured or 2 for Secured Only.
9. If you choose Guest&Secured mode then enter the Guest user name and Password for guest
user.
10. Specify the Endpoint URL and press Enter (http://<machine_name>:port)
11. Specify the port number for Analyst Locate or press Enter to accept the default port (8030
in this case).
12. Specify the port number for Analyst Admin or press Enter to accept the default port (8020 in
this case).
13. Specify the port number for "Analyst Connect" or press Enter to accept the default port (8010
in this case).
14. Specify the max memory settings for AnalystLocate or press Enter to accept the default
memory (1024 in this case).
15. Specify the max memory settings for AnalystAdmin or press Enter to accept the default memory
(1024 in this case).
16. Specify the max memory settings for AnalystConnect or press Enter to accept the default
memory (1024 in this case).
17. The pre-installation summary will be displayed. Please review the information carefully.
18. The installation process starts. The installer installs three different Tomcat (Tomcat 7.x) on three
different ports. All three will be installed on the same machine. The ports can be configured during
installation process.
Congratulations! The Spectrum Spatial Analyst is installed in your machine and is ready to use.

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 5

 Getting Started

Installation through Wizard

To install Spectrum Spatial Analyst through wizard on RHEL, CentOS or Ubuntu, follow the steps
given below:
1. Download Spectrum Spatial Analyst using the download instructions contained in your welcome
letter.
2. Extract the downloaded file to a temporary location (for example, /analyst) on the server where
you want to install Spectrum Spatial Analyst.
3. Run the following command from the terminal window:

sudo ./Analyst.bin

where, Analyst.bin is the file name of the installer.

4. Enter your administration password to proceed.

The Spectrum Spatial Analyst- Introduction install wizard appears and walks you through the
installation process.
Figure 1: Spectrum Spatial Analyst- Introduction

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 6

 Getting Started

5. Click Next. The License Agreement dialog box appears.

Figure 2: Spectrum Spatial Analyst- License Agreement

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 7

 Getting Started

6. Select I accept the terms of the License Agreement and click Next.
The Destination Folder dialog box appears.
Figure 3: Spectrum Spatial Analyst- Destination Folder

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 8

 Getting Started

7. Click Choose button to select a different directory or click Next to install in the default folder.
The Analyst Access Mode appears.
Figure 4: Spectrum Spatial Analyst- Analyst Access Mode

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 9

 Getting Started

8. Choose whether you wish to enable Guest and Secured or Secured Only access for Spectrum
Spatial Analyst application.
a) Guest and Secured- In Guest and Secured mode Analyst will use the credentials of the guest
user that you have provided in Guest User name and Guest Password text boxes. It will
allow anyone to see data which that user’s role can read without logging in. You need to create
this role in Spectrum as AnalystGuestRole by using Spectrum Management Console.
b) Secured Only- Secured Only mode requires login. Secured users can subsequently click
sign-in to see secured data.
9. If you choose Guest&Secured mode then enter the Guest user name and Password for guest
user.
Note: For details on how guest access works and how to add this user to Spectrum and Analyst
manually, refer to Spectrum Spatial Analyst Administration Guide.

10. Click Next.

The Web Service Information dialog box appears.
Figure 5: Spectrum Spatial Analyst- Web Service Information

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 10

 Getting Started

11. Specify the endpoint URL of Spectrum Spatial Web Service.

12. Click Next.
The Port Configuration dialog box appears.
Figure 6: Spectrum Spatial Analyst- Port Configuration

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 11

 Getting Started

13. Enter the port numbers under the Port configuration section. The default values for Analyst
Locate, Analyst Admin and Analyst Connect are provided.
Note: Please ensure that the chosen connector ports above are not used on your server prior
to installation. Also note that the Analyst installer will use 3 additional ports for the Tomcat
shutdown, Redirect and AJP ports. The Shutdown port will always be the chosen port
plus 1 for shutdown, plus 2 for Redirect and plus 3 for AJP (hence in the case of 8010,
all 4 ports 8010, 8011, 8012 and 8013 are used).

14. Click Next.

The Memory Settings dialog box appears.
Figure 7: Spectrum Spatial Analyst- Memory Settings

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 12

 Getting Started

15. Specify the Max memory settings in MB. The default values for Analyst Locate, Analyst Admin
and Analyst Connect are provided.
Note: You can edit Max Memory settings later by navigating to the Tomcat installation folder:
• AnalystAdmin

<install directory>/analyst/adminconsole/bin/setenv.sh

• AnalystConnect

<install directory>/analyst/connect/bin/setenv.sh

• AnalystLocate

<install directory>/analyst/index-search/bin/setenv.sh

16. Click Next.

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 13

 Getting Started

The Pre-Installation Summary dialog box appears. Please review the information before going
to next step.
Figure 8: Spectrum Spatial Analyst- Pre-Installation Summary

17. Click Install to begin the installation process.

The Installing dialog box appears and shows the installation progress.
The installer installs three different Tomcat (Tomcat 7.x) on three different ports. All three will be
installed on the same machine. The ports can be configured during installation process.
Figure 9: Spectrum Spatial Analyst- Installing

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 14

 Getting Started

18. Click Done to exit the Spectrum Spatial Analyst installation wizard.
Figure 10: Spectrum Spatial Analyst- Install Complete

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 15

 Getting Started

Congratulations! The Spectrum Spatial Analyst is installed in your machine and is ready to use.

Uninstalling Spectrum Spatial Analyst

This section explains how to uninstall Spectrum Spatial Analyst.

Before uninstalling any product, back up any files you may need in the future.
Uninstall via Wizard
To uninstall Spectrum Spatial Analyst via wizard move to the location where installer is located.
1. Run the following command from the terminal window:

sudo ./Analyst.bin

where, Analyst.bin is the file name of the installer.

This command will bring up the Configure Spectrum Spatial Analyst dialog box. Uninstall
Analyst from your machine.

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 16

 Getting Started

2. Select Uninstall Product option and click Next button. The uninstallation process starts and
removes Spectrum Spatial Analyst from your machine.
Note: While uninstalling, the installer will create a back-up of customer configurations.

Uninstall via Console

To uninstall Spectrum Spatial Analyst, run the following command from the terminal window
1. Ensure you are a super user sudo –s
2. Navigate to root and enter:

cd /root

3. List folders by using command

ls -a

You will see a file Change Spectrum Spatial Analyst Installation)

4. Run the Uninstaller by entering following command

./Change\ Spectrum\ Spatial\ Analyst\ Installation

Spectrum Spatial Analyst Services

This section describes about the services available after successful installation.
After successful installation, there are three services available which can be seen by running the
following commands from terminal window:

sudo ps -ef | grep tomcat

You can browse to the following Spectrum Spatial Analyst web applications:
• Spectrum Spatial Analyst Administration Console-
http://<server>:<port>/adminconsole/analyst

For example, http://UbUntU-x64-14:8020/adminconsole/analyst/

• Spectrum Spatial Analyst- http://<server>:<port>/connect/analyst

For example, http://UbUntU-x64-14:8010/connect/analyst/

You can sign in using the built-in Spectrum account named "admin" (where server and port
number are the values you have specified during the installation).

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 17

 Getting Started

Frequently Asked Questions

This section helps you to solve issues you may encounter while working on Spectrum Spatial Analyst.

How to validate Tomcat Services in SSA?

This section validates if tomcat services are up and running in Spectrum Spatial Analyst.
You can validate if the services are running by using-

netstat –peanut|grep 8010

This is a port specific to the SSA end user application Analyst Connect and if returns values
you can be sure it is running.

tcp6 0 0 :::8010 :::* LISTEN 0 330448 29941/java

To start a service you use browse to the folder /analyst/connect/bin

sudo ./catalina.sh --help

It would show you all possible options please note it is double hyphen.

sudo ./catalina.sh stop

This would stop the service.

sudo ./catalina.sh start

This would start the service.

Note: You can repeat the process for the SSA Admin Console and locate (aka index-search)
services. Also, please ensure that the locate service is always the first service while starting.

Note that he SSA Admin Console service is on port 8020 and the locate service on port
8030.

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 18

 Getting Started

How to install Java for SSA?

To install JAVA, follow the steps given below:

sudo add-apt-repository ppa:webupd8team/java

sudo apt-get update
sudo apt-get install oracle-java8-installer

Setting Java home variable for SSA

Set the below commands from the terminal window /etc/bash.bashrc

JAVA_ROOT=/usr/lib/jvm/java-8-oracle
export JAVA_ROOT

JAVA_HOME=$JAVA_ROOT
export JAVA_HOME

# PATH must be set to point to the JDK area

PATH=$JAVA_ROOT/bin:$PATH
export PATH

update-alternatives --install /usr/bin/java java

/usr/lib/jvm/java-8-oracle/bin/java 100
update-alternatives --install /usr/bin/javac javac
/usr/lib/jvm/java-8-oracle/bin/javac 100

and run the following command from the same terminal-

source /etc/bash.bashrc

How to start SSA Services?

To start SSA service, follow the steps given below:

Start tomcat for locate (index-search) service

cd /analyst/index-search/bin/
sudo ./startup.sh

Start tomcat for the SSA end user application Analyst Connect

cd /analyst/connect/bin/
sudo ./startup.sh

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 19

 Getting Started

Start tomcat the SSA Admin Console

cd /analyst/adminconsole/bin/
sudo ./startup.sh

Now check the respective URLs in browser-

http://<analyst-server-ip-address>:8020/adminconsole/<tenant>/
http://<analyst-server-ip-address>:8010/connect/<tenant>/

How to stop SSA services?

To stop SSA service, follow the steps given below:

Stop SSA for the locate (index-search) service

/analyst/index-search/bin/
sudo ./shutdown.sh

Stop SSA for the SSA end user application Analyst Connect

cd /analyst/connect/bin/
sudo ./shutdown.sh

Stop SSA for the SSA Admin Console

cd /analyst/adminconsole/bin/
sudo ./shutdown.sh

Spectrum™ Spatial Analyst 12.1 Installation Guide for Linux 20

3001 Summer Street
Stamford CT 06926-0700
USA

www.pitneybowes.com

© 2017 Pitney Bowes Software Inc.

All rights reserved