How to set up the SARTrack Database system

SARTrack is not one program on one laptop: every SARTrack Client, the web site and the SARTrack App connect to a SARTrack Database Server, which keeps your organisation's Operations and shares them in real time. This guide takes you through it in the order you need it: your Internet Server and GroupID, the logins, the web site, a Local Database Server for the field, and the laptops and phones.

How it fits together

  • The Internet Server keeps your organisation's data on the internet. SARTrack Clients at home or in the office, the SARTrack web site and the SARTrack App connect to it from anywhere.
  • A Local Database Server runs on one laptop at your base, Incident Control Point or comms post. Every SARTrack laptop, phone and browser on that network or WiFi connects to it, with or without internet.
  • Whenever the Local Server has internet, even now and then over a mobile or satellite link, it synchronises with the Internet Server by itself, both ways: everyone sees the same Operation.

You always need the Internet Server: it holds your GroupID, your logins and your Personnel. A Local Server is what keeps you going in the field when the internet, the power or the phones are gone.

How SARTrack connects: home and office, the permanent base and the field
How SARTrack connects

1.Your Internet Server and GroupID

Your organisation gets its own Organisation ID (GroupID) on one of SARTrack's Internet Servers: a free trial for 3 months, or paid (a shared Server costs far less than one of your own). Ask for it online; SARTrack looks at every request.

Which Server

  • New Zealand, dtb-nz.sartrack.nz: New Zealand Search and Rescue and AREC organisations.
  • Europe, dtb-eu.sartrack.net: in Germany, for its strong privacy laws.
  • United States, dtb-us.sartrack.net: the Americas.

You can also e-mail support@sartrack.nz with the name of your organisation, the GroupID you would like, and the name and e-mail address of your first Supervisor.

What you get

  • Your GroupID: your organisation's number, between 100 and 30000 (5000 to 7000 are New Zealand's). Every SARTrack computer, phone and Server of your organisation uses the same GroupID.
  • Your first Supervisor login: an e-mail with a link to set its password (the link works for 48 hours).
  • A User Key (SART-XXXX-XXXX-XXXX-XXXX) when the Server asks for one: SARTrack asks for it once at the first login, and the web site's login page has a box for it. Keep it within your organisation.

Running your own Internet Server instead? See Your own Internet Server below, and set it up before anything else.

2.Logins

Everyone logs in with their own login: the Log shows who did what. A Supervisor manages the logins in SARTrack's Database Users window (Main Menu: DTB Access), connected to the Internet Server. The logins are synchronised to your Local Servers: set them up once.

Access levelFor
PrivateThe SARTrack App only, for members in the field. Not SARTrack itself, not the web site.
Read-onlyCan see everything, change nothing.
Data entryLog entries and other data.
OperationsRunning the Operation: Teams or Units, Tasks, Objects, the Log. Most users.
SupervisorEverything of the organisation, also its logins, Personnel and settings.
Database ServerOnly for a Local Server's link to the Internet Server (step 6). Never for a person.

Every login belongs to a person

  • A new login is linked to its person in SARTrack's Personnel, by their e-mail address: SARTrack finds the person with that address, or makes them a new person.
  • With an e-mail address, the Server e-mails the new login a link to set its own password: nobody else ever knows it.
  • Logins without a person, or without an e-mail address, are listed in an amber bar at the top of Database Users: click Show only these, double-click each login, and choose its person and e-mail address. Supervisors need this for the web site (step 3).
  • SARTrack App users get an e-mail invitation with a one-time code (Personnel window, or Database Users): see the Android App page.

3.The web site

Your Internet Server is also your organisation's web site: https://dtb-nz.sartrack.nz (New Zealand), https://dtb-us.sartrack.net (United States) or https://dtb-eu.sartrack.net (Europe). Log in with your GroupID, your login and password (and the User Key when it asks). Every login of Read-only and up works there: the Dashboard, the maps, the Log, Units or Teams, Tasks, Personnel and more, on any computer or tablet, nothing to install.

Supervisors: a second step

