Actions

Difference between revisions of "Turbine Software Upgrade"

From Zenitel Wiki

(Installing Recovery OS)
 
(196 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This article describes how to upgrade the software of the [[Turbine series|Turbine series of intercom devices]] to version 4.2.3.9. Note that there is a separate Upgrade procedure for [[IP Station Software upgrade|INCA IP stations]].
+
{{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.  
  
There are two recommended ways of upgrading the software on the Turbine station:  
+
{{Note|
* Using the [[IMT|VS-IMT Intercom Management Tool]]  
+
* ''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'''''
* Using the web interface of the station it self
+
* ''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.''
 +
* ''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.'' }}
 +
<div style="float:right;"> <youtube width="300" height="180">WS-ysJCOYcI</youtube> </div>
  
The VS-IMT tool allows mass upgrade of stations.
+
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 TCIS or TKIS-2 (Turbine Compact) from version 3.0.x.x ==
+
== Upgrade using the IMT-tool==
===Upgrade using the VS-IMT tool ===
+
Upgrade of station can be done from the Windows PC tool [[IMT|VS-IMT]], see the article [[IMT - Discover & Upgrade]].
  
====Prerequisites====
+
<br>
# Download and install the [[Downloads#VS-IMT_-_Intercom_management_Tool|VS-IMT tool]]
 
# Download the software package [[Downloads#Turbine_stations|tsi-3.0.3.5.zip]]. Don't unzip the file.
 
# Download the software package [[Downloads#Turbine_stations|sti-prod-4.2.3.9.zip]]. Don't unzip the file.
 
  
==== Upgrade procedure ====
+
== Upgrade by using an external TFTP server ==
 +
===Prerequisites===
 +
# 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 can be downloaded from here: http://tftpd32.jounin.net/tftpd32_download.html.
 +
# 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)
 +
<br>
  
* Start the VS-IMT tool
+
=== Upgrade procedure ===
* Select '''Create project''' or open an existing project, and start the wizard that takes you through the discovery and upgrade process, by selecting '''File''' > '''Launch Station Wizard'''
+
# Start the TFTP server program and click '''Browse''', and select the folder where the 8.x.x.x software files are located
* Press '''Next''' to go to Station Discovery. Enter the range of IP addresses (From - To) to search for, and press '''Search'''
+
# [[Logging into an IP Station|Log on to the Turbine Station]] web interface. Select '''Station Administration''' > '''Manual Upgrade'''
* When the discovery process is finished, select all stations in the list by checking the '''Select All''' flag
+
# Enter the IP address of the '''TFTP server''' (I.e. the IP address of your laptop)
 
+
# Enter Image file: '''vsft-8.x.x.x'''
[[File:IMT SelectAll.PNG|thumb|left|500px|Station Discovery window]]
+
# '''Save Settings'''
<br style="clear:both;" />
+
# '''Upgrade'''
* Press '''Next''' two times. You've now come to the "Upgrade Stations" window:
 
 
 
[[File:IMT UpgradeWin.PNG|thumb|left|500px|The Upgrade Stations window]]
 
<br style="clear:both;" />
 
 
 
* Now the software packages must be imported into the VS-IMT tool:
 
** Select '''Import image...''', and browse to the '''tsi-3.0.3.5.zip''' file, and select '''Open'''
 
** Select '''Import image...''' again, and browse to the '''sti-prod-4.2.3.9.zip''' file, and select '''Open'''
 
 
 
* The next step is to upgrade the Turbine stations to 3.0.3.5:
 
** Select the Turbine Image = '''tsi-3.0.3.5'''
 
** In the list box, select the stations to upgrade. Use '''Ctrl + click''' to select multiple stations.
 
  
[[File:IMT UpgradeReady.PNG|thumb|left|500px|Turbine image and stations selected, ready to start the upgrade]]
+
[[File:TFTP Upgrade 8231.PNG|thumb|left|700px|Example: Upgrade to the latest the firmware from TFTP Server 10.9.8.188]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
 
:* Press the '''Upgrade''' button to start the upgrade process. The status is shown on the screen. The Status will become '''''Success''''' when the station is up and running after the upgrade.
 
  
  
* The next step is to upgrade the Turbine stations to 4.2.3.9:
+
The device will restart with the new firmware installed.  
** Select the Turbine Image = '''sti.prod-4.2.3.9'''
 
** Check the flag "''Enable upgrades requiring boot/environment version upgrade''"
 
** In the list box, select the stations to upgrade. Use '''Ctrl + click''' to select multiple stations.
 
  
[[File:IMT Upgrade4230.PNG|thumb|left|500px|Turbine image and stations selected, upgrade in process]]
+
The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the '''Log viewer''' tab in the TFTP server program.
<br style="clear:both;" />
 
  
:* Press the '''Upgrade''' button to start the upgrade process. The status is shown on the screen. The Status will become '''''Success''''' when the station is up and running after the upgrade.
+
<br>
  
===Upgrade using the Web Interface of the station ===
+
== 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.
  
====Prerequisites====
+
{{note|
# A TFTP Server must be available. A TFTP server can be downloaded from here: http://tftpd32.jounin.net/tftpd32_download.html.
+
* ''"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>
# Download the software package '''tsi-3.0.3.5.zip''', and unzip the package and store the files in a folder on your PC.
+
* ''When upgrading to firmware 5.1. or later in the field, "Recovery OS" will not be included'' }}
# Download the software package '''sti-prod-4.2.3.9.zip''', 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)
 
  
==== Upgrade procedure ====
+
The Recovery OS supports:
The upgrade is a two-step process:
+
* Software upgrade in IPv6 network
* First install version 3.0.3.5, then
+
* Software upgrade when device is using [[IEEE 802.1X|802.1X authentication]]
* Install version 4.2.3.9
+
* Software upgrade via HTTP/HTTPS protocol using '''.swu''' image
  
1. Start the TFTP server program and click '''Browse''', and select the folder where the version 3.0.3.5 software files are located
+
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).
  
[[File:TFTP 3035.PNG|thumb|left|500px|TFTP Server - Browse to the folder where the software files are located]]
+
[[File:Turbine Upgr Both.PNG|thumb|left|500px|Choose between upgrading using '''.swu''' file, or using TFTP server and '''.zip''' file]]
 
<br style="clear:both;" />
 
<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'''
+
In order to upgrade software using the .swu file:
 
+
* Press the ''upper''  '''Start Upgrade''' button
3.  Enter the IP address of the '''TFTP server''' (I.e. the IP address of your PC)
+
* The station will now reboot, and start in "Recovery OS" mode
 
 
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]]
+
[[File:Turbine Recovery.PNG|thumb|left|500px|Turbine device in "Recovery OS" mode]]
 
<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.
+
* Now click inside the "Software Update" field and upload the image file (e.g. '''vsft-8.2.3.1.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.
  
 +
<br>
  
When the station is up and running again, the next step is to install version 4.2.3.9:
+
== Installing Recovery OS ==
 +
Recovery OS is not included in Turbine devices produced before approx. March 2020. It is possible to install Recover OS by following this procedure:
  
5. In the TFTP server program, '''Browse''' to the folder where the version 4.2.3.9 software files are located
+
# Start the TFTP server program and click '''Browse''', and select the folder where the 8.x.x.x software files are located
 
+
# [[Logging into an IP Station|Log on to the Turbine Station]] web interface. Select '''Station Administration''' > '''Manual Upgrade'''
6. In the Turbine web interface enter the image file: '''tsi2sti-4.2.3.9.ipk''', and '''Save settings'''
+
# Enter the IP address of the '''TFTP server''' (I.e. the IP address of your laptop)
 +
# Enter Image file: '''recovery/vsft-8.x.x.x''' (Note the text "recovery" in front of the software version).
 +
# '''Save Settings'''
 +
# '''Upgrade'''
  
[[File:TurbineTo 4236.PNG|thumb|left|500px|Installing '''tsi2sti-4.2.3.9.ipk''' via the station web interface]]
+
[[File:TFTP Recovery 8231.PNG|thumb|left|700px|Installing "Recovery OS" on a Turbine device]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
The station will again contact the TFTP server and download and install the required files.
 
 
== Upgrade Turbine stations from 3.1, 4.0, 4.1 or 4.2 ==
 
 
=== Upgrade using VS-IMT ===
 
Turbine stations with software version 3.1.x.x, 4.0.x.x, 4.1.x.x or 4.2.x.x are upgraded using the '''sti-4.2.3.9''' package. Note that in some cases boot loader also need to be upgraded and it is necessary to enable such upgrades.
 
 
====Prerequisites====
 
# Download and install the [[Downloads#VS-IMT_-_Intercom_management_Tool|VS-IMT tool]]
 
# Download the software package [[Downloads#Turbine_stations|sti-4.2.3.9.zip]]. Don't unzip the file.
 
 
==== Upgrade procedure ====
 
 
* Start the VS-IMT tool
 
* Select '''Create project''' or open an existing project, and start the wizard that takes you through the discovery and upgrade process, by selecting '''File''' > '''Launch Station Wizard'''
 
* Press '''Next''' to go to Station Discovery. Enter the range of IP addresses (From - To) to search for, and press '''Search'''
 
* When the discovery process is finished, select all stations in the list by checking the '''Select All''' flag
 
* Press '''Next''' two times. You've now come to the "Upgrade Stations" window:
 
* Import the image file into the VS-IMT tool by selecting '''Import image...''', and browse to the '''sti-4.2.3.9.zip''' file, and select '''Open'''
 
* Select the Turbine Image = '''sti-4.2.3.9'''
 
* In the list box, select the stations to upgrade. Use '''Ctrl + click''' to select multiple stations.
 
* Press the '''Upgrade''' button to start the upgrade process. The status is shown on the screen. The Status will become '''''Success''''' when the station is up and running after the upgrade.
 
<br><br>
 
=== Manual Upgrade from Station Web ===
 
 
==== Upgrade TFIE/TFIX/TKIE (Turbine Industrial Stations) from version 3.1.x.x ====
 
 
* [[Downloads#Turbine_station|Download]] the image file: sti-4.2.3.9.zip<br>
 
* Unzip the file to a folder
 
* Start the TFTP server program and '''Browse''' to the folder where the files are located
 
 
Upgrade process:<br>
 
From the Station web page, '''Station Administration''' > '''Manual Upgrade''', enter:
 
 
# Image file: '''boot/sti-4.2.3.9'''
 
# '''Save Settings'''
 
# '''Upgrade''' (Turbine will restart)
 
# Image file: '''sti-4.2.3.9'''
 
# '''Save Settings'''
 
# '''Upgrade''' (Turbine will restart)
 
 
==== Upgrade TCIV (Turbine Video station) from version 4.0.x.x or 4.1.x.x ====
 
  
* [[Downloads#Turbine_station|Download]] the image file: sti-4.2.3.9.zip<br>
+
The device will restart with the firmware installed.  
* Unzip the file to a folder
 
* Start the TFTP server program and '''Browse''' to the folder where the files are located
 
  
Upgrade process:<br>
+
The upgrade procedure takes about 3 minutes. The process can be monitored by clicking the '''Log viewer''' tab in the TFTP server program.
From the Station web page, '''Station Administration''' > '''Manual Upgrade''', enter:
 
  
# Image file: '''boot/sti-4.2.3.9'''
+
When going to '''Station Administration''' > '''Manual Upgrade''', you should now have the option do software upgrade using the Recovery OS, as described in [[#Devices with Recovery OS]].
# '''Save Settings'''
 
# '''Upgrade''' (Turbine will restart)
 
# Image file: '''video/sti-4.2.3.9'''
 
# '''Save Settings'''
 
# '''Upgrade''' (Turbine will restart)
 
# Image file: '''sti-4.2.3.9'''
 
# '''Save Settings'''
 
# '''Upgrade''' (Turbine will restart)
 
  
Note! after the step '''video/sti-4.2.3.9''' you will probably have no intercom service running and now detailed version info in web. That is ok, just continue to next upgrade step '''sti-4.2.3.9''' and all should be ok in the end.
+
<br>
  
==== Upgrade TMIS (Turbine Mini) from version 4.1.x.x ====
+
==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]]
  
* [[Downloads#Turbine_station|Download]] the image file: sti-4.2.3.9.zip<br>
+
<br>
* Unzip the file to a folder
 
* Start the TFTP server program and '''Browse''' to the folder where the files are located
 
  
Upgrade process:<br>
+
== Upgrade in 802.1x environment ==
From the Station web page, '''Station Administration''' > '''Manual Upgrade''', enter:
+
Devices with Recovery OS can be upgraded also when the station uses 801.1x authentication. For more details, see [[IEEE 802.1X]]
  
# Image file: '''boot/sti-4.2.3.9'''
+
<br>
# '''Save Settings'''
 
# '''Upgrade''' (Turbine will restart)
 
# Image file: '''sti-4.2.3.9'''
 
# '''Save Settings'''
 
# '''Upgrade''' (Turbine will restart)
 
  
 
==Troubleshooting==
 
==Troubleshooting==
Line 177: Line 113:
 
*For Windows7: [http://www.sysprobs.com/enable-ping-reply-windows-7 http://www.sysprobs.com/enable-ping-reply-windows-7]
 
*For Windows7: [http://www.sysprobs.com/enable-ping-reply-windows-7 http://www.sysprobs.com/enable-ping-reply-windows-7]
  
 +
*For Windows10: [http://www.sysprobs.com/enable-ping-reply-and-ftp-traffic-in-windows-10-and-server http://www.sysprobs.com/enable-ping-reply-and-ftp-traffic-in-windows-10-and-server]
  
 +
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
  
[[Category:Turbine]]
+
[[Category: Turbine - Restore Factory Defaults and Software Upgrade]]

Latest revision as of 15:00, 6 June 2024

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.8.188



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.2.3.1.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.


Installing Recovery OS

Recovery OS is not included in Turbine devices produced before approx. March 2020. It is possible to install Recover OS by following this 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: recovery/vsft-8.x.x.x (Note the text "recovery" in front of the software version).
  5. Save Settings
  6. Upgrade
Installing "Recovery OS" on a Turbine device



The device will restart with the 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.

When going to Station Administration > Manual Upgrade, you should now have the option do software upgrade using the Recovery OS, as described in #Devices with Recovery OS.


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