cnMaestro 2.1.1 (On-Premises) Release

[Rob]

Introduction

This document highlights new features and significant updates in cnMaestro 2.1.1 On-Premises.

Important

cnMaestro On-Premises 2.1.1 is a Package release rather than a full OVA image. It must be applied on top of an existing 2.1.0 On-Premises installation. Please follow the steps detailed in section 6.2 of the cnMaestro On-Premises 2.1.0 Quick Start Guide (“Updating cnMaestro Software”) to perform a package update on an existing OVA.

Important: Web Browser

You may need to restart your browser (or clear the browser cache with a hard reload) after the 2.1.1 update.

cnMatrix Support (Beta)

cnMaestro supports the following monitoring and management functionalities on cnMatrix.

Feature	Details
Onboarding	Onboard cnMatrix using MAC.
Dashboard	cnMatrix dashboard including individual port dashboards.
Notifications	cnMatrix notifications and alarms.
Performance	Performance graphs with the following metrics: throughput, Tx packets, Rx packets, packet error, and CPU utilization.
Operations	Device reboot support.
Configuration	Template-based configuration.
Software Update	Bulk software update.
Data Report	Download data reports.

cnMatrix Dashboard

 

cnMatrix Performance

API Updates (On-Premises)

New APIs

Path	Details
Wi-Fi Performance API (Section 8.5.5)
/api/v1/devices/{MAC Address}/wi-fiperf	To initiate Wi-Fi performance test
/api/v1/devices/{MAC Address}/wi-fiperf	To retrieve Wi-Fi performance test result

Supported Cambium Products

cnMaestro supports the following Cambium Networks products. The software versions are the minimum required to use cnMaestro (not the recommended versions).

Family	Model	Version
cnPilot	cnPilot R200, R200P	4.2.3-R4
cnPilot R201, R201P	4.2.3-R4
cnPilot R190V,  R190W	4.3.2-R4
cnPilot E400/E500	2.5.2-r3
cnPilot E410/E430w/E600	3.5.2-R4
cnPilot E501S	3.2.1-r6
cnPilot E502S	3.2.1-r6
cnPilot E700	3.8
ePMP 1000 Hotspot	ePMP 1000 Hotspot	2.5.2-r3
ePMP	ePMP 1000, Force 180/200	2.6.2
ePMP 2000	3.0.1
ePMP Elevate	3.0.1
ePMP Force 190	3.5
ePMP Force 300	4.1.1
ePMP Force 300-25	4.1.1
ePMP Force 300-16	4.3.0.1
ePMP PTP 550	4.1.1
ePMP 3000	4.3.0.1
PMP	PMP 450i, PMP 450, PMP 450m, PMP 430 SM	15.0.1
PTP 450, and PTP 450i	15.0.1
PTP	PTP 650	01-47
PTP 670 (650 Emulation)	01-47
PTP 670, PTP 700	02-67
cnReach (Beta)	N500	5.2.17e
cnMatrix (Beta)	cnMatrix	2.0.4-r1

Supported Browsers

cnMaestro supports the following browsers:

Platform	Browser	Version
Windows	Internet Explorer	11 and above
Firefox	45 and above
Chrome	49 and above
MacOS	Safari	9 and above
Linux	Firefox	45 and above
Chrome	49 and above

Significant Fixes

The following issues have been fixed:

Id	Details
CNSSNG-8675	RSSI chart difficult to read
CNSSNG-9058	Myanmaar country code support need to be added in CnMaestro
CNSSNG-10313	SM SNMP Site Contact and Site Address should be searchable in Inventory
CNSSNG-10688	[Customer NOC] SM downtime always shows less than 5 minutes
CNSSNG-10730	Network Maps: draw line between AP and SM
CNSSNG-10770	Select all SM checkbox missing on config page under Network/Tower level
CNSSNG-10804	Equals sign = breaks User-Defined Overrides
CNSSNG-10855	Fallback to Local users do not happen with few Error codes in AD
CNSSNG-10988	NBI API: Extra data is added in API response

Known Issues

The following issues exist:

