Professional Documents
Culture Documents
Cambium
Network
Updater Tool
Release Notes
System Release
4.13.3
1
Issue 1 July 2020
© 2019 Cambium Networks. All Rights Reserved.
1
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
Accuracy
While reasonable efforts have been made to assure the accuracy of this document, Cambium Networks assumes
no liability resulting from any inaccuracies or omissions in this document, or fr om use of the information obtained
herein. Cambium reserves the right to make changes to any products described herein to improve reliability,
function, or design, and reserves the right to revise this document and to make changes from time to time in
content hereof with no obligation to notify any person of revisions or changes. Cambium does not assume any
liability arising out of the application or use of any product, software, or circuit described herein; neither does it
convey license under its patent rights or the rights of others. It is possible that this publication may contain
references to, or information about Cambium products (machines and programs), programming, or services that
are not announced in your country. Such references or information must not be construed to mean that Cambium
intends to announce such Cambium products, programming, or services in your country.
Copy rights
This document, Cambium products, and 3rd Party Software products described in this document may include or
describe copyrighted Cambium and other 3rd Party supplied computer programs stored in semiconductor
memories or other media. Laws in the United States and other countries preserve for Cambium, its licensors, and
other 3rd Party supplied software certain exclusive rights for copyrighted material, including the exclusive right to
copy, reproduce in any form, distribute and make derivative works of the copyrighted material. Accordingly, any
copyrighted material of Cambium, its licensors, or the 3rd Party software supplied material contained in the
Cambium products described in this document may not be copied, reproduced, reverse engineered, distributed,
merged or modified in any manner without the express written permission of Cambium. Furthermore, the
purchase of Cambium products shall not be deemed to grant either directly or by implication, estoppel, or
otherwise, any license under the copyrights, patents or patent applications of Cambium or other 3rd Party supplied
software, except for the normal non-exclusive, royalty free license to use that arises by operation of law in the sale
of a product.
Rest rictions
Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part
of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or
translated into any language or computer language, in any form or by any mean s, without prior written permission
of Cambium.
License Agreements
The software described in this document is the property of Cambium and its licensors. It is furnished by express
license agreement only and may be used only in accordance with the ter ms of such an agreement. See the legal
notices and license agreement section of the Network Updater on-line help document.
2
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
Table of Contents
1 Overview ............................................................................................................................4
1.1 Support added in this release ...........................................................................................4
1.2 Limitations .........................................................................................................................4
1.3 Network Elements support already available in CNUT .....................................................5
1.4 Product and Documentation Links....................................................................................6
2 Dependencies of Network Updater .......................................................................7
2.1 Supported Operating Systems...........................................................................................7
2.2 Required Ports ...................................................................................................................7
2.3 Java Runtime Environment ................................................................................................7
3 Network Updater Software Installation .............................................................8
3.1 General Installation Information .......................................................................................8
3.2 Launching Installation or Upgrade on Windows ...............................................................8
3.3 Launching Installation or Upgrade on Red Hat Linux ........................................................8
4 Issues in Network Updater Operation .................................................................9
4.1 Issues resolved with this software release .......................................................................9
4.2 Issues acknowledged with this software release ............................................................11
4.3 Caveats That Apply to This Software Release.................................................................13
4.3.1 SMs That Do Not Update ............................................................................................ 13
4.3.2 Busy Port Will Prevent HTTP or HTTPS Server Start ....................................................... 13
4.3.3 Auto Update logs not shown on CNUT UI until it is disabled.......................................... 15
4.3.4 HTML Entity Symbols Problematic............................................................................... 15
4.3.5 Semicolons Problematic in External Tools and Radios Passwords .................................. 15
4.3.6 CNUT Failed to extract SM information for 13.3 firmware............................................. 15
4.3.7 CNUT logs may sometimes show SEVERE exceptions due to low network connectivity, but
upgrades are successful............................................................................................................ 16
4.3.8 CNUT logs show SNMPIOException if the device is set to SNMP Read-Only.................... 16
4.3.9 CNUT GUI or CNUT through CLI randomly gives Invalid File Image (Status 211) error
though rerunning the same process, upgrade happens successfully. ........................................... 16
3
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
1 Overview
The Network Updater Tool is a free-of-charge tool that applies packages to upgrade various device
types. Because this tool is available, an operator does not need to visit each module in the network
or even each AP where they would otherwise use the SM Autoupdate capability of the radios.
Certain devices such as ePMP Series and some backhauls do not support the SM Autoupdate featur e.
For these cases, Network Updater reports to the user that this feature does not apply. However, user
can directly upgrade the SMs using the CNUT.
1. Warning message about the existence of PMP430 SM when trying to upgrade an AP to 16.1 or later
firmware versions added
2. Warning message about PMP 450/450i/450b SMs running 15.1.5 or earlier software versions
added
3. Added support for PTP550 and ePMP3000 device upgrade
4. Added showwarnings option in CLI so that the warning message appears in CLI and not in the GUI
5. Corrected the command line for External Tools
6. Restricted the size of External Tool name to 50 characters
7. Fixed the issue of device type format getting changed when the network is saved
8. "Invalid upgrade image" error message changed to “Incorrect upgrade image attempted for
specified device Or Failed to set max file size(status:256)”.
9. Updated the Introduction in the installer
10 . Fixed the issue of the warning message ’SMs running on Firmware version 15.1.5 or lower do not
register to AP running 16.1 or higher’ popping up even when the AP was on 16.1 or higher while
trying to upgrade the AP to 16.1.1 or higher version
1.2 Limitations
This release has following limitations:
4
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
3. When using CNUT HTTP as File Server for Autoupdate of SMs, irrespective of SM type selected,
CNUT will continue to Autoupdate all SMs that are connected to the AP device.
5
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
6
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
Since the external tools in this release require that JRE Version 1.5 or later is running on the host
machine, the installation tool for this release loads a proper version of JRE.
7
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
Full details about installation are provi ded under the section titled "Installation" in Cambium Network
Updater On-Line Help that supports this release.
To run the installation on any supported Linux platform, download the file CNUTInstaller -4.13.3-
linux-installer.run to your Network Updater computer. Before running the installer in Linux,
change the permissions on the downloaded setup file by executing the following command:
chmod +x CNUTInstaller-4.13.3-linux-installer.run
Then, to run the installer, execute the following command:
./CNUTInstaller-4.13.3-linux-installer.run
8
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
The command line for After selecting a jar in ‘Launch External Tool’ null was passed as the CNUT-1046
external tools shows null argument. This issue has been resolved The CNUTInitRadio.jar is not
supported in CNUT and PMP450BWUpdaterTool.jar is replaced by
BWUpdaterTool.jar
If the incorrect upgrade “Invalid upgrade image" error message changed to “Incorrect upgrade CNUT-1074
image is selected for the image attempted for specified device Or Failed to set max file
upgrade, “Invalid upgrade size(status:256). SM:(MAC=0A003E453183 )”
image" message was
displayed
Device type format changes The device type format changed when a network was saved. This CNUT-1052
when a network is saved. issue has been resolved.
There was no restriction for With this release there is a restriction of 50 characters on the size of CNUT-1093
the character size of the External Tool name
Name field in ‘Add External
Tool’ in previous releases
Add the support for PTP 550 Added the support for PTP 550 and ePMP 3000 devices CNUT-1057
and ePMP 3000 devices
9
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
CNUT 16.1 support [15.1.5 Warning - about the existence of PMP430 SM when trying to upgrade CNUT-1071
and 430SM] warning an AP to 16.1 or later firmware versions
messages are not shown for
PMP 450m device type This warning indicates that upgrading the AP to 16.1 or later firmware
versions will result in loosing access to the 430 SMs
To suppress warnings in CLI Added another parameter in the CLI command i.e showwarnings. CNUT-1104
when PMP 450 AP devices
are upgraded to 16.1 or The decision whether to suppress the warning or not is left entirely to
higher and SMs are running the user.
on 15.1.5
If showwarnings:true , the warning message pops up ,the next course
of action depends on the option selected by the user.
10
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
Canopy PMP 450i SM As of Software Release 16.2 and later, CNUT Autoupdate using CNUT-1017
and PMP 450b SM PMP 450 AP as the File Server no longer supports update of 450b
cannot be auto and 450i SMs. Use cnMaestro or CNUT HTTP File Server option to
updated using PMP upgrade these SMs.
450 AP and using AP
as file server
Auto Update using Even if user selects only one of the SM Types, CNUT will perform CNUT-1022
CNUT HTTP as file Autoupdate of all SMs connected to AP device when File Server Type is
server doesn't restrict selected as CNUT HTTP
to selected Auto Workaround: Use AP as File Server to upgrade a single SM Type
Update SM Type
Channel Bandwidth If user manually tries to add Channel Bandwidth Updater tool, Channel CNUT-987
Tool takes null Bandwidth Tool takes null argument in command line
argument in command Workaround: Use default settings to run Channel Bandwidth Updater tool.
line
Issues with CNUT This works only with IE (and not on Chrome) CNUT-986
Gather Support tool
On Linux, the The migration doesn’t fail. Also, it doesn’t warn the user that the tool is CNUT-977
migration doesn’t running and doesn’t save the active network.
detect if CNUT tool is Note: Workaround is to close the tool and save the network before starting
already running the migration scenario on Linux.
Events are not No messages are added to the log until Auto update is disabled. CNUT-828
recorded while
Autoupdate is
enabled.
Updates of PMP-430 While PMP-430 SMs under the AP are successfully updated by the PMP-450 CNUT-851
APs by a PMP-450 package, the PMP-430 AP is not. Please uncheck PMP 430 SMs while
package fail. upgrading PMP 450 devices using PMP 450 packages
Web browsers are not Regardless of OS platform, data collected through the Gather SM CNUT-574
displaying device Passwords and Extract IP Address and SNMP Settings auto-discovery 0019269
information from SM option is viewable in only the latest version of web browser (latest of Firefox
auto-discovery. or latest of Internet Explorer). Latest version of Firefox performs best,
regardless of OS.
For PMP 430 devices, Even if the check box for Enable SM Autoupdate when an Access Point is CNUT-211
Network Updater Updated is checked (Continue updating child elements if parent element 0021158
disregards the setting fails to update is unchecked), Network Updater will push the new package
in the General to the SMs even if the attempt to push the new package to the AP fails (for
Configuration block. example, when the AP package contains an image that is not valid for the
AP).
11
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
The Create New Folder As a result of a known issue in Java 1.4 through 1.6 (Bug #4847375), the CNUT-103
option is unavailable Create New Folder button in the Windows Save dialog is grayed out 0009787
for saving a network ( )
archive file. • While Save In is set to My Documents.
• When Save In has been set to My Documents and then changed to
Desktop.
The encryption type Network Updater relies on the link table in the radio to display the CNUT-100
not available from encryption type of the radio. Certain SMs (for example, those that operate 0008122
certain SMs. on System Release 9.0) do not include this as a field in their link tables. The
workaround for this problem is to upgrade the system release in these
radios to the current release.
However, there is no risk that Network Updater would upgrade such a radio
with the wrong encryption package, because it correctly discovers the
encryption type as it discovers the SM through its IP address.
The maximized As a result of known issues in Java (Bug #4737788 and 4472411), the GUI CNUT-82
Network Updater GUI overlays and hides the Windows task bar until the GUI is resized (restored) 0002321
obscures the Windows to its last previous size.
task bar.
The Restore (resize) As a result of known issues in Java (Bug #4737788 and 4472411), the GUI CNUT-68
function sometimes sometimes cannot be restored to its last previous size from the maximized 0000971
does not work on the state. When this occurs, you may move the maximized window by a
maximized state of the distance that is sufficient to allow manually resizing it.
Network Updater GUI.
HTTP or HTTPS server See Busy Port Will Prevent HTTP or HTTPS Server Start. CNUT-58
may fail to start. 0018693
[CNUT as HTTP file The devices get upgraded , but sometimes the updated status is seen only CNUT-1068
server]: Upgrading after manually refeshing the devices.
device setup is
successful but updated
status is seen only on
manual refresh
The command line in CNUTHwScheduler.jar is not supported in External tools, but this jar is still CNUT-1046
External Tools shows used by Configure Advantage scheduler, so could not be removed from
null for Tools.
CNUTHwSche duler.j ar
12
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
This message is also thrown to the log as a SEVERE event. Although you can resolve the barrier to
launch, a hasty response can have consequences. It is strongly recommended that, when you have
identified the process that is blocking by using the port, you research any adverse effects of killing
that process before you kill it.
13
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
For either case, the system returns a tabular line that includes a Local and Foreign IP address (with :
port_number appended) and whose last column is populated by the process_ID, which
typically is a numeric string of four or fewer characters. Carefully research the source of that process,
particularly to find out whether stopping that process will have effects that are adverse.
If you are certain that the effects would be benign, then you can kill the process as follows:
▪ In Windows, perform the following steps:
1. Right-click in an unoccupied area of the task bar at the bottom of the desktop.
2. From the resulting drop-down list of options, select Task Manager.
3. In the Windows Task Manager window, click the Processes tab.
4. From the main menu of this window, select View→Select Columns.
5. In the Select Columns window, check the check box of PID (Process Identifier).
6. Click OK.
7. Scroll to find the PID that is using the port (Port 80 or 443).
8. Click to highlight the row of that process.
9. Research whether and how the process may be essential and/or should not be
interrupted. For example, you can perform an Internet search on the executable file
name and study remarks from the returned results.
10 . If you are certain that the process can be stopped without consequences that are
damaging, click the End Process button at the bottom of the Windows Task Manager
window.
If you are uncertain, allow the process to run until its completion.
▪ In Linux, perform the following steps:
1. Search the Internet for the string PID n, where n is the string that you saw in the PID
column.
Research whether and how the process may be essential and/or should not be
interrupted. For example, you can perform an Internet search on the executable file
2. name (that the PID search results associated with the PID) and study remarks from the
returned results.
3. If you are certain that the process can be stopped without consequences that are
damaging, enter kill PID.
If you are uncertain, allow the process to run until its completion.
14
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
15
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
16
Network Updater Release 4.13.3 Release Notes Issue 1
July 2020
Community Forum
The technical support Community Forum is part of the support web site and can be used for asking
questions directly to the support team. Questions and answers are accessible to all so that any
customer can benefit from the same dialogue. To access this forum, visit
http://community.cambiumnetworks.com. This forum requires authentication for posting.
Technical Support
You can obtain support Network Updater from any or all of the following sources:
▪ Cambium Network Updater On-Line Help, and release notes. See
http://www.ca mbiumnetworks.com/s upport/manage me nt-tools/cnut.
▪ Cambium Networks support web page: http://www.cambiumnetworks.com/support/
▪ This page provides links to information on all products and tools, as well as access to
customer support materials and interactive support forums. Some of these resources are
restricted to registered users and channel partners.
▪ The Community Forum Page http://community.cambiumnetworks.com/
▪ Direct contact with Cambium Networks Technical Support. This contact is available 7 days
a week, 24 hours a day. To find the appropriate phone number based on your country or
region, visit http://www.cambiumnetworks.com/support/contact-support.
▪ A technical support case, which you can open at
http://www.cambiumnetworks.com/support/open-a-support-case. The case captures basic
information about answers you are seeking or the problem that your network is
experiencing and provides this to the support team, who are available 7 days a week,
24 hours a day, and will respond. They will also provide a case number by which you and
they can continue to track progress on issues that require deeper investigation.
17