Actions

Difference between revisions of "VS-IMT Upgrade Stations"

From Zenitel Wiki

(Upgrade Stations already included in the project)
(Troubleshooting)
 
(84 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{APS}}
+
{{AEIPS}}
This article describes how to upgrade the software of the [[:Category:INCA_Stations|Inca series]] and the [[:Category:Turbine|Turbine series]] of intercom devices, as well as the [[Flowire]] to the latest version via the [[IMT|VS-IMT]] tool.
 
 
 
It is also possible to upgrade the software using the web interface of the station/Flowire:
 
* [[Turbine Software Upgrade|Turbine]]
 
* [[INCA Station Software upgrade|Inca]]
 
* [[Flowire Software Upgrade Procedure|Flowire]]
 
  
 +
This article describes how to upgrade (or downgrade) the firmware of Zenitel IP devices using the [[IMT|VS-IMT]] PC tool.
 +
__TOC__
 +
<div style="text-align:right;"> <youtube width="300" height="180">3zihEBIEprc</youtube>  </div>
 +
<br><br>
 
==Prerequisites==
 
==Prerequisites==
# Download and install the [[Downloads#VS-IMT - Intercom management Tool|VS-IMT tool]]
+
*Download and install the [[Downloads#Applications_and_Tools|VS-IMT tool]] on a Windows computer. Make sure you are using the latest version of the software.
# Download the desired image file. Don't unzip the file.
+
*Download the latest Device Firmware Package [[Downloads#Vingtor-Stentofon_Intercom_Suite_.28VS-IS.29|VS-IS_6.x.x.x.zip]], and store it on your computer. Make a note of the location. Don't unzip the file. The VS-IS Device Firmware Package is a collection of firmware images for most types of Zenitel IP intercoms and devices.
:: [[Downloads#Turbine_stations|Turbine Image file download]]
 
:: [[Downloads#INCA_Stations|Inca Image file download]]
 
:: [[Downloads#Flowire|Flowire Image file download]]
 
 
 
Run the [[VS-IMT Station Wizard|station wizard]] and perform the [[VS-IMT Discover Stations|discovery]] and the [[VS-IMT Identify Stations|identify]] process. The next step in the wizard will then be the upgrade section.
 
 
 
===Adding image files to library===
 
[[File:ImportImage.png|thumb|right|134x152px]]
 
Available Turbine images can be seen from drop-down menu of the same name. Adding additional images to the list can be performed with "'''Import image...'''" function.
 
 
 
Click on the button and navigate to .zip image previously downloaded from Zenitel site. This is recommended way to add software images.
 
 
 
'''Manually adding software images''' <br/>
 
See the [[VS-IMT_Troubleshooting_%26_Technical_Background#Station_firmware_upgrade|VS-IMT Troubleshooting]] article.
 
<br style="clear:both;" />
 
 
 
== Upgrade ==
 
VS-IMT can upgrade all stations to the latest software. It is station type-aware and will use the correct image file for the upgrade. A built-in file transfer server can upgrade many stations in parallel which makes it the most efficient way to upgrade Vingtor-Stentofon IP stations (only Flowire devices will be upgraded sequentially, one-by-one).
 
 
 
Software image files for IP intercom stations need to be downloaded to the PC and imported into VS-IMT before starting the upgrade process. The '''Import image''' feature will extract the image into the VS-IMT software repository on the local disk.
 
 
 
Some upgrades of Turbine IP intercoms require specific image packages – sti-prod-4.x.x.x. The table below shows the correct Turbine image file versions to use.
 
 
 
{| class="wikitable"
 
!Current version
 
!Desired version
 
!Image file to use
 
!What to do
 
|-
 
|3.0.3.4 or earlier
 
|3.0.x.x
 
|tsi-3.0.x.x
 
|Normal upgrade
 
|-
 
|3.0.3.4 or earlier
 
|4.2+
 
|tsi-3.0.3.5 and then sti-prod-4.x.x.x
 
|First, upgrade station to 3.0.3.5 and then to required 4.2+.
 
|-
 
|3.0.3.5 / 3.0.3.6
 
|4.2+
 
|sti-prod-4.x.x.x
 
|Check '''Enable upgrades requiring boot/environment version upgrade''' box and then normal upgrade
 
|-
 
|3.1.x.x / 4.1.x.x
 
|4.2+
 
|sti-4.x.x.x
 
|Check '''Enable upgrades requiring boot/environment version upgrade''' box and then normal upgrade
 
|-
 
|4.2+
 
|4.2+
 
|sti-4.x.x.x
 
|Normal upgrade
 
|-
 
|4.x.x.x
 
|4.x.x.x
 
|zenitel-flowire-4.x.x.x
 
|Normal upgrade
 
|-
 
|}
 
  
'''Note:''' Upgrading Turbines with software version 3.0.3.4 or earlier requires a two-step upgrade. They first need to be upgraded with tsi-3.0.3.5 image and then with sti-prod-4.2.x.x or sti-prod-4.7.x.x image.
+
== Upgrade procedure ==
 +
#Start IMT, select '''Discover & Upgrade''' from main menu
 +
#Enter '''From''' - '''To''' IP address range
 +
#Change credentials if default username/password is not used on the devices
 +
#Press '''Search''' to start the discovery process
 +
#When the search process is finished, select '''Import Image'''…, and browse to the '''VS-IS_6.x.x.x.zip''' file
 +
#Select which devices to upgrade by '''Ctrl+Click''' (individual devices), '''Shift+Click''' (range of devices) or '''Ctrl+A''' (all devices). Selected devices are highlighted in blue color. The IMT will update up to 8 devices in parallel
 +
#If your computer has several Ethernet interfaces, select the one which is on the same network as the Zenitel devices ("'''Choose TFTP server IP address'''")
 +
#Press '''Upgrade'''
 +
#The Status column shows the upgrade process. Wait for all upgrades to complete.The status will be reported '''Success''' when a device is up and running with the new firmware.
  
Trying to upgrade 3.0.3.4 directly with sti-prod-4.2.x.x or sti-prod-4.7.x.x will result with "unsupported" warning message.
 
[[File:IMT-StiProd.png|none|thumb|518x518px]]
 
<br style="clear:both;" />
 
  
=== How to upgrade IP Stations ===
+
[[File:IMT Discover Upgrade.png|thumb|800px|left|Discovery and Upgrade]]
# Select target software versions in the '''Station software images''' panel: <br> Select a desired software version used for the upgrade of every device type type: Turbine, INCA, Dual-Display and Flowire.
 
# Check the '''Software''' and '''Upgrade To''' column to decide which stations to upgrade
 
# Enable boot/environment upgrades: <br> Check '''Enable upgrades requiring boot/environment version upgrade''' box. <br> Upgrades including bootloader update will be run at the end.
 
# Start Upgrade: <br> Mark multiple (Shift+click or Ctrl+click) or all (Ctrl+a) stations for multi-selection and click the '''Upgrade''' button to initiate the upgrade process.
 
[[File:Wizard-Upgrade-Prepare.png|none|thumb|1388x1388px|'''Upgrade stations step''']]
 
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
'''Note:''' ''Turbine'' firmware upgrades that require a boot/environment upgrade are by default disabled due to the fact that such upgrade is risky in case something goes wrong in the upgrade process (power outage, network down, etc.). In case of a failure, all other remaining upgrades will be stopped. DO NOT power down stations or make any network changes while the upgrade is in progress.
+
== Troubleshooting ==
 +
If the you get the response "'''Upgrade failed'''", check the following:
 +
* '''Computer with multiple ethernet interfaces''': Check point 7 above, in case your computer has multiple ethernet interfaces
 +
* '''No DHCP server present''': If the station is set to obtain IP address from a DHCP server (default), and there is no DHCP server present, the station will use a random 169.254.x.x address. Upgrade might fail in this situation. To rectify this, either set a static IP address, or connect the station to a network with a DHCP server present.
 +
* '''Old "bootloader" version''': If the station has an outdated Bootloader (a small software module used during startup), the upgrade will fail. You can check if that is the case by selecting the station from the list, and read the bootloader version from the Information and Status field:
  
 
+
[[File:IMT Failed.PNG|thumb|800px|left|Upgrade failed due to old bootloader software]]
Once upgrade is initiated, wait for all upgrades to complete. IMT pushes new software image to all selected stations and initiates upgrade on each  station. Once image is flashed to station and station is booted again, IMT checks if station got new version and reports that in "Status" column". You may run as many upgrades in a row as you want. And in case upgrade fails, you may always try to run upgrade again on the same station(s).
 
 
 
[[File:Wizard-Upgrade-Progress.png|none|thumb|1574x1574px|'''Station Upgrade in Progress''']]
 
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
If a station fails to upgrade or in case of any other problems, see [[VS-IMT Troubleshooting & Technical Background]].
+
If either the Bootloader and/or Bootenv version is from 2015, the upgrade will terminate with the failure message. If this is the case, the station must be updated using the "'''Configuration Manager'''" option on the start menu of the IMT tool.
  
=== How to upgrade Flowires ===
 
Flowires cannot be upgraded together with stations.
 
* Select all Flowires and press upgrade.
 
* The application will upgrade them all one by one.
 
  
==Upgrade Stations already included in the project==
+
If a device fails to upgrade or in case of any other problems, see also [[VS-IMT Troubleshooting & Technical Background]].
Devices in an existing project can be upgraded directly without running the wizard. To start upgrade:
+
<br>
* Select '''File''' -> '''Upgrade Stations''' (or press '''CTRL+U''')
+
<br>
Upgrade stations window behaves the same as the Upgrade stations step in discovery wizard - VS-IMT Basic Intercom System Setup#(IMT)FSVS-IMTBasicIntercomSystemSetup-StationUpgrade.
 
  
imtUpgradeStations
+
=== Notes ===
[[File:ImtUpgradeStationsMain.png|none|thumb|1508x1508px]]
 
<br style="clear:both;" />
 
  
 +
{{note|'''Upgrade from Turbine ver. 3.x''':
 +
* When upgrading from version '''3.1''' and later, one can update directly to the final version, e.g. '''vsft-4.11.3.0'''
 +
* Upgrade from version '''3.0.3.5/3.0.3.6''': First update to '''sti-prod-4.7.3.0''', and finally '''vsft-4.11.3.0'''
 +
* Upgrade from version '''3.0.3.4''' or earlier: First update to '''tsi-3.0.3.5''', then to '''sti-prod-4.7.3.0''', and finally '''vsft-4.11.3.0''' }}
 +
{{note|'''Flowire notes''':
 +
* FCDC3 is supported as from IMT ver. 1.6.3.0
 +
* Flowire units cannot be upgraded at the same time as other device types. Flowire units must be upgraded separately.
 +
* Flowires will be upgraded sequentially, one-by-one
 +
* Upgrade of a Flowire device is disabled if the device has an IP Address in the range '''169.254.1.x''' }}
 +
{{note|'''Turbine Video Station TCIV-x notes''':
 +
* 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]] }}
  
Previous step: [[VS-IMT Identify Stations]]
+
{{note|'''IC-Edge vs Pulse systems''':
 +
* In an IC-Edge system the minimum firmware requirement is Turbine ver. 5.x and INCA ver. 2.10.x.x. This is a requirement for all devices in the system.
 +
* In a Pulse system all devices must be running Turbine firmware 4.x and/or INCA firmware 2.9.x.x (or older versions)
 +
* If you have Turbine device with version 5.x, or an INCA device with version 2.10 or newer (i.e. IC-Edge), and want to use them in a Pulse system, you need to downgrade the Turbine to ver. 4.11.3.x, and the INCA station to version 2.9.3.x. Use the download links at the top of this article to get the firmware, and use the procedure described in this article to perform the downgrade}}
  
Next step: [[VS-IMT Configure Stations]]
 
  
  
 
[[Category:VS-IMT]]
 
[[Category:VS-IMT]]

Latest revision as of 15:09, 31 May 2022

AEIPS.png

This article describes how to upgrade (or downgrade) the firmware of Zenitel IP devices using the VS-IMT PC tool.



Prerequisites

  • Download and install the VS-IMT tool on a Windows computer. Make sure you are using the latest version of the software.
  • Download the latest Device Firmware Package VS-IS_6.x.x.x.zip, and store it on your computer. Make a note of the location. Don't unzip the file. The VS-IS Device Firmware Package is a collection of firmware images for most types of Zenitel IP intercoms and devices.

Upgrade procedure

  1. Start IMT, select Discover & Upgrade from main menu
  2. Enter From - To IP address range
  3. Change credentials if default username/password is not used on the devices
  4. Press Search to start the discovery process
  5. When the search process is finished, select Import Image…, and browse to the VS-IS_6.x.x.x.zip file
  6. Select which devices to upgrade by Ctrl+Click (individual devices), Shift+Click (range of devices) or Ctrl+A (all devices). Selected devices are highlighted in blue color. The IMT will update up to 8 devices in parallel
  7. If your computer has several Ethernet interfaces, select the one which is on the same network as the Zenitel devices ("Choose TFTP server IP address")
  8. Press Upgrade
  9. The Status column shows the upgrade process. Wait for all upgrades to complete.The status will be reported Success when a device is up and running with the new firmware.


Discovery and Upgrade


Troubleshooting

If the you get the response "Upgrade failed", check the following:

  • Computer with multiple ethernet interfaces: Check point 7 above, in case your computer has multiple ethernet interfaces
  • No DHCP server present: If the station is set to obtain IP address from a DHCP server (default), and there is no DHCP server present, the station will use a random 169.254.x.x address. Upgrade might fail in this situation. To rectify this, either set a static IP address, or connect the station to a network with a DHCP server present.
  • Old "bootloader" version: If the station has an outdated Bootloader (a small software module used during startup), the upgrade will fail. You can check if that is the case by selecting the station from the list, and read the bootloader version from the Information and Status field:
Upgrade failed due to old bootloader software


If either the Bootloader and/or Bootenv version is from 2015, the upgrade will terminate with the failure message. If this is the case, the station must be updated using the "Configuration Manager" option on the start menu of the IMT tool.


If a device fails to upgrade or in case of any other problems, see also VS-IMT Troubleshooting & Technical Background.

Notes

Note icon Upgrade from Turbine ver. 3.x:
  • When upgrading from version 3.1 and later, one can update directly to the final version, e.g. vsft-4.11.3.0
  • Upgrade from version 3.0.3.5/3.0.3.6: First update to sti-prod-4.7.3.0, and finally vsft-4.11.3.0
  • Upgrade from version 3.0.3.4 or earlier: First update to tsi-3.0.3.5, then to sti-prod-4.7.3.0, and finally vsft-4.11.3.0


Note icon Flowire notes:
  • FCDC3 is supported as from IMT ver. 1.6.3.0
  • Flowire units cannot be upgraded at the same time as other device types. Flowire units must be upgraded separately.
  • Flowires will be upgraded sequentially, one-by-one
  • Upgrade of a Flowire device is disabled if the device has an IP Address in the range 169.254.1.x


Note icon Turbine Video Station TCIV-x notes:


Note icon IC-Edge vs Pulse systems:
  • In an IC-Edge system the minimum firmware requirement is Turbine ver. 5.x and INCA ver. 2.10.x.x. This is a requirement for all devices in the system.
  • In a Pulse system all devices must be running Turbine firmware 4.x and/or INCA firmware 2.9.x.x (or older versions)
  • If you have Turbine device with version 5.x, or an INCA device with version 2.10 or newer (i.e. IC-Edge), and want to use them in a Pulse system, you need to downgrade the Turbine to ver. 4.11.3.x, and the INCA station to version 2.9.3.x. Use the download links at the top of this article to get the firmware, and use the procedure described in this article to perform the downgrade