GpsGate Server
GpsGate Server
Installation and Administration Guide
Version: 2.2
Rev: 2
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
Table of Contents
1 Introduction......................................................................................................................3
2 Technical Requirements.................................................................................................4
2.1 Third Party Software......................................................................................................4
2.2 Recommended and Supported Web Browsers.............................................................4
3 Installing GpsGate Server on a Dedicated Server........................................................5
3.1 Technical Requirements................................................................................................5
3.2 Before your start............................................................................................................5
3.2.1
Installation with MS SQL...................................................................................................................5
3.3 Running the Install Wizard............................................................................................6
3.3.1
3.3.2
3.3.3
3.3.4
3.3.5
3.3.6
3.3.7
Check System Requirements............................................................................................................6
Database Setup.................................................................................................................................6
IIS Setup...........................................................................................................................................7
Custom Maps....................................................................................................................................7
Copy Files.........................................................................................................................................7
NMEA Service Setup.........................................................................................................................7
Completing the Installation................................................................................................................7
3.4 Upgrading GpsGate Server...........................................................................................9
4 Installing a GpsGate.com Server Subscription..........................................................10
5 GpsGate Server Configuration.....................................................................................11
5.1 Getting Started.............................................................................................................11
5.2 Adding New Applications.............................................................................................11
5.3 Application Management.............................................................................................11
5.4 License Management..................................................................................................12
5.5 Service Management...................................................................................................12
5.6 Server Settings............................................................................................................12
5.6.1
5.6.2
5.6.3
5.6.4
5.6.5
Map Settings...................................................................................................................................12
Script Settings.................................................................................................................................13
Change Password...........................................................................................................................13
Default Site Language.....................................................................................................................13
SMS Proxy Settings........................................................................................................................14
5.7 Custom Map Management..........................................................................................14
6 Additional Language Support......................................................................................15
6.1 Upgrading Custom Language Files.............................................................................15
7 Additional Information..................................................................................................16
Date: June 26, 2009
Page 2(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
1 Introduction
Welcome to the GpsGate Server Installation and Administration Guide! GpsGate Server is easy to
install if you follow the instructions in this document. Please read the document carefully before
you get started.
Don't forget to take a backup of your data before you start an upgrade of your existing GpsGate Server installation!
This document should get you through the installation quickly, but please feel free to post any
additional questions in our technical forum at the following link:
http://franson.com/forum
Thank you for using GpsGate!
The GpsGate Team
Date: June 26, 2009
Page 3(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
2 Technical Requirements
GpsGate Server is built on .NET and uses MySQL or MS SQL as database. GpsGate Server can be
installed on a dedicated server or subscribed to as a service.
2.1 Third Party Software
The following software is needed to run a GpsGate Server.
●
.NET 2.0
●
MySQL 4.1 (or later) or MS SQL Server 2000 and 2005
●
Windows VISTA,Windows XP Professional SP2, Windows Server 2003 SP1/SP2 or
Windows 2000 SP4
GpsGate Server installation on Windows Vista is not yet supported by the installer. The manual
installation process for Windows Vista is explained in the technical forum at the following link:
http://franson.com/forum/topic.asp?TOPIC_ID=6923
Gpsgate Server support for MS SQL server 2000 and 2005 is not yet supported by the installer.
Read the section about MS SQL support for a manual installation.
2.2 Recommended and Supported Web Browsers
The user interface for GpsGate Server is browser based and recommended browsers for GpsGate
Server are Firefox 2.0 (or later) and Internet Explorer 6 (or later).
GpsGate Server also supports other browsers such as Opera, Chrome and Safari for the
BuddyTracker and VehicleTracker applications.
Note: It is highly recommended that you use one of the recommended browsers when you do
anything as SiteAdmin, such as installing database-modules.
Date: June 26, 2009
Page 4(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
3 Installing GpsGate Server on a Dedicated Server
The instructions in this section help you install GpsGate Server on your own server.
If you have a hosted GpsGate.com Server Subscription you can move on to the applicable sections
further down in this document.
3.1 Technical Requirements
You need to have the following software installed on your server to successfully install GpsGate
Server using the Install wizard.
●
MySQL 4.1+ with ODBC 3.51+ and MDAC v2.6+
or
MS SQL Server 2000 or 2005
●
.NET 2.0, and IIS 5.0+
3.2 Before your start
To prepare your installation you need the GpsGate Server package:
●
Download the GpsGate Server package GpsGateServer.zip from
http://franson.com/gpsgateserver
●
Unzip GpsGateServer.zip to a folder on your Server.
3.2.1 Installation with MS SQL
GpsGate Server now also works with MS SQL server 2000 and 2005. The installation is not yet
included in the Install Wizard, so if you are using MySQL then follow the guide below.
Note: Upgrades and un-installs of a GpsGate Server using the Install Wizard are supported both on
installations with MySQL databases and installations with MS SQL databases. Please see the
chapter “Upgrading GpsGate Server” for more information.
1. Create an MS SQL database manually. Create a login that is owner of the database. And create an
ODBC DSN which points to your database.
2. Run the normal Install Wizard. Note: that a current limitation in the Install Wizard requires that
you have a MySQL ODBC Driver installed.
You can also make a manual install which is described here:
http://franson.com/forum/topic.asp?TOPIC_ID=6923
http://franson.com/forum/topic.asp?TOPIC_ID=7860
3. Edit the configuration files. After the installation you must edit the two following files.
"IIS\Web.Config" and "Franson Nmea Service\GpsGate.Service.exe.config
<add key="DatabaseType" value="MSSQL" />
<add name="ConnStr" connectionString="Dsn=DSN;UID=username;PWD=password/>
The two lines above should be edited in both config files. Note that "MySQL" is changed to
"MSSQL", and you need to add ODBC DSN name + login username + password to the database
owner you created in step 1.
Date: June 26, 2009
Page 5(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
4. Login to SiteAdmin in a web browser to install the database. The typical URL is
http://yourdomain/siteadmin/index.aspx
3.3 Running the Install Wizard
This section covers the installation process and explains the steps in the GpsGate Server Install
Wizard.
Open the folder GpsGateServer\DedicatedServer and run Install.exe.
Note: Remember to zip GpsGateServer.zip before you run Install.exe
The welcome page lists the system requirements.
Press Next to continue if your server fulfills these requirements.
3.3.1 Check System Requirements
In this step the Install Wizard checks that your server fulfills the system requirements.
If you get an error here, please install the required components before you continue. When the
check has completed without errors, press Next to continue.
3.3.2 Database Setup
This step sets up your MySQL database.
The System DSN (Database Source Name) contains all the Datasource settings. The first time you
set up a database you should select a name for the DSN, and enter the Datasource settings
appropriate for your MySQL database installation.
To Create a new DSN:
1. Enter a DSN name and press Create to open the Datasource settings
2. Fill in your database information and
3. Select an existing Database or create a new one
If you already have a DSN from a previous installation of GpsGate Server you can select it in the
drop down-list and use it's Datasource settings.
Note: Do not select the MySQL database in the DSN list as it is a custom database used by
MySQL.
Press Next to continue when finished.
Note: If you get an error message at this point it usually means that the Database User you selected
lacks Database Administrator rights. Use the GRANT command to add the required rights in a
MySQL command prompt window, look in your MySQL manual for details.
Date: June 26, 2009
Page 6(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
3.3.3 IIS Setup
This step sets up IIS and the path to your GpsGate Server installation.
It is recommended that you use the default settings unless you want to customize your installation.
Virtual Directory
This defines the location of your installation (e.g. www.mydomain.com/<virtual directory name>)
File path
This is the folder on your server where you want to install the GpsGate Server files.
Press Next to continue.
3.3.4 Custom Maps
You can import you own custom maps to GpsGate Server. This step sets up the path to your custom
map directory.
Select a directory on your server where you want to place your custom map data.
Note: You need to create a custom map directory even if you do not use custom maps today.
When finished, press Next to continue.
3.3.5 Copy Files
In this step the Install Wizard copies the GpsGate Server installation to your server and configures
the IIS Web Server with virtual directories etc.
Press Next to continue when the copying is finished.
3.3.6 NMEA Service Setup
The NMEA Service is needed to allow Devices and GpsGate Clients to send their position to your
GpsGate Server.
Select the TCP and UDP ports to be used by your tracking devices to send position updates to
GpsGate Server.
Note: Make sure that these ports are not blocked by a firewall.
Press Next to continue.
3.3.7 Completing the Installation
The final steps in the installation process creates your SiteAdmin user and activates your database.
Use a recommended web browser for these steps.
Click Finish to open a web browser on to the GpsGate Server Administrator page.
Note: You can also go to the Administrator page by clicking on GpsGate Server in the Windows
Start menu.
Date: June 26, 2009
Page 7(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
Create your Admin user in the window below . This is the main administrator account for the
GpsGate Server installation, so please make sure that you remember your username and password.
Press Create new Admin User to continue.
The Install Wizard looks for modules to install or upgrade.
Press Install to continue installing all the required modules.
Congratulations! The “Install done” message shows that you have completed the GpsGate Server
installation.
Press Ok to go to the SiteAdmin login screen if your want to configure your installation now.
Configuration is described in Chapter 6, “GpsGate Server Configuration”
Date: June 26, 2009
Page 8(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
3.4 Upgrading GpsGate Server
To upgrade your GpsGate Server installation you also run the Install Wizard (Install.exe). The
Install Wizard will detect your current installation and let you choose between upgrading and uninstalling it.
Note: Upgrades and un-installs using the Install Wizard are supported both on installations with
MySQL databases and installations with MS SQL databases.
Select Upgrade and press Next to continue with the Install Wizard described in the installation
sections above.
It is important that you login as SiteAdmin directly after running the Install Wizard to activate any
new or updated database modules.
Date: June 26, 2009
Page 9(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
4 Installing a GpsGate.com Server Subscription
With a GpsGate.com Server Subscription you do not need to install your own GpsGate Server!
You should go directly to Chapter 6 to configure your installation. Please follow the instructions
you got in your order confirmation to get started.
If you have any questions about the installation of your GpsGate.com Server Subscription please
send us an email with your order number and your questions to: support@franson.com
Date: June 26, 2009
Page 10(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
5 GpsGate Server Configuration
You use the SiteAdmin application to create applications and configure the server with your
preferences. The following sections walk through the configuration options in your GpsGate Server
installation.
5.1 Getting Started
Two sample applications, BuddyTracker and VehicleTracker have been installed by the Install
Wizard. You can either use them or add your own applications to your installation. If you want to
use the sample applications you need to add Admin Users to them.
Login to your SiteAdmin account with the site administrator user name and password to get started.
5.2 Adding New Applications
In SiteAdmin you create applications under the “Add new Applications” tab.
Input the following information to add a new application to GpsGate Server.
Application type
Select between a VehicleTracker and BuddyTracker application
Application Name
Give the application an identifying name, such as “Acme Cars”
Application Description
Add a description of the application
Admin Users
You can either create a new admin user for your application or use an existing one. An admin user
can belong to multiple applications.
5.3 Application Management
The “Application management” tab is used to change settings in existing applications.
You can change the application name and description. You can also add and remove admin users for
the application.
Date: June 26, 2009
Page 11(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
Logout redirection Url
Define the url (web address) users are re-directed to when they logout from the application.
Map settings
Enable/Disable Google Maps and select the default map for the application. The Default Map is the
map that is loaded when a user logs in to the application. Currently Custom Map support is
available in the VehicleTracker application.
5.4 License Management
Under the “License” tab you can see how your current GpsGate Server is licensed, you can also
upload additional license files here.
The license count is incremented when you upload additional license files to GpsGate Server.
5.5 Service Management
The “NMEA Service” tab is used to start and stop the NMEA service and the installed protocol
listeners. You can Start, Stop and Edit the services, by clicking the corresponding tag.
With “Edit” you can change the settings, such as the port number used, for the service.
Note: To support a specific protocol (e.g. GlobalSat Protocol over SMS) you need to have that
service enabled.
5.6 Server Settings
The “Settings” tab is used for global settings in your GpsGate Server installation.
5.6.1 Map Settings
You need to generate and install a GoogleMaps API Key in order to use Google Maps in your
BuddyTracker and VehicleTracker applications in your GpsGate installation.
Follow the instructions to set up a GoogleMaps API Key.
Date: June 26, 2009
Page 12(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
5.6.2 Script Settings
You can select to run JavaScripts compressed or un-compressed. Compressed scripts reduce load
times and is the recommended option, un-compressed scripts are mainly used for developers as they
are easier to debug.
5.6.3 Change Password
Here you change the password for your SiteAdmin account.
5.6.4 Default Site Language
you select the default language for your GpsGate Server installation. If you have installed new
language files, press Reload language files to update the drop down menu.
Date: June 26, 2009
Page 13(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
5.6.5 SMS Proxy Settings
You need an SMS Proxy to activate the SMS functionality in GpsGate Server. To setup a proxy you
need to define the following SMS Proxy Settings:
Proxy User Login
Create a unique user name for your Proxy User
Proxy User Password
Set a Proxy User password
Retype Password
Re-type password for confirmation
Proxy Phone Number
Set the proxy phone number in international format (e.g. +...)
Server Hostname
Enter the hostname of your server (example acme.gpsgate.com)
Enable SMS Proxy
Tick the box to activate SMS functionality
5.7 Custom Map Management
You can add your own maps to your GpsGate Server installation. The “Custom Maps” tab is used to
manage the maps and make them available in different applications.
The whole process of adding custom maps to your GpsGate Server installation is described in detail
in the technical forum at the following link:
http://franson.com/forum/topic.asp?TOPIC_ID=6757
Date: June 26, 2009
Page 14(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
6 Additional Language Support
You can localize your GpsGate Server installation to support any number of languages, in addition
to the default English. The server has a default language setting, and each application and user can
have individual language settings.
To add a language you create a new language-file and put it in the
“YourInstallPath/Resources/Languages” directory of your GpsGate Server installation. By
default there are two language files "english.lang" and "swedish_demo.lang" in that directory.
Note: that to support none Latin character sets the text editor you use must support UTF-8.
Remember to save the file as UTF-8!
Follow these steps to create a new language file:
1. Copy the "english.lang" file in the "Languages" folder and rename the copy with your
language (e.g. "norwegian.lang").
2. Open your new language file with an editor that supports UTF-8 encoding, such as
BabelPad.
3. Replace the Lng=“English” in the beginning of the file with the name of your language as
this is the text that will appear in the user interface (e.g. Lng=”Norwegian”).
4. Change the enablecache=”true” to "false" in the beginning of the language file. This makes
testing of your translation easier as as you see your changes directly in the user interface.
5. Save your new language file and go to the Settings tab and press Reload language files for
your settings change to take effect.
6. Translate the text for each Phrase Key in the file from English to your language. For
example, by changing the text “Start” to “Startta” the Start-button in the Tracks-window
in VehicleTracker will display the text "Startta" instead of "Start".
7. Go through all the different sentences in the file for both VehicleTracker and BuddyTracker,
including error-messages and tool-tips.
8. When you are done translating set the enablecache=”false” to “true” as this will enable
GpsGate Server to cache the language file for improved performance.
As SiteAdmin you can select the default ".lang" file for all applications by selecting it in the list of
“Available languages”. In VehicleTracker users have the option to override the default setting by
selecting their preferred ".lang" file.
Note: All “.lang” files in the Resources folder appear as a language options so you can repeat the
procedure above for additional languages.
6.1 Upgrading Custom Language Files
If you use customized languages files you must update them with language tags that have been
added in later versions when you upgrade. New tags are always added to the end of the
“english.lang” file with a section for each version marked with the version number, such as
<Version value="1.3.2.465">
To update your custom language files, copy and paste the updated sections from the new
“english.lang” file to your custom “.lang” files and translate the new tags.
Date: June 26, 2009
Page 15(16)
GpsGate Server Installation Guide
Version: 2.2 - Rev: 2
7 Additional Information
The technical forum for GpsGate Server covers additional aspects of GpsGate Server installation.
The forum is reached by the following link:
http://franson.com/forum
Date: June 26, 2009
Page 16(16)
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising