Install OpenGTS Tracking System In Linux Mint 17



OpenGTS is first open source web based GPS based tracking system.It is used worldwide in more then 110 countries and used in thousands of vehicles. It is used for entry level fleet and equally for high level tracking systems.


Web based authentication

Each account support multiple users, each user can have its own login and password. User can access their account settings.

Customizable web interface

Look and feel of tracking website and be modified as per requirement of the user.

Operating System independent

It is an entirely java based application with used Apache tomcat for web services and mysql as database, it can be installed and configured with Linux, Mac, FreeBSD or Microsoft based Operating systems.

Reports customization

It used XML base internal reporting engine which help to generate any tracking history as and when required.

Customizable zeozones

Customized zeo forced area can be set up to provide arrival and departure reports. Each zeozone can be assign with a different name.

For more details:

Install OpenGTS


We will use mint Linux 17 for demo purpose, minimum 2 GB RAM, 5 GB storage with a dual core process will be sufficient.

Update system:

# sudo apt-get update

Install required software packages:

$ sudo apt-get install apache2 php5 mysql-server libmysql-java wget curl unzip ant

Provide mysql password during installation.


Start Mysql and apache2 services:

 $ sudo /etc/init.d/mysql start
 $ sudo /etc/init.d/apache2 start

Install openjdk:

$ sudo apt-get install openjdk-7-jdk

Download and install Apache Tomcat version 7-x-x.

$ wget -c

Extract tomcat package and copy everything to /usr/local/ directory.

$ sudo  unzip
$ sudo cp -av  apache-tomcat-7.0.65 /usr/local/

Define CATALINA_HOME environment and run the startup script.

$ export CATALINA_HOME=/usr/local/apache-tomcat-7.0.65/
$ cd /usr/local
$ sudo ln -s $CATALINA_HOME tomcat
$ cd /usr/local/apache-tomcat-7.0.65/bin
$ chmod a+x *.sh
$ ./
$ sudo  ln -s $CATALINA_HOME /usr/local/tomcat


Define JAVA_HOME environment:

 $ export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
 $ echo "export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64" >> ~/.bashrc
 $ sudo  ln -s $JAVA_HOME /usr/local/java

Configure JAVA mail setup and Java Connector:

First Download and setup mysql Java connector, extract package and copy mysql java connector to $JAVA_HOME/jre/lib/ext folder

$ cd /tmp/ && wget
$ tar -xvf mysql-connector-java-5.1.37.tar.gz
$ cd  mysql-connector-java-5.1.37
$ sudo  cp mysql-connector-java-5.1.37-bin.jar $JAVA_HOME/jre/lib/ext

Now download and configure Java mail setup and copy that downloaded .jar file to $JAVA_HOME/jre/lib/ext folder.

$ cd /tmp/ && wget
$ sudo cp javax.mail-1.5.4.jar $JAVA_HOME/jre/lib/ext/

Rename javax.mail-1.5.4.jar to javax.mail.jar:

$ mv $JAVA_HOME/jre/lib/ext/javax.mail-1.5.2.jar $JAVA_HOME/jre/lib/ext/javax.mail.jar

Download OpenGTS:

$ cd /tmp && wget

Extract package to /usr/local folder:

$ sudo unzip -d /usr/local/

Set up GTS_HOME environment:

$ export GTS_HOME=/usr/local/OpenGTS_2.6.0/
$ echo "export GTS_HOME=/usr/local/OpenGTS_2.6.0" >> ~/.bashrc
$ sudo  ln -s $GTS_HOME /usr/local/gts

Change ownership for user currently logged in before running next command:

$ sudo chown -R unixmen:sudo /usr/local/OpenGTS_2.6.0/

Now change directory to $GTS_HOME and run following command:

 && ant all

If everything goes smooth, output will be something like below.


Define database user name and password (Note that we are still in $GTS_HOME).

$  bin/ -rootUser=root -rootPass=password

Sample output:


 Run ant track  command which will create a  file named track.war,  we have to copy that file to $CATALINA_HOME/webapps folder.

$ ant track

Sample output:


$ cp $GTS_HOME/build/track.war /usr/local/apache-tomcat-7.0.65/webapps/
Before moving ahead stop and restart apache tomcat again

Open browser and type http://<ip_address>:8080/track/Track


Oops, we have not create a sysadmin account required to login the server, let us create it first.

$ cd $GTS_HOME/bin
$ ./ Account -account=unixmen -pass=unixmen -create

Sample output


Now Provide these credentials and login


A welcome screen will appear:


Now installation and configuration part is over at this stage, configure your GPS tracking devices and you can use them with Open GTS.



As per my knowledge very fewer documentations related to OpenGTS installation are available, but official documentation will be sufficient to configure it. One problem which was faced by me during installation process is that OpenGTS show error when it was configured with latest version of Apache Tomcat.


It is recommended that you should use Apache tomcat version 7.0.x for that purpose. Although this practical guide was tested in Mint Linux 17, but I believe that it will also  work with Ubuntu 14.04/15.10.

Have fun!!