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 EXE part installation
- From software package copy "gs" folder to "c:\gs".
- Run "c:\gs\GPS-server.exe".
- Check "Autostart server".
- Enable all needed protocols from the list. Just check checkboxes in "Enabled" column.
- Click "Save".
- Click "Start". After that you may see firewall warnings, so you have firewall to allow these protocol ports to be open.
- If all protocols started successfully you can click "Stop".
- Server - server domain where software is installed (set by license key).
- Hardware key - unique server key, used for some server services.
- Autostart server - once GPS-server.exe is started, TCP/IP and UDP listeners will start together.
- 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.