A Supervisor login can change everything, so on the web it needs a 6-digit code as well:

  • From the SARTrack App: pair your phone once (in the App: the You tab, Pair this phone, approved in SARTrack's Database Users). The App then shows the code itself, also without internet: the way to go with a Local Server in the field.
  • Or by e-mail: SARTrack e-mails the code to the login's e-mail address, or its person's. The code works for 10 minutes.
  • Tick Remember this browser: that computer does not ask for a code again for 7 days.

No e-mail address and no paired App: a Supervisor still gets in, but only with Operations rights. Link every Supervisor login to its person's e-mail address first (step 2).

4.A Local Database Server

Install it on one laptop for the field, and (recommended) one at your permanent base. It needs 64-bit Windows 8 or newer. It can run on a laptop that also runs SARTrack, but that laptop must be the first one switched on, and must never be switched off during an Operation. Only one Local Server per network: two on the same network warn each other.

  1. Download and install the SARTrack Database Server. Allow it through the Windows firewall when Windows asks (private networks).
  2. Start it. At the first start its Setup window opens:
    • This Server: a unique callsign and SSID. No two SARTrack computers, Servers or Clients, may ever have the same callsign and SSID (for example ABCDE-10 for the Server, ABCDE-11, ABCDE-12 ... for the laptops). Your organisation and a contact e-mail address.
    • Passwords: set the "ServerAdmin" password, and keep it safe: the Server's own settings and the first login need it.
    • Starting and updates: tick Start automatically (at the Windows login), Run in the background (tray icon) and Auto Update.
    • Server type and link: leave This is the Internet Master Server unticked: only an Internet Server has it.
  3. Click OK. The Server now asks for its Server Licence: see the next step.

The Server runs as a normal Windows program: it starts when someone logs in to Windows, and stops at a Windows log-out. The SARTrack Server Monitor (installed with it) keeps an eye on it, restarts it when needed, and installs its updates at the hour set in Setup.

5.The Local Server's Server Licence

A Local Server needs a Server Licence for your GroupID: without it, SARTrack 2.0, the web site and the App cannot log in to it. It is made for that one laptop, and it says how many people may use the Server at the same time.

  1. At the start, the Server says "This Server has no Server Licence yet". Type the ServerAdmin password and click Apply now... (later: Setup, Server Licence..., Apply online...).
  2. Fill in your organisation, a contact e-mail address, your GroupID(s), the number of users at the same time and of SARTrack App phones, and a few words about your organisation.
  3. Choose how:
    • Pay online: choose a licence and pay; the licence comes at once.
    • Volunteer organisation: SARTrack contacts you to discuss.
    • Free trial: try SARTrack first, for 3 months, no payment. SARTrack approves it.
  4. Click Send the application. The Server checks every few hours whether the licence is ready and installs it by itself (or click Check application now in the Server Licence window).

Apply a few days before you need it: a trial or a volunteer licence needs our approval. Before the licence ends, Renew online... in the same window. A new laptop needs a new application: contact us to move the licence.

7.The SARTrack Clients

  1. Install the SARTrack Client on every laptop (Windows 8 or newer). All must run the same, latest version, with the same GroupID, and each its own callsign and SSID.
  2. In Connections, Database: choose your Database Server, or Automatic: it finds the Local Server on the network or WiFi by itself, and uses the Internet Server when there is none. Click Connect.
  3. Log in with your own login (and the User Key, if the Internet Server asks for it). SARTrack loads the Operation; a Supervisor can start a new one.
  • A Client on the same laptop as the Local Server always connects to that Server. To connect it to another Server, shut the local one down first.
  • Connect only one Client to the APRS-IS network, or to a radio or satellite tracking feed: what it receives goes to every Client through the Server.
  • Several operators at once? Each takes their own My Desk in the Log window: their own stations, channels or functions.
  • The organisation's e-mail is checked by the Server: see the SARTrack E-mail system (PDF).

8.Phones and browsers in the field

  • The SARTrack App connects to the Local Server by itself when the phone is on its WiFi, and to the Internet Server everywhere else: it switches back and forth on its own. See the Android App page.
  • The web site of the Local Server: on the same network, open https://sartrack.local (just sartrack.local opens a page with a Connect button). It needs no internet. Your browser warns about the Server's certificate: accept it, the connection is still encrypted. Older Android phones do not know .local names: use the Server laptop's address instead, for example https://192.168.1.10.

Before an exercise or a real Operation

  • Every Supervisor login is linked to its person's e-mail address, and the Supervisors have tried the web site (or paired the App).
  • The Local Server has its Server Licence and is linked to the Internet Server: it shows your logins.
  • Every laptop runs the latest SARTrack, with the same GroupID and its own callsign and SSID.
  • The laptops find the Local Server with Automatic, also with the internet unplugged.
  • The Local Server laptop is on mains power (or a big battery), and its power settings never put it to sleep.
  • Who starts the Operation, and on which Server, is agreed beforehand.

Advanced: your own Internet Server

Install it on a commercial VPS (Virtual Private Server). There can be only one Internet Server for your organisation.

  1. Give it a web address (for example sar.example.org) pointing at the VPS, and a TLS certificate for that address (for example from Let's Encrypt).
  2. Install the SARTrack Database Server as for a Local Server, but tick This is the Internet Master Server in its Setup. This changes how the Server works with everything that connects to it.
  3. Open the ports below in the VPS's firewall and in Windows Firewall.
  4. Apply for its Server Licence (Setup, Server Licence..., Apply online...) with its web address. The Server proves the address is its own, so its web site must already be reachable there on port 443.
  5. Log in from SARTrack with ServerAdmin (check the GroupID first), make your own Supervisor login, the other logins, and the Database Server logins for your Local Servers. Then the User Keys for your users (Setup, User Keys...).
Port (TCP, in)For
8050SARTrack Clients and Local Servers
8058The SARTrack App
443The SARTrack web site (HTTPS)
8443The Server's information page (HTTPS)
8053The Server's status page (HTTPS)
8057The Server's debug port (encrypted; for support)

Going out, the Server sends e-mail (SMTP, normally port 587), checks the organisation's e-mail (IMAP, port 993) and reaches the SARTrack Licence Server (HTTPS); the Server Monitor downloads updates.

Problems?

Please report every problem, in detail. In SARTrack: click the bottom button of the Main Menu (the About box), then Debug window, and send a bug report: it includes the debug file. Sometimes the debug files of all the computers involved are needed, the Server's too, to compare them. Or e-mail support@sartrack.nz.

← Back to Support