Tracking server how-to

The tracking server (aka tcp server) sends and receives data from GPS trackers via navixy protocol. It also be occupied with operating commands and events watching.

TCP server installation under Windows

  1. Move directory tcp-server from the distributed directory, for example to c:\tcp-server
  2. To install the application as service, run installService.cmd with administrative rights
  3. Now you can manage the server using startService.bat and stopService.bat. There are another way using standard system tool of service management. Also with the help of trayIcon.cmd an icon in system tray will be appeared and  it will showing status of the application and permit to manage it.
  4. If necessary to remove the service or to move the application to another directory, it can be removed using uninstallService.bat

TCP server installation under Unix

To install service under Unix do steps in instructions on page

Configuring TCP server

Open /home/java/tcp-server/conf/settings in preferred editor.

  1. Specify MySQL connection parameters:
  2.  #db settings
    dbUsername=<MySQL user>
    dbPassword=<MySQL user's password>
  3. Edit addresses settings:
  4. #external addresses
    apiUrl= <URL where available API>
    externalIP=<external ip of machine>
    externalHostname=<DNS hostname of the machine>
  5. Edit Navixy API access
  6.  #api access credentials
    serviceId=<id that has been generated and remembered on page>
    servicePass=<password that has been generated and remembered on page>
  7. (optional) Edit keys for geocoders:
  8.  #geocoder keys 
    googleKey=<Google geocoder key> 
    googleID=<Google geocoder key> 
    yandexKey=<Yandex geocoder key>
  9. Open this file /home/java/tcp-server/conf/Mail. Edit mail settings:
  10. mail.user=<smtp user name> 
    mail.password=<smtp password><smtp server address><pop3 server address><imap server address>
  11. If it is necessary to use the SMTPS protocol, settings should be:
  12. mail.user=<smtp username> 
    mail.password=<smtp password><smtp server address> 
    mail.smtp.auth=true<smtps server address> 
  13. Here is an example of gmail settings:
  14. mail.user=<smtp username> 
    mail.password=<smtp password> 

    Note. All mail settings should be specified without any spaces!

  15. POP3, IMAP aren’t used in this implementation and these strings can be removed. If mail is sending from localhost, it’s enough to specify and mail.transport.protocol. Also we advise you create SPF и DKIM in your domain and  check if this host has got an PTR record, otherwise messages may be moved to spam folder.
  16. Mail can be sent via sms-server. To do that please add the following string to tcp-server config:
  17. mq.notificationQueueEnabled=true
  18. HazelCast. You can learn more on Wikipedia. Settings are located in the file /home/java/tcp-server/conf/hazelcast.xml. Usually you don’t need to change anything in this file. Settings in all java components are identical. It is enough to distribute config to all java applications’ directories.
  19. Support of LBS (Location-based service) uses Yandex Locator service – To enable LBS support is necessary to add the following strings to configuration file:
  20.  gsmLbsLocatorEnabled = true 
     yandexKey = <access key to API Yandex, if it hasn't been already specified for geocoding>
  21. To enable chat add the string
  22. chat.enabled=true

If you have more questions please contact our support team


USA: +1 858 815 9045

Mexico: +52 334 1642158

UK: +44 808 1641499

Germany: +49 1573 5988250

Russia: +7 495 223 0427

Log in