Update your Treon Gateway via SSH
Mar 1, 2023 · 3 minutes to read
This article describes how to update your Treon Aito Release for Gateway 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 Gather information
To perform this update, you will need:
- Treon Gateway serial number(s)
- Treon Gateway password(s)
- Update link of the correct Aito software release
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 here in the Updates section. The latest Treon Aito Release for Gateway is 7.0.1 and can be found in this article.
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, righ-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 gateway has rebooted, you can check if the update was successful. Please log in to your Treon Gateway again as described in step 2: Establish the SSH connection and follow the procedure to check your Treon Aito Release for Gateway version.
Treon Customer Support
If you have further questions, please contact Treon Customer Support.
