Update your Treon Gateway via SSH

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 Gateway software release configuration, 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 Gateway software release file

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 Gateway software release version:

cat /etc/build

and press [Enter].

You can now see the Treon Gateway software release version: RELEASE VERSION =

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

Please note: In case you would like to downgrade your Treon Gateway software to an older release version, please contact Treon Support for assistance.

3 Apply certificate patch

For updating from Treon Gateway software releases up to version 6.2.0, you need to apply a compatibility patch before the update:

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 as described in step 2 and follow the procedure to check your Treon Gateway software version.