Canopy Firmware Updates

Powercode provides a mechanism to perform firmware updates on Motorola Canopy equipment through the Powercode interface. To utilize this system, you have to install CNUT for Linux and perform a couple of minor system changes.

We are reliant on the Canopy CNUT utility running correctly on your system. If you run into problems, please try running the updater by hand by executing the following commands:

cd /usr/local/canopy/networkupdater/cli


If this fails then Powercode will be unable to update your equipment. We've had the best luck getting this working on versions of CentOS 5.5 or newer. In some versions of the Linux-based CNUT, we've also seen some of the paths set incorrectly in the file. If you receive error messages, type nano -w and verify all the paths to the .jar files are correct. In the most recent version installed, the log4j jar was pointing to log4j-1.2.9.jar but CNUT installed log4j-1.2.14.jar. CNUT was also pointing to SNMP4J.jar but the snmp4j.jar file actually had a different file name. If any paths are incorrect, update them and the file should work. We have notified Motorola of this issue.

To configure your system to allow firmware updating through the web interface, visit Motorola's download site and scroll down to the bottom. Find the link for the Network Updater Tool for Linux and download it. You will now need to transfer this file to your server for installation. The simplest method is to download FileZilla and connect to your server. To connect to your server with FileZilla, click on the Site Manager icon on the top left and setup your server as shown below.

Once you are connected, just drag the Network Updater file into your /root/ folder on your billing server.

Now SSH into your billing server and execute the following commands:

cd /root

chmod +x (e.g. chmod +x setupCNUT.bin)

./ (e.g. ./setupCNUT.bin)

Follow the prompts to install CNUT to the default directory, typically /usr/local/Canopy/networkupdater.

Finally, type dos2unix /usr/local/Canopy/networkupdater/cli/

That's it, the hard part is over! Now you just have a small amount of configuration to complete in Powercode. Login to your Powercode billing server and click on Configure and then Powercode System.

Find the input field labelled CNUT Path and enter the path you just installed CNUT into, typically /usr/local/Canopy/networkupdater/. It is important that you end the path with the trailing slash (/usr/local/Canopy/networkupdater/ not /usr/local/Canopy/networkupdater).

Now scroll to the bottom and use the file upload form to upload the version of Canopy firmware you would like to use on your system.

Once you complete both these tasks, a new Update Firmware option will appear next to any device of type Canopy Su as shown below.

To update successfully, the following criteria must be met.
  1. You must have a valid SNMP key entered into the SM and the SNMP key must be entered into Powercode.
  2. You must enter a valid password for this device into Powercode and this password must work for the root account on the SM.
After scheduling the update, it will be performed within the next 10 minutes. The results of the firmware update attempt will be shown in the customer event log for later review.


The 'Update Firmware' link does not show up next to my equipment.
  1. Is the device type set to Canopy SM? It will only show up next to devices set to Canopy SM.
  2. Is the CNUT path correct? Make sure there is a trailing slash on the directory name under Config->Powercode System.
  3. Have you uploaded your Canopy firmware correctly? Check your billing server - the file should be in /var/www/html/canopyfirmware. If there is no file in this directory or it does not exist, type the following:
  • mkdir /var/www/html/canopyfirmware
  • chmod 777 /var/www/html/canopyfirmware
  • Now upload the firmware again in Config->Powercode System.
If you have other issues, please post in our forum. Due to this system requiring third party software, we don't officially support it but we'll do our best to help you with any issues.

Via powercode


Post a Comment