OPENGTS

HIGH LEVEL DESIGN DOCUMENT

Author : G Praveen Kumar

Creation Date :

Last Updated :

Document Reference :

Version :

Approvals:

<Approver 1> -----------------------------------------------------------------------

<Approver 2> -----------------------------------------------------------------------

 TABLE OF CONTENTS

1. PREFACE

1.1 Purpose of this Document

1.2 Use of this Document

1.3 Overview

1.4 Basis of this Document

2. INTRODUCTION

2.1 Purpose

2.2 Scope

2.3 Definitions, Acronyms and Abbreviations

2.4 References

2.5 Overview

3. SYSTEM OVERVIEW

3.1 System Characteristics

3.2 System Architecture

4. SYSTEM CONTEXT

5. SYSTEM DESIGN

5.1 Design Method and Standards

5.2 Documentation Standards

5.3 Naming Conventions

5.4 Programming Standards

5.5 Software Developent Tools

5.6 Outstanding Issues

5.7 Decomposition Description

6. COMPONENT DESCRIPTION
DOCUMENT CONTROL

DOCUMENT SIGNOFF

DOCUMENT CHANGE RECORD

 1. PREFACE

1.1 Purpose of this Document:

This document covers High Level Design of openGTS. This document shall provide the
foundation of understanding the overall solution and become a baseline for the subsequent
design documents of openGTS.

This document describes the modules that will be delivered as first iteration openGTS. This
document can be enhanced in subsequent iterations of the project to cover the additional
solution modules

1.2 Use of this Document:

This document can be used to further configure the openGTS open source code

2. INTRODUCTION:

openGTS(Open Source GPS Tracking System) is intended to provide a generic back-end

web-based service for querying and viewing GPS related data. It is designed to operate
independently of any specific GPS Tracking device or protocol, but comes with support
of several device protocol formats such as OPENDMTP- Open Source Device
Monitoring and Tracking Protocol.

Installed the open source GPS tracker in windows

http://www.opengts.org/

Refer this site .example of open source GPS tracker.

OpenGTS path:

Server -192.168.1.81

Account Name: opengts

User Name : admin

Password : welcome

Filezila path:

cd/usr/local/OpenGTS_2.6.5

java mail support:

 Download the java mail jar file. Installed javax.mail.jar $JAVA_HOME/jre/lib/ext/ that
directory.

Apache ant tool:

Download the apache ant tool .

cd /usr/local

ln -s $CATALINA_HOME tomcat

Mysql database Provider:

Download the http://dev.mysql.com/downloads/mysql .

Installed the yum install mysql-server mysql that path.

Mysql JDBC Driver:

Download the http://dev.mysql.com/downloads/connector/j/.

Installed the yum install mysql-connector-java that path.

Installing and compiling the openGTS source:

Install the opengts source code on root user

cd /usr/local
/usr/local> su root
/usr/local# unzip /tmp/OpenGTS_2.6.5.zip
/usr/local# chown -R user:group OpenGTS_2.6.5
/usr/local# exit
/usr/local> export GTS_HOME=/usr/local/OpenGTS_2.6.5

Compiling the support GTS library files:

cd' into the OpenGTS installation directory and compile the jar files, and servlet war
files, using the supplied Ant "build.xml" script:
Testing the installation:

Testing the installation on this command

/usr/local/OpenGTS_1.2.3> bin/checkInstall.sh.
Creating the sysadmin Account:

When logging in to the "sysadmin" account a new menu 'tab' will be available, with new
web-page selections, that allow the creating of new accounts. The following command can be
used to create the "sysadmin" account.

[admin@opengts OpenGTS_2.6.5]$ bin/admin.sh Device -account=opengts -device=opengts –

create

Account Details:
Installing trackwar file:

To build the track.war file run the command

cp build/track.war $CATALINA_HOME/webapps/

validating the tables

Compling and installing the mologogo.war java servlet:

Created the mologogo war file

[root@opengts OpenGTS_2.6.5]# ant mologogo

Setting up the celltracGTS server:

Download the open-source OpenGTS

After the OpenGTS® installation is complete, the following command will download
the CelltracGTS™/Server support library "ctrac.jar", and install it in
the OpenGTS® installation folder "lib/gtsopt/"

ant ctrac.download

The following command will then create the "ctrac.war" servlet and deploy it to Tomcat

ant ctrac ctrac.deploy

When properly installed/configured, the "ctrac" DCS should generate a log file in
the OpenGTS® installation folder at the location "logs/w-ctrac.log".

This log file can be monitored to help with diagnosing configuration issues when setting up
the phone to send data to this server.
Android phone CeltracGTS App setup:

Install the CelltracGTS™/Free application on your Android phone.

Go to the settings page (press the menu button, then select "Settings") and enter the URL
of the "CelltracGTS™/Server" service on your server. The URL will be similar to the
following

http://DOMAIN:PORT/ctrac?

http://192.168.1.81:8080/track?
Make a note of the value displayed in the "Mobile ID" field at the top of the Settings page. This
value typically represents the phone IMEI#, or Android serial#, and will be used to identify the
phone to the server.

OpenGTS Account Setup

CelltracGTS™/Free application running on your phone

Log into this account and create a new Device record. For this example we will use the id
"myphone". Edit this device/phone record and enter the "Unique ID" as in the following

Unique ID: ct_MOBILEID

Where "ct_" is the unique-id prefix, and MOBILEID is the "Mobile ID" which was displayed on
your phone above. Change any of the other device/phone fields as desired, then click
change/save to save the changes.
Screen shots:

Login into website:

Main page:
Vehicle information:
Edit Vehicle and mobile information:
Vehicle Map:

Issues:

Checking Server connection errors.