Id	Issue	Details
AURA-388	WiFi Guest Access does not work with Microsoft Edge Browser	Guest Access on cnMaestro does not work with Edge browser on cnPilot 1.4.0-r12 with 3.2.1-6 and 1.5.0-r4 with 3.3 beta builds. Workaround: Users need to use supported browsers like Chrome, Firefox, or Internet Explorer (IE) 11.
AURA-470	Failure to load success page after quick pay authentication
AURA-474	Error contacting server when clicking on Orange Money button
CNSSNG-4083	DHCP errors after cnMaestro Reboot	When cnMaestro On-Premises is rebooted, after Data Import, sometimes DHCP and Disk Errors are encountered. Workaround: Explicitly run the dhclient command from the Command Line (accessed through the CLI) after reboot to assign the IP address.
CNSSNG-4906	Captive Portal Auto Login fails with latest Android devices	Workaround: Whitelist the URL for Google (*.google.com).
CNSSNG-5365	RADIUS Proxy drops packets after retry exhausted	After RADIUS Proxy Retries are exhausted in cnMaestro On-Premises, all subsequent RADIUS packets are dropped. Workaround: Reboot cnMaestro.
CNSSNG-7626	Access token is expired after data migration	Workaround: User has to generate a new token after the migration.
CNSSNG-7372	Auto sync always times out if the device IP changes during auto sync
CNSSNG-8304	ePMP: “No GPS Sync” or “GPS Sync Down” alarm/event not raised in cnMaestro	ePMP devices are not sending the GPS Sync status events to cnMaestro when GPS Sync is down or there is NO GPS Sync. Also for PMP GPS SYNC events, details shows sync source instead of indicating whether the GPS SYNC source is up or Down.
CNSSNG-10145	Certificate export is not part of Data Backup and restore	Certificates must be exported manually.
CNSSNG-10187	While Migration is happening moving or deleting a device from the Managed account will mark all the events and alarms as undefined once migration is completed
CNSSNG-10189	cnReach performance reports do not have throughput values for radios
CNSSNG-10223	MSP images not imported on server when exported in 1.6.3 and imported in 2.1.0	Workaround: Customers need to apply 1.6.3-r39 build and then import the data to 2.1.0

Where to Get Help

There are a number of places to get help with cnMaestro.

Cambium Community: The cnMaestro Forum provides the best place to ask questions and get up-to-date information.

1. On-Premises Quick Start Guide: This guide walks you through the initial management process and allows you to get onboarded quickly. It is embedded into the cnMaestro image and can be accessed on the Home Page of the UI. It can also be downloaded in PDF format from the Cambium Support website.

2. Cambium Support: The Cambium Support team is available 24x7 to answer questions and resolve issues.

[Telemar]

Upgraded today and in testing now.

The draw line between Tower and SM works (CNSSNG-10730) but will be helpful if there's a draw line on the map in dashboard too! (aattached file 2)

Another thing (but maybe is not a bug), now the uptime/downtime timer don't is readed in the SM (or AP) but start from the cnmaestro update (or virtual machine rebooted). Correct?

Exemple:

There's a SM powered from 10 days but cnMaestro shows 5 minutes (cnmaestro package updated 5 minutes ago)

There's a SM turned off from 10 hours but cnMaestro shows 5 minutes (cnmaestro package updated 5 minutes ago)

Attached file 1

• 1.JPG (32.4 KB)
• 2.JPG (23.3 KB)

[rnelson]

Looks like the update broke the cnMaestro API integration yet again.  Any reason why the underlying data model keeps changing?  I would like to think Cambium actually has tests to cover any breaking changes like this, especially for things like the returned data set.  After the last update to 2.0, I had to write tests to specifically detect these undocumented changes by Cambium.  Now they are detecting breakage once again.  If big changes are required, isn't this what api versioning is for (i.e. release API version 1.1 for the cnMaestro 2.x release)?

[Cambium_Ajay]

Hi,

First of all, sincere apology for inconvenience caused due to API breakage in 2.1.0. But the moment, we discovered the issue about API breakage in 2.1.0, we posted on forum and highlighted the exact issue. Please refer to below post:

http://community.cambiumnetworks.com/t5/cnMaestro/Issue-with-NBI-APIs-in-cnMaestro-On-Premises-Version-2-1-0/m-p/101823#M4895

Above issue got fixed as part of JIRA – 10988 in release – 2.1.1 and same is mentioned under Significant Fixes section in release note.

Please let us know if you are observing a different issue than what is captured in above post.

Thanks,

Ajay

[rnelson]

Thank you Ajay.  I was unaware of that forum post regarding the issue.  It was also not listed in the release notes as something that was fixed.  I would just like Cambium to have in place some build or check-in tests to catch these things.  

[KR1 (KR)]

Hi Telemar,

Regarding the device uptime and online or offline. cnMAestro device dashboard shows online/offline time wrt the websocket connection open/close with the server in the status widget. Also the device uptime is shown in the same status widget seprately. In the screenshot attached by you Online time is 07 minutes which is the device connection time with cnmaestro and the device uptime is 3days 13hours 14 minutes which is fetched from device directly when it communicates with the server. If the device goes offline then the uptime will be updated on its next successful web socket connection with the server. Please let me know whether this clarifies or you need more information on this.

Thanks,

KR.

[Cambium_Ajay]

Completely agree with you. We have taken measures to ensure that such issues don't recur.

Thanks,

Ajay

[sila]

hi guys,

Where can I download the cnmaestro on premise software? I downloaded the cnmaestro appliance image c4000 platfom but could not installed it on a worksation or a virtual box. Is that the correct one?

[vinod]

Hi Sila,

You can download the cnMaestro on premises software in the Support site -- Downloads -- Management Tools -- CnMaestro section.

Latest OVA is 2.3.0.

[sila]

Thanks Vinod, downloaded and now installed