Sanav GC-101 Installationshandbuch PDF herunterladen (Seite 20)

6) Installing “events.war”

The "events.war" (Web-ARchive) runs in a Java Servlet container and works with the SQL DB datastore to allow

downloading selected portions of a sequence of events over the web. This can be used with web-based mapping

applications to provide near real-time tracking of a vehicle or person. The '"events.war" servlet currently supports

data retrieval in KML, XML, CSV, TXT, GPX, or JSON file formats, and can be used in mapping programs such as

Google Earth, or MS MapPoints.

6.1) Configuring the "webapp.conf" File

The default runtime configuration file "webapp.conf" includes the file "common.conf", which in-turn includes

"system.conf" and "custom.conf". For most installations, the default values specified in this file can be left as-is.

However, some items, such as your SMTP server specifications, should be configured to fit your system requirements.

Should you wish to customize the "webapp.conf" file specifically for the "events.war" servlet, copy this file to the

directory "$GTS_HOME/war/events/WEB-INF/" and modify this copy.

6.2) Compiling/Installing the "events.war" Java Servlet

To build the "events.war" file, run the Ant build command as follows:

/zzz> cd $GTS_HOME

/usr/local/OpenGTS_1.2.3> ant events

(note, the "ant all" performed above also builds the "events.war" file)

The target "events" is a wrapper for ant targets "events.compile" and "events.war". The target

"events.compile" compiles all necessary classes and configuration files into the build directory

"$GTS_HOME/build/events". The target "events.war" then creates the 'web archive' file

"$GTS_HOME/build/events.war".

Install the "events.war" file per the Apache Tomcat installation/configuration instructions. Typically, this simply

involves copying the "events.war" file to the directory "$CATALINA_HOME/webapps/.". (The above method for

deployment assumes that Tomcat is set for 'autoDeploy="true"')

6.3) Testing the Installation

Access the data stored in the SQL DB via the web with the following constructed URL:

http[s]://localhost:8080/events/<file>.{kml|xml|csv|txt|gpx|json}?

a[ccount]=<account> - the account name

&u[ser]=<user> - the user name

&p[assword]=<password> - the account/user password

&d[evice]=<device> - the device name

&g[roup]=<group> - the device group name (optional)

[&rf=<fromTime>] - optional 'from' data range.

[&rt=<toTime>] - optional 'to' data range.

[&l[imit]=<limit>] - optional 'limit' number of returned events.

Where "localhost:8080" should be replaced with the actual domain name and port used to access the Apache

Tomcat web server. [Note: above items placed in square-brackets are optional. The options placed in curly braces

indicate that one of the options within the curly braces should be selected].

OpenGTS Configuration and Installation Manual Page 20 of 60

1 2 ... 15 16 17 18 19 20 21 22 23 24 25 ... 59 60

Keine Kommentare

Sanav GC-101 Installationshandbuch Seite 20