-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathREADME.txt
196 lines (165 loc) · 9.92 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
-----------------------------------------------------------------------------------
Project: OpenGTS - Open GPS Tracking System
URL : http://www.opengts.org
File : README.txt
-----------------------------------------------------------------------------------
Notes:
- The following DCS modules are still present in the package, but have been removed
from the build "all" ant target:
icare, sipgear, aspicore, gtsdmtp, taip, gc101, mologogo, gpsmapper
These modules can be built separately as follows, should you need to use them:
ant icare sipgear aspicore gtsdmtp taip gc101 mologogo gpsmapper
- Support for the CelltracGTS/Server requires downloading/installing the library
support for the "ctrac.war" servlet. Please see the following for more information:
http://www.geotelematic.com/CelltracGTS
- Please refer to the included "OpenGTS_Config.pdf" file for all installation and
configuration information for the OpenGTS system.
- When updating to a newer version of OpenGTS, it is highly recommended that the
following command be run to update the database with the latest table/column
changes:
$ bin/dbAdmin.pl -tables=ca
Or, run the following if alternate key fields also need to be updated:
$ bin/dbAdmin.pl -tables=cak
- On Windows 7, Internet Explorer 8, if you receive the error
Error [jsMapInit:[object error]
then you may need to enable "Active Scripting" in the security tab.
- A listing of the database tables and fields can be found in the file "SCHEMA.txt"
in the OpenGTS installation diretory.
- Documentation is available online at the following link:
http://www.opengts.org/documentation.html
- This open-source version of OpenGTS includes support for the following GPS
tracking devices:
- Aspicore GSM Tracker (Nokia, Samsung, Sony Ericsson phones).
[http://www.aspicore.com]
- Astra Telematics AT240, AT110, AT210.
[http://www.gps-telematics.co.uk]
- Sanav GC-101, MT-101, and CT-24 Personal Tracker (HTTP-based protocol).
Sanav GX-101 Vehicle Tracker (HTTP-based protocol).
[http://www.sanav.com]
- V-Sun 3338 Personal Tracker.
- CelltracGTS/Free Android application
- CelltracGTS/Pro Android application
- Most TK102/TK103 devices.
- ZhongShan SIPGEAR Technology Co, Ltd.
- TAIP (Trimble ASCII Interface Protocol).
- TrackStick GPS data logger.
- "GPSMapper" capable phones.
- "NetGPS" capable devices.
Please let us know if you find any issues with this release.
-----------------------------------------------------------------------------------
Visit the following link for additional downloadable documentation and add-ons for
OpenGTS:
http://www.opengts.org/documentation.html
http://www.geotelematic.com/documentation.html
-----------------------------------------------------------------------------------
This package may contain one or more of the following source modules which contain
copyrights from their respective authors. Please review these source modules for
their copyright and license information:
war/track/js/mapstraction/mapstraction.js
war/track/js/mapstraction/mapstraction-geocode.js
war/track/js/mapstraction/labeledmarker.js
war/track/js/sorttable/sorttable.js
-----------------------------------------------------------------------------------
Contributors:
See the following link for a list of contributors:
http://www.opengts.org/info.html
-----------------------------------------------------------------------------------
Sample data:
Additional documentation for installing sample 'demo' data into the database can be
found in the "README.txt" file in the "sampleData" directory at
sampleData/README.txt
-----------------------------------------------------------------------------------
Sanav GC-101 GPS Tracking Device Support:
Additional documentation for installing and configuring the GC-101 server within
OpenGTS can be found in the "README.txt" file in the "gc101" source directory at
src/org/opengts/war/gc101/README.txt
See the following link for manufacturer's product information:
http://www.sanav.com
-----------------------------------------------------------------------------------
TAIP (Trimble ASCII Interface Protocol) Support:
Support for TAIP (Trimble ASCII Interface Protocol) is included in this release.
This server uses the raw-socket mode device communication server based on the example
'template' server. The "taip.jar" server jar file can be built with the command:
> ant taip
And can be started in the same manner that other servers are started using the
"runserver.pl" command as follows:
> $GTS_HOME/bin/runserver.pl -s taip
-----------------------------------------------------------------------------------
Updating existing Geozone table entries
(only required when upgrading from versions previous to v1.9.3):
If you have existing Geozone table entries, they will need to be updated to include
Bounding-Box information used to optimize Geozone lookups. This update process is
done automatically with the following steps:
1) Update the new Geozone bounding-box table fields:
> bin/dbAdmin.pl -tables=ca
2) For each account having Geozone entries, run the following command (replace "<accountID>"
with the appropriate account-IDs for each account which has Geozone entries):
> bin/admin.pl Geozone -account=<accountID> -list -update
The update process should now be complete.
-----------------------------------------------------------------------------------
Runtime config file property key references
(for *.conf files, such as 'default.conf', 'common.conf', 'webapp.conf, ...):
- The prefixing "#" is a comment character, indicating that the following text is for
informational purposes only, and should not be parsed. Comments must be placed on
a separate line, and must not be specified at the end of a property specification.
- Previously defined property keys may be referenced by placing them in ${...} brackets,
such as ${log.name}. Environment variables may also be referenced in this manner, as in
${GTS_HOME}, or ${CATALINA_HOME}.
- A default value may be specified for referenced property keys which have not been defined.
For instance ${OUTPUT_DIR=/tmp} would resolve to "/tmp", if the property OUTPUT_DIR is not
defined (as an environment variable, or otherwise), or will resolve to the value specified
on the OUTPUT_DIR property (or environment variable) if it is defined.
- Recursive propery key references may also be specified. For instance, the specification
${THIS_DIR=${THAT_DIR=/tmp}} will first attempt to resolve the value for "THIS_DIR", if not
found, then value of THAT_DIR will be returned. If THAT_DIR is not defined, then finally
the specification will resolve to "/tmp".
- Property reference specifications for which the property is not defined, and there is no
specified default value will resolve to the literal "${var}" string. That is, if "var"
is not defined, then ${var} will resolve to the literal string "${var}".
- Property reference specifications are only resolved at the time a property value is
requested, not at the time the property key=value line is parsed (ie. lazy resolution).
For instance, in the property specification below, "var_a" will resolve to "test", even
though "var_b" is not defined until after "var_a":
var_a=${var_b}
var_b=test
This means that if "var_b" should ever change, the resolved value of "var_a" will also
change accordingly. [ie. "var_a" will only be resolved at the time a call to an RTConfig
property value retrieval method is called - such as RTConfig.getString("var_a")].
Write-only (assignable) property keys (ie. %log, %include) are the only exception to this
rule. Since their assigned behavior is executed at the time they are parsed ('%log' prints
a log message, and '%include' includes a file), write-only property keys must be assigned
values that can be fully resolved at the time their values are assigned.
- Property keys may be re-assigned. Property keys take on their last assigned value. For
instance, the following will display "Hello", then display "World":
test=Hello
%log=${test}
test=World
%log=${test}
- Property key assignments can be conditional if the property key has not already been
assigned a value by placing a "?" after the key specification. For instance, in the
property assignment "KEY?=VALUE", the property "KEY" will only be assigned "VALUE" if
"KEY" has not already been assigned a value previously.
The following are reserved read-only constant property keys:
%version returns the current version, as in "2.3.4"
%contextName returns the context 'name' (name of the servlet context, or main class name)
%contextPath returns the context 'path' (path to the servlet context, or $GTS_HOME)
%configURL returns the URL for the loaded config file
%hostName returns the current host-name
%hostIP returns the current mail host IP address
The following are reserved write-only (assignable) constant property keys:
%log displays the specified value to the log output
%include includes the config at the value URL (URL must exist, error otherwise)
%include? includes the config at the value URL (URL may exist, otherwise ignored)
(The included URL protocol must be one of "file" or "http".)
The following are available within a PrivateLabel session context:
session.name The PrivateLabel Domain name
session.locale The PrivateLabel Domain locale
-----------------------------------------------------------------------------------
All trade names listed above are trademarks of their respective companies.
OpenGTS and GTS Enterprise are not affiliated with any of the listed companies.
-----------------------------------------------------------------------------------
Contact Info:
Please feel free to contact us regarding questions on this package.
Thanks,
Martin D. Flynn