Installing TDS

The Tessonics Data Service (TDS) software acts as a data collection service as well as a reporting tool. It is a web-based application that you can access from any device with a network connection.

Download and Initial Setup

The latest release of the TDS software can always be found on the downloads page of our website:

• Canada: https://tessonics.com/downloads/
• Europe: https://tessonics-europe.com/support

To install the TDS Software, download the installer and execute it with administrator rights on the server. The installer will guide you through the basic installation process.

Upon completion, TDS will be installed as a system service and started automatically. It can be started, stopped or disabled through Windows Services.

By default, the TDS server will create the databases, some SSL certificates, and a config file (tds-server.json) inside C:\ProgramData\tessonics\tds2. To update database paths or use custom SSL certificates, edit the corresponding paths inside tds-server.json.

Setting up Firewall

To setup the firewall rules to allow TDS to communicate with other devices on the same network, follow the steps outlined below on the computer running TDS:

1. Open “Windows Defender Firewall” and select “Advanced Settings” from the left menu.
2. Select “Inbound Rules” from the left menu.
3. Select “New Rule”.
4. Ensure “Program” is selected and press “Next”.
5. Under “This program path”, use the browse function to navigate to “C:\Program Files\Tessonics\TDS2\tds-server.exe” and select “Open”. Then press “Next”.
6. Select “Allow the connection” and then “Next”.
7. Ensure all three check boxes on the screen are checked, then press “Next”.
8. In the name field, type “tds-server” and select “Finish”.

Now that you have a rule created for the TDS server, you need to duplicate the rule and dedicate one to TCP communication and the other to UDP. Follow the steps below:

1. On the same screen, sort the rules by name and scroll down to “tds-server”.
2. Right click the rule and select “Properties”.
3. Select “Protocols and ports” and change “Any” to “TCP”. Then press “Apply” and “OK”.
4. Back on the rules list, copy and paste the “tds-server” rule. If you do not see 2 copies of the “tds-server” rule, you may have to re-sort by name so both appear next to each other.
5. Select one of the two “tds-server” rules and open “Properties”.
6. Select “Protocols and ports” and change “TCP” to “UDP”. Then press “Apply” and “OK”.

You should now see 2 “tds-server” rules. Under the “protocol” heading, one should say “TCP” and the other should say “UDP”.

Close Windows Defender Firewall and reboot the computer.

Migrating from a Previous TDS Installation

Previous versions of the TDS software relied on third party packages such as PHP, IIS, SQLServer, etc. The new TDS software does not have any outside dependencies. To migrate your data from an older TDS, download the migration software from our website and follow the following instructions. This only needs to be done once. For future upgrades to TDS, see the below section on upgrading.

Migrate your database

Before migrating, create a backup of your data to prevent accidental data loss.

In most cases the database location will not differ between versions and this step may be skipped.

All database migrations from older TDS 2 versions can be accomplished by referencing the database.sqlite in the tds-server.json configuration file. When restarting TDS, it will check the database schema and update the contained data accordingly.

Upgrading

To upgrade the TDS server to a later version, download the version from our website and run the installation wizard. It will detect the current TDS installation and update it accordingly.

Check your data

After setting the correct database and updating the TDS software, it will have restarted and the web-interface of TDS should be accessible and display the data as it has been before the update.