Actions

AMC Flash Image Update XE

From Zenitel Wiki

Revision as of 14:02, 15 October 2018 by Asle (talk | contribs) (Upload using TFTP Server)
AlphaCom icon 300px.png

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

  • AlphaImageUpgradeXE is used for:
    • Upgrading the image file on AMC-IP boards already running software version 11
    • Upgrading an AMC-IP board from software version 10 to version 11
    • Downgrading an AMC-IP board from software version 11 to version 10. Note: Only AMC-IP boards with red PCB can be downgraded to version 10. AMC-IP boards with black PCB will not run with version 10.
The image file 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. This application is described in a separate article.

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

Setup for Flash Image update

About AMC-IP hardware and software versions

  • AMC-IP board hardware revision 01 to 04: These boards have RED PCB. They come from factory with software version 10, but can be upgraded to version 11. Not all features in software version 11 (Audio Messaging, Auto-attendant, Billing) can be utilized when version 11 runs on this hardware version. In some documentation these boards are called AMC 10.
  • AMC-IP board hardware revision 05 and 06: These boards have BLACK PCB. These boards come from factory with software version 11. In some documentation these boards are called AMC 11. This board cannot be downgraded to software version 10.

The hardware version is printed in the PCB, to the top right on the rear side of the board. For example "PCB. NO. 8000/4" means hardware version 04.

Preparations

The image upgrade will erase all current configurations and settings, including the licenses. Only basic configuration like IP Setting are kept during the upgrade.

  1. Before the image upgrade can be performed, make sure the software on the AMC-IP board is version 10.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" via HTTP protocol


  1. Download the PC software "VS-Tools.msi " from the download page
  2. Install the software by double-clicking file VS-Tools.msi
  3. 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 "VS-Tools.msi" again
  4. Download the AMC IP Flash Image file "axeu_bxxxx_ayyyyyyy.aimg" ((xxxx = Board Support version number, yyyyyy = AMC software version) from the download page
  5. Start the AlphaImageUpgradeXE application. If the Server Status says "Could not Start the HTTP File Server", one can upload the image file using a TFTP server program instead. Jump to the paragraph #Upload using TFTP Server.
  6. Insert the AlphaCom IP address, and press Connect to Target
  7. Press Select Image File and browse to the required .aimg file:
    1. Select axeu_b3001_a1101303.aimg to upgrade a black AMC-IP board to the latest image
    2. Select axeu_b2200_a1100300.aimg to upgrade a red AMC-IP board from version 10 to version 11
    3. Select alpha_uimage_18.aimg to downgrade a AMC-IP board from version 11 to version 10 (Possible only on red AMC-IP boards)
  8. Press Start Image Upgrade. The upgrade process is fully automated, and it will tell you when the process is finished.

Upload using TFTP Server

By default the Image Upgrade application tries to start a HTTP Server. If there is a HTTP Server already running on the PC, you will get the error message "Could not Start the HTTP File Server". The image can then be uploaded using a TFTP Server instead.

  1. Download and install a TFTP Server, e.g. from TFTPd
  2. Start the AlphaImageUpgradeXE application.
  3. Insert the AlphaCom IP address, and press Connect to Target
  4. Press Select Image File and browse to the required .aimg file.
    1. Select axeu_b3001_a1101303.aimg to upgrade a black AMC-IP board to the latest image
    2. Select axeu_b2200_a1100300.aimg to upgrade a red AMC-IP board from version 10 to version 11
    3. Select alpha_uimage_18.aimg to downgrade a AMC-IP board from version 11 to version 10 (Possible only on red AMC-IP boards)
  5. Start the TFTP Server.
    1. In the TFTP Server application, browse to the folder specified in Server Root
    2. In the TFTP Server application, set the Server Interface to the same as Server IP
  6. Press Start Image Upgrade. The upgrade process is fully automated, and it will tell you when the process is finished.
Connected to AMC-IP and Image File selected. Ready to "Start Image Upgrade" via FTP protocol


Finalizing the AMC-IP board

When installing the image file 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"


Now you should upgrade to the latest AMC software version.

Finally restore the intercom configuration be by doing a SendAll from AlphaPro.

Troubleshouting

Error messages in the "AlphaImageUpgradeXE" 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. To stop any running http server on the PC, run the Windows Command Promt as Administrator, and execute the command "net stop http". As an alternative one can upload the image file using a TFTP server program.
  • 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.
  • Image Load Timeout: Ping Reply is blocked by windows. Go to Control Panel\All Control Panel Items\Network and Sharing Center\Advanced sharing settings and Turn on Network Discovery for your network profile.
  • Async callback exeption: Authorization Request or Async callback exeption: Unauthorised: Due to security updates in the AlphaCom software from version 11.5.x.x, older versions of the AlphaCom XE Image Update tool will not work towards 11.5.x.x. or newer AlphaCom software. Make sure you are using the latest version of the tool. Download the latest version "VS-Tools.msi " from the download page