Update your Treon Gateway via SSH

Sep 6, 2023 · 4 minutes to read

Introduction

This article describes the update process for your Treon Gateway, Treon Gateway 2 or Treon Gateway in Protective Enclosure via an SSH access.

**Please Note: In case you have a custom Treon Aito Release for Gateway configuration, or you are not sure which Treon Aito Release for Gateway version to install, please contact Treon Customer Support.

1 Preparation

To perform this update, you will need:

• Treon Gateway serial number(s)
• Treon Gateway password(s)
• Update link of the correct Treon Aito Release for Gateway

The serial number is printed on the label at the bottom of your Treon Gateway in the form of 8 alpha-numeric characters. (e.g. ‘8de88d3a)

The password for your Treon Gateway was provided when you initially purchased the item.

You can find the correct update link in the release notes of the corresponding software release in the Updates section.

If you have files and settings stored on your Treon Gateway that should persist after the update, please read our article on Persist Move.

In case you would like to run software on the Treon Gateway after the update process has been successful, please read our article on Update Hooks.

2 Establish the SSH connection

As a first step, make sure that your gateway is in the same network as the device you are trying to access it from.

Now open the command prompt on your computer.

To start the update, you will first login to your Treon Gateway by entering

    ssh -4 gwadmin@treongw1-<serialnumber>.local

where serialnumber stands for the serial number of your specific Treon Gateway. When asked if you want to continue, type yes.

Note: the first time you connect to the Treon Gateway this way, you will be asked if you want to continue connecting. After entering yes the gateway will be added to the list of known hosts on your device.

Next you are asked to enter your password. Please note that no characters are displayed while you type. Simply type your password and press Enter. Now you are logged into your Treon Gateway.

In order to check the current Treon Aito Release for Gateway version of your Treon Gateway, enter:

cat /etc/build

and press [Enter].

You can now see the Treon Aito Release for Gateway version: RELEASE VERSION =

Please note: In case your Treon Gateway has an older Aito release version on your gateway, the update might not work properly. If your Treon Aito Release for Gateway version is below 5.6, please contact Treon Customer Support to assist with the update.

Please note: In case you would like to change your Treon Aito Release for Gateway to a previous software release, please contact Treon Customer Support for assistance.

3 Apply certificate patch

Currently, updating from Treon Aito Release for Gateway up to version 6.2.0, you need to apply a compatibility patch for the update. Simply type:

sudo curl --insecure --cert /mnt/identity/device_cert.pem --key /mnt/identity/device_key.pem https://debug.treon.fi/patches/DST-X3-cert-removal.44046e99.202110061015.sh > /tmp/patch.sh && sudo bash /tmp/patch.sh 

and press [Enter].

4 Use the update link

Now copy the update link from the release notes. In order to paste it into the Windows Command Prompt, right-click on your mouse and click [Paste]. Now press [Enter] and the download & update process will start.

Depending on your download speed of your network, this process will take about 5 to 30 minutes.

After the successful download and installation of the update, the gateway will reboot automatically. This will take several minutes, longer than usual start-up time.

5 Check successful update

After the Treon Gateway has rebooted, you can check if the update was successful. Please log in to your gateway again as described in step 2 and follow the procedure to check your Treon Aito Release for Gateway version.

Treon Support

You still have questions? Our dedicated team of experts is happy to help you! Please contact Treon Support directly by e-mail.

Did you know? Treon offers Premium Support and Maintenance Packages for our customers. Get even more out of Treon and boost your sales - inquire now about features and prices!