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 3.3.1 3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 Installation with MS SQL...................................................................................................................5 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.3 Running the Install Wizard............................................................................................6

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 Proxy User Password Retype Password Proxy Phone Number Server Hostname Enable SMS Proxy

Create a unique user name for your Proxy User Set a Proxy User password Re-type password for confirmation Set the proxy phone number in international format (e.g. +...) Enter the hostname of your server (example acme.gpsgate.com) 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)