Installing Tolomeo

Introduction

Tolomeo is a java map client webapp. It can be used both as a standalone map client, or can be embedded within other apps.

Tolomeo shall be installed in a tomcat instance on its own, in order to decouple it from other installed webapps (i.e. GeoNetwork, Solr).

A new Tolomeo instance is optional in the OpenDataNetwork architecture, since a node may want to reuse existing Tolomeo instances.

It is expected that the base system has already been properly installed and configured as described in Tomcat Installation.

In such document there are information about how to install some required base components, such as the JDK and Apache Tomcat.

Installing Tolomeo 3.7.1

We’re going to install Tolomeo Catalina base in /var/lib/tomcat/tolomeo.

Make sure you already:

• created the tomcat user (Create tomcat user)
• installed tomcat (Install Tomcat files)
• created the base catalina template (Create base template)

Install

Download Tolomeo (it’s a 90MB .tgz file) and unzip it:

cd /root/download
wget http://tolomeogis.comune.prato.it/download/tolomeo/3.7.1/tolomeo-3.7.1-war.zip
unzip tolomeo-3.7.1-war.zip

Create catalina base directory for Tolomeo:

cp -a /var/lib/tomcat/base/  /var/lib/tomcat/tolomeo

Copy .war file

cp -av /root/download/tolomeo.war /var/lib/tomcat/tolomeo/webapps

Configuration

Tolomeo needs a config directory to start. You can use the sample config in the .war file.

You can have tomcat extract the war file for you, but it needs to be run first, and as a first run it will end with an error. Let’s unpack the .war file ourselves:

cd /var/lib/tomcat/tolomeo/webapps
mkdir tolomeo
cd tolomeo
jar -xzvf ../tolomeo.war
cd ../..
cp -a  webapps/tolomeo/WEB-INF/config .

Tolomeo needs to know where such file is.

Edit the file webapps/tolomeo/WEB-INF/web.xml and add the element:

<context-param>
   <param-name>configFilePath</param-name>
   <param-value>/var/lib/tomcat/tolomeo/config/tolomeo.properties</param-value>
</context-param>

Other configuration

Should you need to change the memory setting for the Tolomeo tomcat instance, edit (create if necessary) the file /var/lib/tomcat/tolomeo/bin/setenv.sh and add the line

export JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx800m -XX:MaxPermSize=256m"

Then make setenv.sh executable:

chmod +x /var/lib/tomcat/tolomeo/bin/setenv.sh

Edit server.xml

We have to setup ports for Tolomeo, also according to the other tomcat instances running on the same machine.

According to Installed applications we will change the tomcat ports in file /var/lib/tomcat/tolomeo/conf/server.xml in this way:

• 8003 for commands to catalina instance
• 8082 for the HTTP connection
• 8010 for the AJP connection

Webapp directory ownership

Set the ownership of the tolomeo/ related directories to user tomcat

chown tomcat: -R /var/lib/tomcat/tolomeo

Starting and stopping Tolomeo

Autostart

The standard Systemd way for setting Tolomeo as an autostarting service is:

systemctl enable tomcat@tolomeo

Commands

Once Tolomeo has been installed, you can start it with:

systemctl start  tomcat@tolomeo

These are the commands for starting, stopping and querying Tolomeo status:

• systemctl start  tomcat@tolomeo
• systemctl stop   tomcat@tolomeo
• systemctl status tomcat@tolomeo

Apache httpd configuration

As root, create the file /etc/httpd/conf.d/91-tolomeo.conf and add the following content:

ProxyPass        /tolomeo   ajp://localhost:8010/tolomeo
ProxyPassReverse /tolomeo   ajp://localhost:8010/tolomeo

and reload the configuration

systemctl reload httpd