Introduction
This document highlights new features in cnMaestro On-Premises.
Important |
cnMaestro 2.4.0 On-Premises is distributed as an OVA file, which can be installed as a new Virtual Machine or used to update an existing installation running with 2.2.0/2.3.0/2.3.2 OVA. |
Important: Web Browser |
You may need to restart your browser or clear the browser cache with a hard reload after the 2.4.0 update. |
Introduction of Enterprise View
The existing Wireless LAN View is renamed Enterprise View.
cnMatrix Support in Enterprise View
cnMatrix devices are added to Enterprise View.
Switch Groups for cnMatrix Devices
Switch Groups are supported for cnMatrix devices to facilitate bulk configuration. They allow cnMaestro to fully provision cnMatrix devices. They are supported for cnMatrix devices running software version 3.0 or higher.
Switch Groups are available under the Shared Settings menu.
Template-Based Configuration for cnPilot Home
Template-based configuration is added back for cnPilot R devices. Templates can be used in addition to existing AP Groups, though only one method is supported at a time.
Configuration Backup/Restore for ePMP/PMP/cnReach Devices
Configuration backup option is available at the System and Device levels. A backed-up configuration file can be stored outside of cnMaestro using the Export option. Only the latest backup copy is maintained on the Server.
Restore is supported at the System/Network/Tower and the Device levels. Progress of restore can be tracked through a configuration job.
Tools Enhancement for cnPilot Enterprise
Flash LEDs is supported for cnPilot Enterprise devices as part of Device Tree and under the Tools page.
API Updates
New APIs
All newly introduced APIs schema is captured through Swagger documentation. For more details, refer to section 4 in the RESTful API document. The Swagger UI can also be accessed at https://docs.cloud.cambiumnetworks.com/api/2.4.0/index.html.
Path |
Details |
AP Groups API |
/api/v1/wifi_enterprise/ap_groups |
Returns list of AP Groups |
/api/v1/wifi_enterprise/ap_groups |
Create an AP Group |
/api/v1/wifi_enterprise/ap_groups/{ap_group_name} |
Returns a single AP Group’s information |
/api/v1/wifi_enterprise/ap_groups/{ap_group_name} |
Update an AP Group |
/api/v1/wifi_enterprise/ap_groups/{ap_group_name} |
Delete an AP Group |
/api/v1/msp/managed_accounts/{managed_account}/wifi_enterprise/ap_groups/{ap_group_name} |
Delete an AP Group of a managed account |
WLANs API |
/api/v1/wifi_enterprise/wlans |
Returns list of WLANs |
/api/v1/wifi_enterprise/wlans |
Create a WLAN |
/api/v1/wifi_enterprise/wlans/{wlan_name} |
Returns a single WLANs’s information |
/api/v1/wifi_enterprise/wlans/{wlan_name} |
Update a WLAN |
/api/v1/wifi_enterprise/wlans/{wlan_name} |
Delete a WLAN |
/api/v1/msp/managed_accounts/{managed_account}/wifi_enterprise/wlans/{wlan_name} |
Delete a WLAN of a managed account. |
Deprecation Notice for Existing APIs
All Managed Account level URLs (for example - /msp/managed_accounts/{msp_name}/<resource>), which are used for filtering resources under the managed account, are deprecated and will be removed in the upcoming release.
Request Methods |
Deprecated way |
New way |
GET |
/msp/managed_accounts/{msp_name}/<resource api> For example: /msp/managed_accounts/account_1/devices |
<resource api>?managed_account=<msp_name> For example: /devices?managed_account=account_1 |
POST |
/msp/managed_accounts/{msp_name}/<resource api> For example: /msp/managed_accounts/account_1/networks Body: { name: “network_1” } |
<resource api> Body: { managed_account: <msp_name> } For example: /networks Body: { name: “network_1” , managed_account: “account_1 } |
PUT |
/msp/managed_accounts/{msp_name}/<resource api> For example: /msp/managed_accounts/account_1/networks/network_1/ sites/site_1 Body: { name: “site_2” } |
<resource api> Body: { managed_account: <msp_name> } For example: /networks/network_1/sites/site_1 Body: { name: “site_2” , managed_account: “account_1 } |
Update Notice for Existing APIs
Path |
Details |
Devices API |
|
/api/v1/devices |
· A new property called target_managed_account is added for moving the device to different managed account |
Sites API |
|
/api/v1/networks/{NID}/sites |
· Updating site id is supported. · Updating site address is supported |
Performance API |
|
/api/v1/devices/performance |
· radio.radio1.rx_bytes, radio.radio1.tx_bytes, radio.radio1.throughput, radio.radio2.rx_bytes, radio.radio2.tx_bytes, radio.radio2.throughput were wrongly sent in bits in older versions. They are fixed to send in bytes. |
Statistics API |
|
/api/v1/devices/statistics |
· lan_status is enabled for PMP AP/SM devices also |
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 r195P |
4.7 |
|
cnPilot r195W |
4.5.2 |
|
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 |
|
cnPilot e425 |
4.0-r17 |
|
cnPilot e505 |
4.0-r17 |
|
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-13L |
4.5.2 |
|
ePMP PTP 550 |
4.1.1 |
|
ePMP MP 3000 |
4.5 |
|
ePMP PTP 550 E |
4.4.2 |
|
ePMP Elevate SXGLITE5 |
4.3.2.1 |
|
ePMP Elevate LHG5 |
4.3.2.1 |
|
ePMP 3000 |
4.4.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 |
cnRanger (Beta) |
Sierra 800 |
1.0.1.0-r1 |
Tyndall 101 |
1.0.1.0-r1 |
Supported Browsers
cnMaestro supports the following browsers:
Platform |
Browser |
Version |
MS Windows |
Internet Explorer |
11 and above |
Microsoft Edge |
44.17763.1.0 |
|
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-12694 |
Device still shows "registered" in Sectors page when device is "unregistered" in SAS admin page. |
CNSSNG-13057 |
Consider allowing spectrum inquiry in Registered - Halted State |
CNSSNG-13360 |
On-Premises "Domain proxy test" test is not working as expected |
CNSSNG-13695 |
Not able to update device under managed account using PUT APIs |
CNSSNG-13920 |
Need to finish the details for sev, cat, etc., for CBRS events |
CNSSNG-14265 |
Update grant limits in CBRS tool (45 dBm for FW and 46 dBm for Google for 450 SM) |
CNSSNG-14754 |
Sector import does not validate for center frequency and channel BW mandatory fields |
CNSSNG-14846 |
Request to adjust the 15 MHz and 3 0MHz EIRP limits in CBRS pop-up GUI to match spreadsheet changes. |
CNSSNG-14858 |
[CBRS Tool] UI CPI parameter to add new optional parameter cpeCbsdIndication to indicate AP/SM |
CNSSNG-14969 |
Throughput UL field is not sorting properly |
CNSSNG-15081 |
NBI API: In statistics APIs offset value is not reflecting in response paging header |
CNSSNG-15115 |
User Defined Overrides for cnPilot R devices are not pushed from onboarding page. |
CNSSNG-15370 |
Switch Group issue with name change and Tower/site change |
Known Issues
The following issues exist:
Id |
Issue |
Details |
AURA-388 |
Wi-Fi 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 |
|
CNREACH-139 |
Radio Software Update is not happening for EP based devices. |
|
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-5484 |
cnReach: Devices OFFLINE in cnMaestro despite device UI indicating CONNECTED |
|
CNSSNG-7626 |
Access token is expired after data migration |
Workaround: User has to generate a new token after the migration. |
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-9631 |
HA: Network cable unplug: Device count is taken from NOC1 and jobs/users list is taken from NOC2. |
|
CNSSNG-9632 |
HA: Network cable unplug: Devices onboarded during network disconnect needs to be reapproved by user. |
|
CNSSNG-10145 |
Certificate exports are 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 |
CNSSNG-11289 |
HA: No Standby Server Banner message will be seen for any bulk operation. |
|
CNSSNG-11299 |
AP Regulatory Channel list support check needed for checking valid channels. |
|
CNSSNG-11389 |
Microsoft Edge Browser does not support in system OVA file upgrade. |
Workaround: Use the Google Chrome browser |
CNSSNG-12888 |
Clients Connected count in the WLAN page is not properly shown when SSID is overridden for the WLAN at device level. |
|
CNSSNG-13144 |
CBRS Management Tool status field is not getting updated in heartbeat state. |
Workaround: Prior to syncing the configuration to the radios, any state change from the SAS does not automatically get updated on cnMaestro. A refresh on the Management tool page is necessary. |
CNSSNG-13416 |
“Radio frequency band is not CBRS supported” issue observed when we sync the device immediately after onboarding the device |
Workaround: Wait for at least 1 minute and then retry. |
CNSSNG-13429 |
MAC address filter is not working in Domain Proxy view tab. Search with case sensitive is not working |
|
CNSSNG-13457 |
For cnPilot R devices, if hostname has an embedded quotation mark, the name is truncated when pushed to devices. |
|
CNSSNG-13920 |
CBRS Alarms and Events only partially supported. |
|
CNSSNG-13987 |
After AP is onboarded and authorized, if later AP onboards using non-CBRS cnMaestro account, Device able to onboard with non-CBRS account. |
Workaround: Deregister and then unclaim the device in current CBRS account and then claim in another account. |
CNSSNG-14030 |
CBRS: Race condition: SM “stuck” in maestro during reparenting if import and start occurs as SM’s arrive in onboarding queue |
Workaround: To avoid this issue, follow the suggested SM reparenting procedures listed in the latest version of Cambium CBRS standalone procedures document. |
CNSSNG-14522 |
cnPilot R series device still shows red even after coming online |
|
CNSSNG-14557 |
Account page should auto refresh and “effective” should show green automatically instead of manual refresh |
Workaround: Try manual refresh and that will change the effective state to green colour. |
CNSSNG-14581 |
if Tower lat/long are modified, cnMatrix lat/long is not getting updated in the Inventory page. |
|
CNSSNG-14751 |
Issues with get operation for AP Groups through API. |
|
CNSSNG-14757 |
SAS IDs are not being proactively assigned to user once the pool of SAS IDs have been refilled. |
Workaround: Retry after 24 hours when you get the error like “New SAS IDs are unavailable”. |
CNSSNG-14887 |
Many parameters are missing in data exported from client (Wireless and Wired) guest stats (Export as CSV or PDF) |
|
CNSSNG-15430 |
Radius accounting messages Timeout and client disconnect observed during OVA staging and Performance report execution |
|
CNSSNG-15406 |
cnMatrix Host Name is not pushing to switch from onboarding page, if we change Hostname along with Switch Group/Template. |
|
CNSSNG-15344 |
Enterprise view : The Bulk device deletion is happens for all devices instead of devices under APs/Switches alone |
|
CNSSNG-15379 |
WLAN field set to null is removing the default/other fields created |
Known Issues for CBRS
Id |
Issue |
Details |
CNSSNG-15118 |
Status column in not updating in management tool when we connect more than 100 SMs in a sector |
|
CNSSNG-13987 |
After AP is onboarded and authorized, in case later AP used to onboarded into non-CBRS cnMaestro account, device is able to onboard with non-CBRS account. |
|
CNSSNG-14030 |
CBRS: Race condition - SM "stuck" in cnMaestro during reparenting if import and start occurs as SMs arrive in onboarding queue |
|
CNSSNG-15356 |
If a device has a weak serial number (less than 12 characters) and a non-CBRS build, when importing the sector first and then trying to onboard the devices (even with Cambium ID onboarding), device will not contact cnMaestro. |
Workaround: Delete the devices from server deregistering them from imported sector and delete) and then try to claim the devices using Cambium ID |
Where to Get Help
There are several places to get help with cnMaestro.
- Cambium Community: The cnMaestro Forum provides the best place to ask questions and get up-to-date information.
- 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.
- Cambium Support: The Cambium Support team is available 24x7 to answer questions and resolve issues.