Actions

Difference between revisions of "AMC Flash Image update"

From Zenitel Wiki

 
(69 intermediate revisions by 3 users not shown)
Line 1: Line 1:
A new flash image (ver. 16) is now on the swrelease site. There is also a new PC tool for image upgrading, making the upgrade process a lot simpler.
+
{{A}}
+
This article describes  how to install a new flash image on the AMC-IP board, using the AlphaImageUpgrade PC tool. Note that there are two versions of the PC tool for image upgrade:
# Download the "AlphaCom Flash Image Upgrade" software from the download site
 
# Unzip the downloaded file
 
# Install the software by double-clicking the unzipped file AlphaImageUpgradeSetup.msi
 
# The software requires that "Microsoft .NET Framework" is installed. The installation program will check if Microsoft .NET Framework is already installed. If not, you are notified and a link to Microsoft's download site is displayed. Follow this link and install .NET Framework (freeware). Then run the installation file AlphaImageUpgradeSetup.msi again
 
# Download the AMC IP Flash Image file "alpha_image_16.zip" from the download site
 
# Unzip the downloaded file
 
# Start the AlphaCom Flash Image Upgrade software. Enter the AlphaCom IP address, and browse to the alpha_image_16.bin file. Start the image upgrade process. It is fully automated, and will tell you when the process is finished.
 
  
''Could not Start HTTP File Server'': The upgrade software is using a web server application during the upgrade proccess. If there is another web server application running on the computer, it must be shut down before the Image Upgrade can be executed. (The command 'netstat -a' on the Windows command line shows which application is using port 80 (i.e. the http port))
+
*'''VS-AlphacomXE.ImageUpgrade''' is used for upgrading the image file on AMC boards already running software version 11, or for upgrading an AMC board from software version 10 to version 11. This application is described in a [[AMC Flash Image Update XE|separate article]]. The image files used by this application has the extension .aimg. <br>
 +
* '''AlphaImageUpgrade''' is used for upgrading image file on AMC boards running software version 10. The image files has the extension .bin. <br>
  
''Image Load Timeout'': A firewall is probably blocking port 80. If the PC is connected directly to the AMC-IP, disable the firewall of the PC.
+
The AlphaImageUpgrade application and the image files are available for download at the [[Downloads|download site]]
  
-----
+
These image files are available:
 +
* alpha_uimage_12.bin. Includes AMC ver. 10.21
 +
* alpha_uimage_16.bin. Includes AMC ver. 10.52
 +
* alpha_uimage_18.bin. Includes AMC ver. 10.60.3.10<br><br>
 +
[[Image:Image upgrade.png|thumb|350px|Setup for Flash Image update]]
 +
== Preparations ==
 +
The image upgrade will erase all current configurations and settings, including the licenses.
 +
# Before the image upgrade can be performed, the software on the AMC-IP board must be upgraded to AMC10.52 or higher
 +
# Any software licenses will be deleted. If there are licenses on the board, make sure you have a copy of the [[AlphaWeb#License_Key|license key]] before starting the image upgrade. The license key has to be re-entered after the image upgrade.
 +
# Backup customer data by doing a GetAll from AlphaPro
  
 +
==Image update procedure ==
 +
[[Image:AlphaCom Image Application.png|left|thumb|500px|Connected to AMC-IP and Image File selected. Ready to Start Image Upgrade]]
 +
<br style="clear:both;" />
  
 +
# Download the PC software "AlphaImageUpgradeSetup.zip" from the [[Downloads|download page]]
 +
# Unzip the downloaded file
 +
# Install the software by double-clicking the unzipped file ''AlphaImageUpgradeSetup.msi''
 +
# The software requires that "Microsoft .NET Framework" is installed on the PC. The installation program will check if Microsoft .NET Framework is already installed. If not, you are notified and a link to Microsoft's download site is displayed. Follow this link and install .NET Framework (freeware). Then run the installation file AlphaImageUpgradeSetup.msi again
 +
