Actions

Difference between revisions of "Turbine Software Upgrade"

From Zenitel Wiki

(Devices with Recovery OS)
 
(36 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{AEIPS}}
 
{{AEIPS}}
This article describes how to upgrade the software of the [[:Category:Stations#Turbine_stations|Turbine series of intercom devices]] via the '''web interface''' of the station. This process is best suited for upgrading only a few stations.  
+
This article describes how to upgrade the software of the [[:Category:Stations#Turbine_stations|Turbine series of intercom devices]] via the '''web interface''' of the station.  
  
 
{{Note|
 
{{Note|
* ''For mass upgrade of stations it is recommended to use the [[IMT|VS-IMT]] tool, see the article [[VS-IMT Upgrade Stations]].''
+
* ''The procedure described in this article is applicable to the following devices: '''TCIS-x''', '''TCIV-x''', '''TKIS-2''', '''TMIS-x''', '''TFIE-x''', '''TKIE-x''', '''TFIX-x''', '''IP-LCM''', '''ECPIR-3P''', '''Exigo IP speakers'''. '''Exigo Network Amplifiers''', and '''ENA-2060DC1'''''
 +
* ''For mass upgrade of stations it is recommended to use the [[IMT|VS-IMT]] tool, see the article [[IMT - Discover & Upgrade]].''
 
* ''Using Turbine version 4.7.3.2 or higher, you can downgrade to VSF-Turbine version 4.2.3.17, but not to any older version.''
 
* ''Using Turbine version 4.7.3.2 or higher, you can downgrade to VSF-Turbine version 4.2.3.17, but not to any older version.''
* ''To upgrade from version 4.2.3.14, version 4.2.3.17 must be installed first.''
 
 
* ''There is a separate Upgrade procedure for [[INCA Station Software upgrade|INCA IP stations.]]''
 
* ''There is a separate Upgrade procedure for [[INCA Station Software upgrade|INCA IP stations.]]''
 
* ''If the station is used in SIP mode, also [[Automatic Software Upgrade|Automatic Updates]] can be defined.'' }}
 
* ''If the station is used in SIP mode, also [[Automatic Software Upgrade|Automatic Updates]] can be defined.'' }}
<div style="text-align:left;"> <youtube width="300" height="180">ijdtJzhWmRI</youtube> </div>
+
<div style="float:right;"> <youtube width="300" height="180">WS-ysJCOYcI</youtube> </div>
<br><br>
 
== Upgrade Turbine to latest version ==
 
  
 +
There are two ways of updating the software of these devices from the web interface:
 +
* By using an [[#Upgrade by using an external TFTP server|external TFTP server]], or
 +
* By uploading an image file (or drag and drop the image file) to the "Software Upgrade" page of the station. '''Note:''' This option is available only to [[#Devices with Recovery OS|stations with Recovery OS]].
 +
 +
== Upgrade using the IMT-tool==
 +
Upgrade of station can be done from the Windows PC tool [[IMT|VS-IMT]], see the article [[IMT - Discover & Upgrade]].
 +
 +
<br>
 +
 +
== Upgrade by using an external TFTP server ==
 
===Prerequisites===
 
===Prerequisites===
# Current version must be 4.2 or higher. To upgrade from older versions, see later in this article.
+
# Current version '''must be 4.7.3.2 or higher'''. To upgrade from older versions, [[Upgrading Turbine Devices running firmware between 3.0.x.x and 4.2.x.x|see this article]].
# A TFTP Server must be available on your laptop.
+
# A TFTP Server must be available on your laptop.  A TFTP server can be downloaded from here: http://tftpd32.jounin.net/tftpd32_download.html.
# Download the software package '''[[Downloads#Stations_and_Devices|vsft-6.x.x.x.zip]]''', and unzip the package and store the files in a folder on your PC.
+
# Download the software package '''[[Downloads#Stations_and_Devices|vsft-8.x.x.x.zip]]''', and '''unzip the package''' and store the files in a folder on your PC.
 
# Check if your local firewall is '''not''' blocking incoming ping/ICMP  (Turbine station is pinging TFTP Server during update process)
 
# Check if your local firewall is '''not''' blocking incoming ping/ICMP  (Turbine station is pinging TFTP Server during update process)
 
<br>
 
<br>
  
 
=== Upgrade procedure ===
 
=== Upgrade procedure ===
The upgrade is  a two step process:
+
# Start the TFTP server program and click '''Browse''', and select the folder where the 8.x.x.x software files are located
* First step is to update the '''bootloader environment'''
+
# [[Logging into an IP Station|Log on to the Turbine Station]] web interface. Select '''Station Administration''' > '''Manual Upgrade'''
* Second step is to update the station '''firmware'''  
+
# Enter the IP address of the '''TFTP server''' (I.e. the IP address of your laptop)
 
+
# Enter Image file: '''vsft-8.x.x.x'''
1. Start the TFTP server program and click '''Browse''', and select the folder where the version 6.x.x.x software files are located
+
# '''Save Settings'''
 +
# '''Upgrade'''
  
[[File:Upgrade 6130 TFTP.PNG|thumb|left|500px|TFTP Server - Browse to the folder where the software files are located]]
+
[[File:Upgrade to 7.1.3.0.PNG|thumb|left|700px|Example: Upgrade to the latest the firmware from TFTP Server 10.9.9.217]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
2.  [[Logging into an IP Station|Log on to the Turbine Station]] web interface. Default login credentials are '''admin''' and '''alphaadmin'''. Select '''Station Administration''' > '''Manual Upgrade'''
 
 
3.  Enter the IP address of the '''TFTP server''' (I.e. the IP address of your PC)
 
 
4.  Enter the image file prefixed by "boot": '''boot/vsft-6.x.x.x''', and click '''Save settings'''. Wait a few seconds for the page to refresh, then press '''Upgrade'''.  The station will now reboot. This process will upgrade the boot loader environment. For more details about this process, see [[Turbine bootloader upgrade]]
 
  
[[File:Turbine Upgrade 61.PNG|thumb|left|500px|Load '''boot/vsft-6.x.x.x''' to upgrade the boot environment. Press '''Save Settings''', then '''Upgrade''']]
+
The device will restart with the new firmware installed.  
<br style="clear:both;" />
 
 
 
5.  When the station is back online, enter the image file: '''vsft-6.x.x.x''', and click '''Save settings'''. Wait a few seconds for the page to refresh, then press '''Upgrade'''. This process will upgrade the station firmware.
 
 
 
[[File:Turbine Upgrade 61 2.PNG|thumb|left|500px|Load '''vsft-6.x.x.x''' to upgrade the station firmware]]
 
<br style="clear:both;" />
 
  
 
The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the '''Log viewer''' tab in the TFTP server program.
 
The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the '''Log viewer''' tab in the TFTP server program.
  
{{note|If video is not working after having upgraded the [[:Category:Stations#Turbine_stations|Turbine Video Station TCIV-x]] to firmware version 4.11, see article [[TCIV - No video after upgrading to v. 4.11]]}}
 
 
<br>
 
<br>
  
== Upgrade from version 3.0 ==
+
== Devices with Recovery OS ==
The upgrade is a three-step process:
+
As from firmware version 5.1.3.0 a Recovery Operating System, '''Recovery OS''', has been added in addition to the Main OS.
# Install version 3.0.3.5, then
 
# Install version 4.7.3.0, then
 
# Install version 4.11.3.0
 
  
<br>
+
{{note|
 +
* ''"Recovery OS" is available only on Turbine devices that '''come from factory''' with software version 5.1 or higher preinstalled (approx. from March 2020)'' <br>
 +
* ''When upgrading to firmware 5.1. or later in the field, "Recovery OS" will not be included'' }}
  
===Prerequisites===
+
The Recovery OS supports:
# A TFTP Server must be available. A TFTP server can be downloaded from here: http://tftpd32.jounin.net/tftpd32_download.html.
+
* Software upgrade in IPv6 network
# Download the software package '''[[Downloads#Turbine_stations|tsi-3.0.3.5.zip]]''', and unzip the package and store the files in a folder on your PC.
+
* Software upgrade when device is using [[IEEE 802.1X|802.1X authentication]]
# Download the software package '''[[Downloads#Turbine_stations|sti-prod-4.7.3.0.zip]]''', and unzip the package and store the files in a different folder on your PC.
+
* Software upgrade via HTTP/HTTPS protocol using '''.swu''' image
# Download the latest software package '''[[Downloads#Turbine_stations|vsft-6.x.x.x]]''', and unzip the package and store the files in a different folder on your PC.
 
# Check if your local firewall is '''not''' blocking incoming ping/ICMP  (Turbine station is pinging TFTP Server during update process)
 
  
<br>
+
Devices with Recovery OS support both the new method for software upgrade (using '''.swu''' file), as well as the original method (using '''.zip''' file and TFTP server).
  
=== Upgrade procedure ===
+
[[File:Turbine Upgr Both.PNG|thumb|left|500px|Choose between upgrading using '''.swu''' file, or using TFTP server and '''.zip''' file]]
 
 
1. Start the TFTP server program and click '''Browse''', and select the folder where the version 3.0.3.5 software files are located
 
 
 
[[File:TFTP 3035.PNG|thumb|left|500px|TFTP Server - Browse to the folder where the software files are located]]
 
<br style="clear:both;" />
 
 
 
2.  Log on to the Turbine Station web interface. Default login credentials are '''admin''' and '''alphaadmin'''. Select '''Station Administration''' > '''Manual Upgrade'''
 
 
 
3.  Enter the IP address of the '''TFTP server''' (I.e. the IP address of your PC)
 
 
 
4.  Enter the image file: '''tsi-3.0.3.5''', and click '''Save settings'''
 
 
 
[[File:TurbineTo 3035.PNG|thumb|left|500px|Load '''tsi-3.0.3.5''' via the station web interface]]
 
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
:The station will now contact the TFTP server and download the files. The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the '''Log viewer''' tab in the TFTP server program.
+
In order to upgrade software using the .swu file:
 
+
* Press the ''upper'' '''Start Upgrade''' button
 
+
* The station will now reboot, and start in "Recovery OS" mode
When the station is up and running again, the next step is to install version 4.7.3.0:
 
  
5. In the TFTP server program, '''Browse''' to the folder where the version 4.7.3.0 software files are located
+
[[File:Turbine Recovery.PNG|thumb|left|500px|Turbine device in "Recovery OS" mode]]
 
 
6. In the Turbine web interface enter the image file: '''tsi2sti-4.7.3.0.ipk''', and '''Save settings'''
 
 
 
[[File:TurbineTo4730.PNG|thumb|left|500px|Installing '''tsi2sti-4.7.3.0.ipk''' via the station web interface]]
 
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
The station will again contact the TFTP server and download and install the required files.
+
* Now click inside the "Software Update" field and upload the image file (e.g. '''vsft-8.0.3.2.swu'''), or drag and drop the image file onto this field
 
+
* The progress of the installation is shown. When finished installation the station will reboot, and start in regular mode.
7. The final step is to install version 6.x.x.x. This process is described in the first paragraph of this article: [[#Upgrade Turbine to latest version]]
 
  
 
<br>
 
<br>
  
==Upgrade from version 3.1, 4.0, 4.1==
+
==Upgrade from versions between 3.0 and 4.2==
For upgrade from version 3.1, 4.0, 4.1 see article: [[Upgrade Turbine stations from 3.1, 4.0 or 4.1]]
+
To upgrade devices currently running a version between 3.0.x.x and 4.2.x.x, see article: [[Upgrading Turbine Devices running firmware between 3.0.x.x and 4.2.x.x]]
  
 
<br>
 
<br>
  
 
== Upgrade in 802.1x environment ==
 
== Upgrade in 802.1x environment ==
During an upgrade of the IP station, 802.1X will not be running. Thus if 802.1X reauthentication is enabled and is performed during the upgrade, the IP station will lose contact with the TFTP server (depending on the configuration when 802.1X authentication fails). If the IP station loses contact with the TFTP server, it will not be upgraded.
+
Devices with Recovery OS can be upgraded also when the station uses 801.1x authentication. For more details, see [[IEEE 802.1X]]
  
 +
<br>
  
 
==Troubleshooting==
 
==Troubleshooting==

Latest revision as of 11:11, 4 December 2023

AEIPS.png

This article describes how to upgrade the software of the Turbine series of intercom devices via the web interface of the station.

Note icon
  • The procedure described in this article is applicable to the following devices: TCIS-x, TCIV-x, TKIS-2, TMIS-x, TFIE-x, TKIE-x, TFIX-x, IP-LCM, ECPIR-3P, Exigo IP speakers. Exigo Network Amplifiers, and ENA-2060DC1
  • For mass upgrade of stations it is recommended to use the VS-IMT tool, see the article IMT - Discover & Upgrade.
  • Using Turbine version 4.7.3.2 or higher, you can downgrade to VSF-Turbine version 4.2.3.17, but not to any older version.
  • There is a separate Upgrade procedure for INCA IP stations.
  • If the station is used in SIP mode, also Automatic Updates can be defined.


There are two ways of updating the software of these devices from the web interface:

Upgrade using the IMT-tool

Upgrade of station can be done from the Windows PC tool VS-IMT, see the article IMT - Discover & Upgrade.


Upgrade by using an external TFTP server

Prerequisites

  1. Current version must be 4.7.3.2 or higher. To upgrade from older versions, see this article.
  2. A TFTP Server must be available on your laptop. A TFTP server can be downloaded from here: http://tftpd32.jounin.net/tftpd32_download.html.
  3. Download the software package vsft-8.x.x.x.zip, and unzip the package and store the files in a folder on your PC.
  4. Check if your local firewall is not blocking incoming ping/ICMP (Turbine station is pinging TFTP Server during update process)


Upgrade procedure

  1. Start the TFTP server program and click Browse, and select the folder where the 8.x.x.x software files are located
  2. Log on to the Turbine Station web interface. Select Station Administration > Manual Upgrade
  3. Enter the IP address of the TFTP server (I.e. the IP address of your laptop)
  4. Enter Image file: vsft-8.x.x.x
  5. Save Settings
  6. Upgrade
Example: Upgrade to the latest the firmware from TFTP Server 10.9.9.217



The device will restart with the new firmware installed.

The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the Log viewer tab in the TFTP server program.


Devices with Recovery OS

As from firmware version 5.1.3.0 a Recovery Operating System, Recovery OS, has been added in addition to the Main OS.

Note icon
  • "Recovery OS" is available only on Turbine devices that come from factory with software version 5.1 or higher preinstalled (approx. from March 2020)
  • When upgrading to firmware 5.1. or later in the field, "Recovery OS" will not be included


The Recovery OS supports:

  • Software upgrade in IPv6 network
  • Software upgrade when device is using 802.1X authentication
  • Software upgrade via HTTP/HTTPS protocol using .swu image

Devices with Recovery OS support both the new method for software upgrade (using .swu file), as well as the original method (using .zip file and TFTP server).

Choose between upgrading using .swu file, or using TFTP server and .zip file


In order to upgrade software using the .swu file:

  • Press the upper Start Upgrade button
  • The station will now reboot, and start in "Recovery OS" mode
Turbine device in "Recovery OS" mode


  • Now click inside the "Software Update" field and upload the image file (e.g. vsft-8.0.3.2.swu), or drag and drop the image file onto this field
  • The progress of the installation is shown. When finished installation the station will reboot, and start in regular mode.


Upgrade from versions between 3.0 and 4.2

To upgrade devices currently running a version between 3.0.x.x and 4.2.x.x, see article: Upgrading Turbine Devices running firmware between 3.0.x.x and 4.2.x.x


Upgrade in 802.1x environment

Devices with Recovery OS can be upgraded also when the station uses 801.1x authentication. For more details, see IEEE 802.1X


Troubleshooting

In the case the upgrade is not successful it may be due to a windows setting.

If the upgrade is not successful when using the default static IP, it may be due to a network setting.

  • Please check the station's subnet mask. If it is 255.255.0.0, change it to 255.255.255.0 and try again