Spectrum Spatial Analyst Version 4.0 Installation Guide for Linux This guide explains how to install the Spectrum Spatial Analyst on a Unix server (Ubuntu). The topics covered in this guide are: Contents: UNITED STATES pitneybowes.com/us Technical Support: support.pb.com CANADA pitneybowes.com/ca Technical Support: support.pb.com Package Content.........................................2 Spectrum Spatial Analyst Documentation....................2 Supported Languages.....................................2 System Requirements.....................................3 Oracle Java JDK..........................................3 Configuring Connect and Adminconsole.....................5 EUROPE/UNITED KINGDOM pitneybowes.com/uk Technical Support: pitneybowes.co.uk/software/support ASIA PACIFIC/AUSTRALIA pitneybowes.com/au Technical Support: pbinsight.com.au/support 2015 Pitney Bowes Software Inc.
Package Content Package Content The Package (tar) of Spectrum Spatial Analyst for Linux contains following items: 1. Installation Guide 2. Application wars (adminconsole.war, connect.war, index-search.war) 3. Customer configurations folder You need to extract it to a location on the system. 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 Map Uploader 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) fr (French) nl (Dutch) pt (Portuguese es (Spanish) ja (Japanese) 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. 2 Spectrum Spatial Analyst 4.0
Getting Started For example: https://<server>:<port>/connect/analyst/?lang=en_gb System Requirements Pre-requisites It is assumed that you have Ubuntu 14.04 and 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 Server Requirements Spectrum Spatial Analyst requires Spectrum Technology Platform 9.3 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 64-bit The server requires a 64-bit system. 32-bit systems are not supported. Disk Space Spectrum Spatial Analyst will use 1GB of system space for installer package and installation. 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 including Windows. Additional Requirements Administrator rights Oracle Java JDK Downloading Oracle Java JDK Using your web browser, go to the Oracle Java SE (Standard Edition) website and click on "Java SE 7u71/72" link. JDK: Java Development Kit includes a complete JRE plus tools for developing, debugging, and monitoring Java applications. Installation Guide for Linux 3
Oracle Java JDK Server JRE: Java Runtime Environment for deploying Java applications on servers. Includes tools for JVM monitoring and tools commonly required for server applications. Now accept the license agreement and click on "jdk-7u71-linux-x64.tar.gz" link to download the JDK7 for Linux. Alternatively you can use wget to download the archive into your server: wget --header "Cookie: oraclelicense=accept-securebackup-cookie" http://download.oracle.com/otn-pub/java/jdk/7u71-b14/jdk-7u71-linux-x64.tar.gz Oracle does not allow downloads without accepting their license, therefore we need to modify the header of our request. Alternatively, you can just download the compressed file using your browser and manually upload it using a SFTP/FTP client. Installing Oracle Java JDK You need sudo privileges: sudo su Create a directory for your JDK installation. Some preferred and popular locations are /opt/jdk, /usr/lib/jvm/ and /usr/share/jdk: mkdir /opt/jdk And extract Java files into the above created directory: tar -zxvf jdk-7u71-linux-x64.tar.gz -C /opt/jdk Verify that the file has been extracted into the installation directory. ls /opt/jdk Setting Oracle JDK as the default JVM To set default JVM in your machine run: update-alternatives --install /usr/bin/java java /opt/jdk/ java-7-oracle/bin/java 100 And update-alternatives --install /usr/bin/javac javac /opt/jdk/jdk.new.version/bin/ javac 110* *Make sure the highest priority is used for updating, for more help refer to main help pages. Verify that java has been successfully configured by running: update-alternatives --display java update-alternatives --display javac The output should look like this: java - auto mode link currently points to /opt/jdk/java-7-oracle/bin/java 4 Spectrum Spatial Analyst 4.0
Getting Started Current 'best' version is /opt/jdk/java-7-oracle/bin/java javac - auto mode link currently points to /opt/jdk/java-7-oracle/bin/javac /opt/jdk/java-7-oracle/bin/javac - priority 100 Current 'best' version is /opt/jdk/java-7-oracle/bin/javac Another easy way to check your installation is: java -version The output should look like this: java version "1.7.0_67" Java(TM) SE Runtime Environment (build 1.7.0_67-b01) Java HotSpot(TM) 64-Bit Server VM (build 24.65-b04, mixed mode) Updating Java (optional) To update Java, simply download an updated version from Oracle's website and extract it under the/opt/jdk directory, then set it up as the default JVM with a higher priority number (in this case 110): update-alternatives --install /usr/bin/java java /opt/jdk/jdk.new.version/bin/java 110 update-alternatives --install /usr/bin/javac javac /opt/jdk/jdk.new.version/bin/ javac 110* You can keep the old version or delete it: update-alternatives --remove java /opt/jdk/jdk.old.version/bin/java update-alternatives --remove javac /opt/jdk/jdk.old.version/bin/javac rm -rf /opt/jdk/jdk.old.version Configuring Connect and Adminconsole Configuring Dstratus.customer.config.dir Files 1. Create a config directory and copy customerconfigurations folder here: mkdir /analyst/config/ 2. Edit _global_/shared.properties file to change the index-search wsdl URL indexsearch.singlelinesearch.url=http://<analyst-server-ip-address>:8030/indexsearch/ SingleLineAddressService indexsearch.singlelinesearch.wsdl=http://<analyst-server-ip-address>:8030/indexsearch/ SingleLineAddressService?wsdl Installation Guide for Linux 5
Configuring Connect and Adminconsole 3. Edit _global_/shared.properties to change the Spectrum Spatial Server instance spatialserver.accountmanager.url=http://<spectrum-server-ip-address>:8080/managers/ AccountManagerService spatialserver.accountmanager.wsdl=http://<spectrum-server-ip-address>:8080/managers/ AccountManagerService?wsdl spatialserver.mapping.url=http://<spectrum-server-ip-address>:8080/soap/ MappingService spatialserver.mapping.wsdl=http://<spectrum-server-ip-address>:8080/soap/ MappingService?wsdl spatialserver.feature.url=http://<spectrum-server-ip-address>:8080/soap/ FeatureService spatialserver.feature.wsdl=http://<spectrum-server-ip-address>:8080/soap/ FeatureService?wsdl spatialserver.geometry.url=http://<spectrum-server-ip-address>:8080/soap/ GeometryService spatialserver.geometry.wsdl=http://<spectrum-server-ip-address>:8080/soap/ GeometryService?wsdl spatialserver.mapping-tiles.url=http://<spectrum-server-ip-address>:8080/soap/ MappingService spatialserver.mapping-tiles.wsdl=http://<spectrum-server-ip-address>:8080/soap/ MappingService?wsdl spatialserver.usermanagement.url=http://<spectrum-server-ip-address>:8080/soap/ UserManagementService spatialserver.usermanagement.wsdl=http://<spectrum-server-ip-address>:8080/soap/ UserManagementService?wsdl spatialserver.namedresource.url=http://<spectrum-server-ip-address>:8080/soap/ NamedResourceService spatialserver.namedresource.wsdl=http://<spectrum-server-ip-address>:8080/soap/ NamedResourceService?wsdl 4. Edit <tenant>/locateconfig/configuration.xml file to change the index directory paths accordingly. <pending-directory>/<config.dir.path>/<tenant>/lucene/indexes/<gazetteer name>/ pending</pending-directory> <active-directory>/<config.dir.path>/<tenant>/lucene/indexes/<gazetteer name>/ active</active-directory> Configuring Tomcat for Index-search, Connect and Adminconsole 1. Create directories for index-search, connect and adminconsole. mkdir /analyst/connect/ mkdir /analyst/index-search/ mkdir /analyst/adminconsole/ 2. Copy tomcat in all 3 directories i.e. connect, index-search and adminconsole sudo cp -r apache-tomcat-7.0.54 /analyst/connect/ sudo cp -r apache-tomcat-7.0.54 /analyst/index-search/ sudo cp -r apache-tomcat-7.0.54 /analyst/adminconsole/ 3. Edit conf/server.xml of each to change the connector port number and put URIEncoding="UTF-8" Connect 8010 Adminconsole 8020 Index-search 8030 6 Spectrum Spatial Analyst 4.0
Getting Started For example, <Connector port="8010" protocol="http/1.1" connectiontimeout="20000" redirectport="8443" /> Also, please ensure that we change the default ports for all the three containers to use a non-conflicting value. For example, for adminconsole onf/server.xml <Server port="8105" shutdown="shutdown and <Connector port="8109" protocol="ajp/1.3" redirectport="8443" /> 4. Put JAVA_OPTS environment variable in bin/setenv.sh for each export JAVA_OPTS="-Dstratus.customer.config.dir=<config.dir> -Dfile.encoding=UTF-8 - XX:PermSize=128m -XX:MaxPermSize=256m -Xms1024M -Xmx2048M" Where config.dir is the directory created in "Configure Dstratus.customer.config.dir files" section for configuration files. For example, config.dir = /analyst/config/ Deploy Wars 1. Copy connect.war, adminconsole.war and index-search.war in their respective "webapps" directories. sudo cp index-search.war /analyst/locate/tomcat-7.0.55/webapps sudo cp connect.war /analyst/connect/tomcat-7.0.55/webapps sudo cp adminconsole.war /analyst/adminconsole/tomcat-7.0.55/webapps 2. Give execute permissions to war files if not already given. sudo chmod 644 index-search.war sudo chmod 644 connect.war sudo chmod 644 adminconsole.war Start Tomcat Servers 1. Start tomcat for index-search cd /analyst/locate/tomcat-7.0.55/bin/ sudo./startup.sh To stop sudo./shutdown.sh 2. Start tomcat for connect cd /analyst/connect/tomcat-7.0.55/bin/ sudo./startup.sh Installation Guide for Linux 7
Configuring Connect and Adminconsole To stop sudo./shutdown.sh 3. Start tomcat for adminconsole cd /analyst/adminconsole/tomcat-7.0.55/bin/ To Stop sudo./shutdown.sh 4. Now, check the respective URLs in browser. http://<analyst-server-ip-address>:8020/adminconsole/<tenant>/ http://<analyst-server-ip-address>:8010/connect/<tenant>/ 8 Spectrum Spatial Analyst 4.0