ChronoTrack forwarder

The forwarder is a program that runs locally to send reads from ChronoTrack timing systems to RACEMAP. You use the forwarder through command line, no UI.

How does the forwarder work?

• Opens a port, default running machine: 3000

• Listens on localhost IP: 127.0.0.1

• RACEMAP timing API token is needed to forward data to RACEMAP

• Set API token with environment var RACEMAP_API_TOKEN

How to use the forwarder?

1. Get the timing API token for your RACEMAP account, contact [e-mail].

2. Download the forwarder to the computer on which the ChronoTrack timing software is running.

3. Run the forwarder with the API token as an environment variable.

4. Configure your ChronoTrack timing software to send data to the forwarder.

5. The forwarder will send your data to RACEMAP.

set RACEMAP_API_TOKEN=[APItoken]
.\chronotrack-to-racemap-forwarder.exe

How to operate the forwarder?

Basic

Download the latest binary for windows or for linux and run it with below commands.

Windows

• Download the forwarder here: chronotrack-to-racemap-forwarder-win-x64-v1.0.0.exe

• Press Windows Key

• Press CMD + Return to open the command line window.

• Navigate to the download folder of the forwarder.

• Set your API token. Replace [APItoken] with the unique API token of your RACEMAP account.

set RACEMAP_API_TOKEN=[APItoken]
.\chronotrack-to-racemap-forwarder.exe

• start the forwarder from here: chronotrack-to-racemap-forwarder.exe + Return.

• Shell window shows the log messages.

Linux

Download the forwarder here: chronotrack-to-racemap-forwarder-linux-x64-v1.0.0

export RACEMAP_API_TOKEN=[APItoken]
./chronotrack-to-racemap-forwarder 

Replace [APItoken] with the unique API token of your RACEMAP account.

Expert

You can checkout the repository and operate the forwarder with below commands. Requires nodejs 18 and yarn 4.

  git clone [e-mail]:racemap/chronotrack-to-racemap-forwarder.git
  cd chronotrack-to-racemap-forwarder
  yarn install
  touch .env
  sed -i '/^RACEMAP_API_TOKEN=/d' .env && echo "RACEMAP_API_TOKEN=your-api-token" >> .env
  yarn start

Adjust the default settings of the forwarder with below variables.

Variable	Default	Description
RACEMAP_API_TOKEN	''	The API Token is required to send data to RACEMAP
LISTEN_MODE	private	The mode the service listens on, can be private or public. private binds to 127.0.0.1 public binds to 0.0.0.0
LISTEN_PORT	3000	The port on that the forwarder will listen
RACEMAP_API_HOST	https://racemap.com	The host the requests will be sent to