Software package preparation
- Make sure Microsoft .NET Framework 4.5.2 is installed. It can be downloaded here: microsoft.com.
- Package download link will be delivered via e-mail during 24 hours.
- Download software package and extract it.
- Make sure that you have Plesk with IIS or WAMP environment installed with PHP 5.4, 5.5 or 5.6 and MySQL 5.6 or above versions.
- Set "short_open_tag" to "On" in php.ini.
- Let's say you would like to access installed software via domain and folder "track". Then "YOUR_DOMAIN/track" is full web address to installed software.
Web part installation
- Open phpMyAdmin from web server (IIS, WAMP, XAMP or others) and create new database.
- Set created database username and password.
- Select your database from list on the left and open "SQL" tab. You will see big text box.
- From software package open "database\db.sql" with text editor.
- Copy and paste everything to "SQL" tab text box and click "Go".
- If everything is correct it will create needed tables for your database.
- From software package open "track\config.php" with text editor and set important variables:
- $gsValues['PATH_ROOT'] = 'LOCAL_PATH_TO_ROOT';
- $gsValues['URL_ROOT'] = 'http://YOUR_DOMAIN/track';
- $gsValues['HW_KEY'] = 'YOUR_HARDWARE_KEY';
- $gsValues['DB_HOSTNAME'] = 'localhost';
- $gsValues['DB_PORT'] = '3306';
- $gsValues['DB_NAME'] = 'YOUR _DATABASE_NAME';
- $gsValues['DB_USERNAME'] = 'YOUR _DATABASE_USERNAME';
- $gsValues['DB_PASSWORD'] = 'YOUR _DATABASE_PASSWORD';
- Using file manager or FTP client create folder "track" on web server. It should be accessible like this "YOUR_DOMAIN/track".
- From software package upload "track" folder contents to created "track" folder on web server.
- Set CHMOD 777 for:
- Now you should be able to access web application using this link: "YOUR_DOMAIN/track"
- Login: admin
- Password: 123456
- After login to Control panel go to Manage server section, E-mail tab and configure e-mail, otherwise users will not be able to register.
Server part installation
- From software package copy "gs" folder to "c:\gs".
- Run "c:\gs\gps-server.exe". Enable all needed protocols from the list and click "Save".
- With mouse right click open menu on "c:\gs\service\install_win32.bat" or "c:\gs\service\install_win64.bat" file and select "Run as administrator".
- Select "Path" to "c:\gs\gs.services.exe". Startup directory should be "c:\gs".
- Click "Install service".
- Execute "services.msc" from "Run" tool under Windows OS Start menu.
- Find "GPS-server" and make sure "Startup type" is set as "Automatic".
- Restart your server and if everything was done right, "GPS-server" should work as a service application.
- In case you want to change settings, run "c:\gs\gps-server.exe" application.
- Server - server domain where software is installed (set by license key).
- Hardware key - unique server key, used for some server services.
- Autorestart server interval - restarts TCP/IP and UDP listeners after set period of time.
- Check commands interval - checks for new commands to be delivered to GPS devices.
- Upload messages interval - period of time after which data from GPS devices is being uploaded to database.
- Upload messages - max batch size - number or locations uploaded by thread in one packet.
- Upload messages - max degree of parallelism - number of upload threads, which upload data independently at same time to database.
- Upload demo messages from CSV files - GPS device CSV exported tracks uploader.
- Message filter - filters duplicate points during last minutes and eliminates some drifting when GPS device signal is low.
- Message filter - event min time - skips location data if time period is lower between current and last location, prevents location message flood.
- Message filter - message max age (in hours) - prevents too old location upload from GPS device buffer.
- Connection timeout time - period of time after which GPS device will be disconnected from server in case no data is received.
- TCP max buffer size - max amount of bytes during one message via TCP/IP.
Do not forget to make backup
Once you get your GPS server running, do not forget to make backup of "c:\gs" folder contents. Also make regular backups of "YOUR_DOMAIN/track" and your GPS server MySQL database.