Data forward
The DataForward plugin can be used to forward the unmodified data sent from a device to one or many other servers. For example, a GpsGate Server setup for testing that needs some real-world data. Or some other tracking system.
In this way, you can use one GpsGate Server as a data switch. Selected sets of device data are forwarded to selected servers.
Installation
1. Log in to Site Admin (Legacy)
2. Go to Plugins > Get More Plugins.
3. Install the DataForward plugin.
Note: If you need to forward data from one GpsGate server to another, please contact technical support and open a ticket.
Setup server addresses
1. Log in to Site Admin (Legacy) > Service > Data Forward (left menu)
2. Click on Add Server.
3. Enter a
- name,
- IP of the receiving server
- port number for our device manufacturer (found in Site Admin > Devices > Listeners).
- protocol for your device manufacturer (found in Site Admin > Devices > Listeners, for the port used)
4. Save.
Note: you can multiple servers if needed.
Activate in applications
1. Log in to Main Menu > Site Admin > Applications > Click on the application you want to add Data Forward to.
2. Select _DataForward under Privileges and Plugins and the configuration from the previous step.
4. Scroll down and press Save.
5. Log in to the application.
6. Select Main Menu > Admin > Roles menu.
7. Click on Create Copy next to _Unit
8. On step 1. Details, enter some details then click on Next:
9. On step 2. Privileges, select _DataForward and the forward service you want to enable. In summary, for the units to which the information will be forwarded, the _DeviceLogin and _DataForward privileges must be enabled.
10. On step 3. Users, select the users/units you want to forward to the service
It is recommended to test with one first.
11. Save.
Now data from devices in this Role will be forwarded to your external server. Data is forwarded in unmodified form.
Adding devices to the destination server
You need to create users with the correct Device ID/IMEI number in the application where the data is forwarded to. You can do this using different methods:
- By selecting the device from the list when adding a new device:
- By exporting a list of users from your source application using this report and importing in the destination application such users using the import user feature. Read how to import a report in an application here.
Profiling
You can find statistics on data forward in:
1. Site Admin (Legacy) > System Tools > Profiler
2. Select the category DataForward
Additional notes
- Data Forward is UDP only (there is no TCP support), due to the nature of this protocol, there's no guarantee the data will ever each the other server.
- We cannot guarantee that all data will reach the other server and even if it does, it doesn't mean the data will be saved: some device reports might be omitted if they don't bring any value. An example of this would be that server 1 has an event rule that is triggered by a device report, this point will be saved so that we have the data needed later on. If the server 2 doesn't have that exact same event rule, then that message might be omitted since it doesn't bring any value.
- Dataforward will only work If the device's source protocol supports TCP AND UDP and the protocol format is the same for both transports.
UDP → UDP : OK
TCP → UDP : OK
TCP → TCP : NOT COMPATIBLE