# Download the AMC IP Flash Image file "alpha_uimage_xx.zip" ((xx = version number) from the [[Downloads|download page]]
 +
# Unzip the downloaded file
 +
# Start the AlphaImageUpgrade application. Insert the AlphaCom IP address, and press '''Connect to Target'''
 +
# Press '''Select Image File''' and browse to the ''alpha_uimage_xx.bin'' file.
 +
# Press '''Start Image Upgrade'''. The upgrade process is fully automated, and it will tell you when the process is finished.
  
Upgrade of AMC-IP Flash Image from [[Redboot]]
+
== Finalizing the AMC-IP board ==
 
+
===alpha_uimage_12.bin===
= General  =
+
When installing alpha_uimage_12.bin all settings, including IP addresses, will be set to factory default values.
This document describes how to flash the AMC-IP board using Ethernet and TFTP transfer. The process requires a small image (boot loader) written to FLASH in advance. This image will always be present after production.
 
 
 
A complete FLASH image (32MB) [[Board Support Package]], can be written to the flash on-board. It is also possible to write the separate partitions on the flash. The Partitions are:
 
 
 
* RedBoot_xx (Boot loader, image file redboot_xx.bin)
 
* LinKern_xx (Linux Kernel, image file zImage_xx)
 
* RootFS_xx (Linux file system for applications, image file root_xx.jffs2
 
* BackupFS_xx (Linux file system for backup files, image file backup_xx.jffs2)
 
 
xx is an image version number. The image version can in linux be read with the command: ‘cat /proc/mtd’
 
 
 
= AMC hardware preparation =
 
[[Image:AMC-IP.jpg|right|100px|thumb|AMC-IP board with switches and jumpers.]]
 
* Turn switch S601 – 1 to ON (enable Linux consol on serial port 1)
 
* Move jumper S700 to upper position (1 – 2) to disable the watchdog
 
 
 
= Setup =
 
 
 
|----|  RS-232 (115200,8-N-1)  |-----|
 
|    |--------------------------| AMC |
 
| PC |  Ethernet;              | IP  |
 
|----|--------------------------|-----|
 
 
 
On the AMC IP board use serial port 1 and ethernet port 0.
 
 
 
The RS-232 link is used for console (command prompt for RedBoot)
 
 
 
The Ethernet link is used for file transfer (TFTP transfer) of the image to flash.
 
 
 
The RS-232 and Ethernet links can either be on the same PC or different PCs.
 
 
 
= Extract image files =
 
Extract the image files to a folder on the PC (e.g. c:\work\AMC_IP_IMAGES)
 
 
 
Make sure your latest alpha_image_yyyymmdd.bin file is located in this folder.
 
 
 
= TFTP Server =
 
A TFTP server has to be installed on the PC. A recommended TFTP server for windows is tftp32 from [http://tftpd32.jounin.net/ http://tftpd32.jounin.net]
 
 
 
Unzip the files to a folder on the PC (e.g. c:\Program Files\tftpd32\) and run tftpd32.exe (no install).
 
 
 
Set the image folder (e.g. c:\work\AMC_IP_IMAGES) as ‘base directory’ in tftpd32 (use the ‘settings’ button).
 
 
 
Turn off the DHCP (also under 'settings') server part of the tftp32 application to avoid interfering with other DHCP servers in your network.
 
 
 
The TFTP Server program must be running during the Image upgrade process.
 
 
 
= RedBoot init  =
 
'''Note:''' Avoid using arrow- and special keys with redboot!
 
 
 
Open a serial console to the AMC-IP board (e.g. HyperTerminal or Terra Term). Communication parameters: 115200 baud, no parity, 8 data bits, 1 stop bit.
 
 
 
Power On or reset the AMC-IP board. A ‘+’ sign in the console window indicates a reboot.
 
 
 
Press Ctrl + C within 3 seconds after the reset/power on.
 
 
 
When the RedBoot application starts you should also be able to see LED activate sequence on the front of the board.
 
 
 
Wait for the RedBoot prompt (this can take some time):
 
 
 
Redboot>
 
 
 
Make sure the the ‘bootp’ parameter is set to ‘false’
 
 
 
Redboot> fconfig bootp
 
 
 
If set to  'true' change to 'false' by using <backspace> to delete current setting and type in  false.
 
 
 
In general use <backspace> to edit parameters displayed by the fconfig command
 
 
 
Make sure the network interface is set to ‘npe_eth0’:
 
 
 
Redboot> fconfig net_device npe_eth0
 
 
 
Configure the network address/mask for the AMC-IP board (replace example 10.5.220.13 with actual address):
 
 
 
Redboot> fconfig bootp_my_ip 10.5.220.13
 
Redboot> fconfig bootp_my_ip_mask 255.255.255.0
 
 
 
If you are connecting the AMC-board back-to-back with your PC we have standardized on a ‘Windows Automatic Private’ address IP:169.254.1.5/255.255.0.0
 
 
 
If you are connecting to a PC in a LAN you must find a free address in this LAN (check with your IT-administrator).
 
 
 
If the TFTP server is in a different network, a gateway address has to be set up :
 
 
 
Redboot> fconfig bootp_my_gateway_ip
 
 
 
Finally the IP-address of the server (i.e. the PC were the image files are located) has to be setup (replace example 10.5.220.101 with actual address):
 
 
 
Redboot> fconfig bootp_server_ip 10.5.220.101
 
 
 
The complete configuration can be listed:
 
 
 
Redboot> fconfig –l –n
 
 
 
To activate the settings:
 
 
 
Redboot> reset
 
 
 
Now the AMC board will reset. Press Ctrl + C within 3 seconds to log on to Redboot again.
 
 
 
To test the IP connection to the server (use Ctrl-C to abort ping):
 
 
 
Redboot> ping –h <server-ip>
 
 
 
''Note'': Make sure that the server is able to reply. The TFTP Server program must be running. If the OS is Windows XP you might need to stop the Windows Firewall temporarily.
 
 
 
Example:
 
 
 
RedBoot> ping -h 169.254.232.100
 
''Immediate response: ''Network PING - from 169.254.1.5 to 169.254.232.100
 
''Response after 20 seconds: ''PING - received 10 of 10 expected
 
 
 
= Complete FLASH image =
 
For flashing the complete image a special redboot_ram.img image has first to be loaded into RAM, and then the complete image can be loaded. There are two different procedures, depending on the Redboot version.
 
 
 
To find the Redboot version number reset the AMC board and press Ctrl + C within 3 seconds. Now the Redboot version is displayed.
 
 
 
Depending on the Redboot version, do:
 
 
 
Redboot version 04 or newer:
 
 
 
Redboot> fis alpha ALL
 
 
 
'''''OR:'''''
 
 
 
Redboot version 03 or older:
 
 
 
Redboot> load redboot_ram.img
 
Redboot> go
 
 
 
Redboot will now be reset in RAM mode.
 
 
 
Enter the following command with the version parameter for the alpha_image_yyyymmdd.bin file (for complete images the creation date is used for version). The current file is alpha_image_12.bin
 
 
 
Redboot> fis alpha –v 12 ALL
 
 
 
The image will be loaded to RAM and you have to confirm with a [y] before the real flashing starts.
 
 
 
'''Important! '''Before confirming be sure that the correct image is loaded without any errors. Check for error messages!
 
 
 
Example – successful upload from server:
 
 
 
RedBoot> fis alpha -v 12 ALL
 
Mode RAM
 
Loading image alpha_image_12.bin from tftp server
 
Using default protocol (TFTP)
 
Raw file loaded 0x000d1000-0x020d0fff, assumed entry at 0x000d1000
 
Unlocking RedBoot Config Partition
 
... Unlock from 0x51fe0000-0x52000000: .
 
Writing image to flash
 
* CAUTION * about to program FLASH
 
    at 0x50000000..0x51ffffff from 0x000d1000 - continue (y/n)?
 
 
 
Confirm with a [y] to start the erase and flash process. This takes a few minutes. When the process is finished the Redboot prompt RedBoot> will be displayed.
 
 
 
= Finalizing the AMC =
 
Switch off the power and:
 
 
 
* Turn switch S601 – 1 to OFF (disable Linux consol on serial port 1)
 
 
 
* Move jumper S700 to down position (2 – 3) to enable the watchdog
 
 
 
The AMC board is now ready for regular use.
 
 
 
= Partition Update (optional) =
 
The partitions can also be flashed independently. The general AlphaCom flash update command is fis alpha:
 
 
 
fis alpha [-v <version_string>] <image_name> (RedBoot | LinKern | RootFS | BackupFS | ALL)
 
 
 
Example:
 
 
 
Update to the Linux Kernel Image version 03:
 
 
 
Redboot> fis alpha –v 03 LinKern
 
 
 
Update to the Linux Root file system to version 10:
 
 
 
Redboot> fis alpha –v 10 RootFS
 
  
Note! The RedBoot image requires a reboot to RAM mode as for the complete update. The procedure is the same as for a complete update.
+
===alpha_uimage_16.bin and alpha_uimage_18.bin===
 +
When installing these image files some settings will automatically be restored after the installation.
 +
During the upgrade process the configuration file "amc_ip_config.xml" is temporarily stored in NVRAM, and is restored after the upgrade process. This means that the following information is automatically restored after the upgrade:
 +
* IP addresses
 +
* IP routing
 +
* Filter settings
 +
* Log configuration (the actual log files are erased)
  
'''Important! '''Before confirming to flash be sure that the correct image is loaded without any errors. Check for previous error messages!
+
The following information needs to be reconfigured from AlphaWeb:
 +
* License key
 +
* Time settings
 +
* If logging was enabled, the logging feature needs to be reactivated. Go to System Configuration -> Logging, and press "Apply"
 +
* Upgrade to latest AMC software version. The Image Update will load AMC software version 10.52 to the board. (Currently 10.52 is the latest version).
  
'''Important! '''The image name has to be supplied with the correct case (small and big letters). Redboot is not case sensitive to the image name, but the linux kernel searches for a RedBoot image case sensitive.  
+
The intercom configuration must be restored by doing a SendAll from AlphaPro.
  
To list the partitions on the flash use:
+
== Troubleshouting==
 +
Error messages in the "AlphaCom Flash Image Upgrade" software:
 +
*''Server Status: Could not Start HTTP File Server'': The upgrade software is using a web server application during the upgrade proccess. If there is another web server application running on the computer, it must be shut down before the Image Upgrade can be executed. (The command 'netstat -a' on the Windows command line will show which application is using port 80 (i.e. the http port))
 +
*''Image Load Timeout'': A firewall is probably blocking port 80. If the PC is connected directly to the AMC-IP, disable the firewall of the PC. Also it is worth noting that Image Upgrade is '''NOT''' supported through XP Mode in Windows 7.
 +
'''WARNING!''' If you have upgraded to the image alpha_uimage_20_B02.bin (image file for Billing feature, not general available), you can not downgrade the AMC software below version 10.52!!! If this is for some reason wanted, please contact STENTOFON technical support.
  
Redboot> fis list
+
== Related articles ==
 +
*[[AMC Flash Image update from Redboot]]
  
[[Category:AlphaCom E Software]]
+
[[Category:Upgrade and Recovery]]

Latest revision as of 14:38, 15 October 2019

AlphaCom icon 300px.png

This article describes how to install a new flash image on the AMC-IP board, using the AlphaImageUpgrade PC tool. Note that there are two versions of the PC tool for image upgrade:

  • VS-AlphacomXE.ImageUpgrade is used for upgrading the image file on AMC boards already running software version 11, or for upgrading an AMC board from software version 10 to version 11. This application is described in a separate article. The image files used by this application has the extension .aimg.
  • AlphaImageUpgrade is used for upgrading image file on AMC boards running software version 10. The image files has the extension .bin.

The AlphaImageUpgrade application and the image files are available for download at the download site

These image files are available:

  • alpha_uimage_12.bin. Includes AMC ver. 10.21
  • alpha_uimage_16.bin. Includes AMC ver. 10.52
  • alpha_uimage_18.bin. Includes AMC ver. 10.60.3.10

Setup for Flash Image update

Preparations

The image upgrade will erase all current configurations and settings, including the licenses.

  1. Before the image upgrade can be performed, the software on the AMC-IP board must be upgraded to AMC10.52 or higher
  2. Any software licenses will be deleted. If there are licenses on the board, make sure you have a copy of the license key before starting the image upgrade. The license key has to be re-entered after the image upgrade.
  3. Backup customer data by doing a GetAll from AlphaPro

Image update procedure

Connected to AMC-IP and Image File selected. Ready to Start Image Upgrade


  1. Download the PC software "AlphaImageUpgradeSetup.zip" from the download page
  2. Unzip the downloaded file
  3. Install the software by double-clicking the unzipped file AlphaImageUpgradeSetup.msi
  4. The software requires that "Microsoft .NET Framework" is installed on the PC. The installation program will check if Microsoft .NET Framework is already installed. If not, you are notified and a link to Microsoft's download site is displayed. Follow this link and install .NET Framework (freeware). Then run the installation file AlphaImageUpgradeSetup.msi again
  5. Download the AMC IP Flash Image file "alpha_uimage_xx.zip" ((xx = version number) from the download page
  6. Unzip the downloaded file
  7. Start the AlphaImageUpgrade application. Insert the AlphaCom IP address, and press Connect to Target
  8. Press Select Image File and browse to the alpha_uimage_xx.bin file.
  9. Press Start Image Upgrade. The upgrade process is fully automated, and it will tell you when the process is finished.

Finalizing the AMC-IP board

alpha_uimage_12.bin

When installing alpha_uimage_12.bin all settings, including IP addresses, will be set to factory default values.

alpha_uimage_16.bin and alpha_uimage_18.bin

When installing these image files some settings will automatically be restored after the installation. During the upgrade process the configuration file "amc_ip_config.xml" is temporarily stored in NVRAM, and is restored after the upgrade process. This means that the following information is automatically restored after the upgrade:

  • IP addresses
  • IP routing
  • Filter settings
  • Log configuration (the actual log files are erased)

The following information needs to be reconfigured from AlphaWeb:

  • License key
  • Time settings
  • If logging was enabled, the logging feature needs to be reactivated. Go to System Configuration -> Logging, and press "Apply"
  • Upgrade to latest AMC software version. The Image Update will load AMC software version 10.52 to the board. (Currently 10.52 is the latest version).

The intercom configuration must be restored by doing a SendAll from AlphaPro.

Troubleshouting

Error messages in the "AlphaCom Flash Image Upgrade" software:

  • Server Status: Could not Start HTTP File Server: The upgrade software is using a web server application during the upgrade proccess. If there is another web server application running on the computer, it must be shut down before the Image Upgrade can be executed. (The command 'netstat -a' on the Windows command line will show which application is using port 80 (i.e. the http port))
  • Image Load Timeout: A firewall is probably blocking port 80. If the PC is connected directly to the AMC-IP, disable the firewall of the PC. Also it is worth noting that Image Upgrade is NOT supported through XP Mode in Windows 7.

WARNING! If you have upgraded to the image alpha_uimage_20_B02.bin (image file for Billing feature, not general available), you can not downgrade the AMC software below version 10.52!!! If this is for some reason wanted, please contact STENTOFON technical support.

Related articles