Introduction
This document highlights new features and significant updates in cnMaestro On-Premises.
Important: OVA Upgrade
cnMaestro 5.0.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 cnMaestro 4.1.0.
Update 2/13: Customers should upgrade 3.2.0 and 4.0.1 installations to 4.1.0 before upgrading to 5.0.0.
Important: System Backup
It is strongly recommended to take a System Backup prior to upgrading to 5.0.0. This can be done in the UI at Administration > Server > Operations. This is required in case you ever want to downgrade to the previous version.
Email Reports 
Graphical and Data reports can be emailed to as many as 5 recipients.
Guest Access Portal Self-Registration (SMS and Email)
Guest Access Portal Self Registration is available for business visitors, retail customers, convention attendees, sports fans, and hotel guests. Users can register through a splash page or with administrator assistance.
To configure Self-Registration, in the Guest Access Portal navigate to Access > Enterprise > Self Registration.
Google Authentication for Guest Access Portal
Google Authentication is available for Wi-Fi onboarding of BYOD employees and students in educational environments.
Custom Enterprise Applications
Configure Custom Applications identified by Fully Qualified Domain Names (FQDNs) or IP Addresses to capture statistics or control Web access. Navigate to Configuration > Wi-Fi Profiles > AP Group > Services and enable “Enable Custom Application” under Application Visibility.
Add/Create Custom Applications
Navigate to Configuration > Wi-Fi Profiles > Custom Applications and click Add New.
Enterprise Device and User Group Policy for Application Control
User Group Policies map a user to an Access Control Policy (ACP) and VLAN using a RADIUS Filter ID. To configure User Group Policy, navigate to Configuration > Wi-Fi Profiles > AP Groups > Configuration > Access Control and click Add New button under User Group Policy.
Device Policies map an Access Control Policy (ACP), Device Class, and Type. To configure, navigate to Configuration > Wi-Fi Profiles > AP Groups > Configuration > Access Control and click Add New button under Device Policy.
Antenna Model Configuration for XE3-4TN Device
A new option is added to configure transmit power for Radio 1, Radio 2, and Radio 3 based on the Antenna model selected. This option is applicable only to the XE3-4TN device model. There are three ways to configure the Antenna model.
Device Level
Navigate to XE3-4TN Device > Configuration > Advanced Settings > Radio and Location . Select the Antenna Model under Radio1/2/3.
AP Group Level
Navigate to AP Group > Configuration > Radio > External Antennas and select appropriate Antenna model.
Bulk Configuration
Navigate to System > Configuration > Select XV-XE series > Select XE3-4TN Devices > Configure > Select AP group from the Drop-down list > Radios and Select the Antenna model.
MAC Address (ESN) Claim for cnMatrix Devices at Site Level
Existing device claim support at the Site level is enhanced to accommodate cnMatrix devices. Both cnMatrix and Wi-Fi APs can be claimed into the Site.
Home Site for cnPilot Home Devices
A new Home Site type is available for cnPilot Home devices. The cnPilot Home devices can no longer be placed in Enterprise Sites.
Automatic Spectrum Analyzer for PMP
Analyze and monitor the wireless spectrum to optimize network performance on PMP devices running software version 22.1.0 and above. Navigate to Network Services > Spectrum Analyzer and click Add New to add a new Spectrum Scan for APs. Also, access the Spectrum Analyzer’s last scan and Noise Floor results at the device level Dashboard.
Device Dashboard
Software Update Support for PTP 700 devices
Software update for PTP 700 devices has been added.
BER Performance Graph for PMP450i SM devices
BER (Bit Error Rate) graph has been added under Performance for PMP450i SM devices.
Fix Now Scheduled for Assists
Fix an issue found in Assists at a scheduled date and time.
Flood Link Test for PMP 450m devices
In Tools > Link Tests, added Flood Link Test option under Link Test Mode for PMP 450m devices.
Interfering Sectors for PMP Devices in Maps
Option “Show Interfering Sectors” is added to Maps to display all sectors that operate with potential interference/overlapping frequency to a selected AP or SM.
Automatic Assists Generation on Configuration Changes for PMP Devices
The system will automatically generate assists on configuration changes for PMP devices running software version 22.0 and above.
Community Knowledge Base Search
A global option is added to search for Knowledge Base articles in the Cambium Community.
60 GHz cnWave Auto Managed Routes Moved to cnMaestro Essentials
The 60 GHz cnWave Auto Managed Routes feature is moved to cnMaestro Essentials.
MSP (Managed Service Providers) Renamed Managed Accounts
The existing MSP (Managed Service Providers) feature is renamed Managed Accounts and placed within the Managed Services tab. This change maintains consistency between the cloud and on-premises menu, as the new Managed Subscribers feature was introduced in cloud. The inner tabs Managed Accounts and Managed Services are renamed Accounts and Account Services.
Miscellaneous UI/UX Improvements
Updates include consistent key-value pairs for chart legends, metadata text for dashboard widgets, refined header panels, and enhanced action icons in the tables with rollover effects. It also includes comprehensive styling changes for tables throughout the application.
Improved Legends for Key/Value Pairs
Added Color and Rollover Effects
Streamlined Header
Updated Data Table Design
API Updates
The Swagger documentation for the RESTful API is available at:
https://docs.cloud.cambiumnetworks.com/api/5.0.0/index.html
New APIs
| Request Method | Path | Details |
|---|---|---|
| 60 GHz cnWave | ||
| GET | /api/v2/cnwave60/devices/{mac}/best_route | Return the best route for a node. |
| POST | /api/v2/cnwave60/devices/{mac}/iperf | Start iPerf on a node. |
| POST | /api/v2/cnwave60/devices/{mac}/links/{link_name}/iperf | Start iPerf on a node and link node. |
| GET | /api/v2/cnwave60/devices/{mac}/iperf /api/v2/cnwave60/devices/{mac}/links/{link_name}/iperf | Return iPerf results. |
| cnArcher Installation Summary | ||
| GET | /api/v2/cnarcher/installation/summary | Return ePMP/PMP SM Installation Summary list. |
| GET | /api/v2/cnarcher/installation/summary/{mac} | Return ePMP/PMP SM Installation Summary. |
| Wi-Fi Enterprise | ||
| GET | /devices/{mac}/clients | Return list of clients at device-level with filter option of wired, wireless, and all clients. |
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 |
|---|---|---|
| 60 GHz cnWave | V1000 | 1.0 |
| V2000 | 1.2.2-beta3 | |
| V3000 | 1.0 | |
| V5000 | 1.0 | |
| cnMatrix | EX2K/EX1K | 2.0.4-r1 |
| EX3K | 5.0.1 | |
| cnPilot Home | cnPilot R200, R200P | 4.4.2-R2 |
| cnPilot R201, R201P | 4.4.2-R2 | |
| cnPilot R190V, R190W | 4.4.2-R2 | |
| cnPilot R195P | 4.5.2 | |
| cnPilot R195W | 4.7 | |
| cnRanger | Sierra 800 | 1.0.1.0-r1 |
| Tyndall 101 | 1.0.1.0-r1 | |
| Tyndall 201 | 2.0.0.0-r1 | |
| cnReach | N500 | 5.2.17e |
| cnVision | Hub 360r, FLEXr | 4.6 |
| Client Micro, Mini, Maxr | 4.6 | |
| cnWave 5G Fixed | B1000 (BTS) | 2.0 |
| C100 (CPE) | 2.0 | |
| Edge Controller | N/A | 1.0.0 |
| Enterprise Wi-Fi | cnPilot e400/e500 | 2.5.2-r3 |
| cnPilot e410/e430w/e600 | 3.5.2-R4 | |
| cnPilot e501S/e502S | 3.2.1-r6 | |
| cnPilot e700 | 3.8 | |
| cnPilot e425/e505 | 4.0-r17 | |
| cnPilot e510 | 3.11.4-r9 | |
| XE3-4 | 6.4 | |
| XE3-4TN | 6.5.1 | |
| XE5-8 | 6.4.1-r15 | |
| XV2-2 | 6.1 | |
| XV2-2T0 | 6.4 | |
| XV2-2T1 | 6.4.1-r15 | |
| XV2-21X | 6.5 | |
| XV2-22H | 6.5 | |
| XV2-23T | 6.5 | |
| XV3-8 | 6.0 | |
| 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 XM/XW | 3.2 | |
| ePMP Force 190 | 3.5 | |
| ePMP Force 300 | 4.1 | |
| ePMP PTP 550 | 4.1.1 | |
| ePMP Force 130 5 GHz | 4.3.2 | |
| ePMP 3000L | 4.3.2 | |
| ePMP Elevate SXGLITE5, LHG5 | 4.3.2.1 | |
| ePMP Force 130 2.4 GHz | 4.4 | |
| ePMP Force 300-19, 19R, 13 | 4.4 | |
| ePMP 3000 | 4.4.1 | |
| ePMP PTP 550 E | 4.4.2 | |
| ePMP MP 3000 | 4.5 | |
| ePMP Force 300-13L | 4.5.2 | |
| ePMP Force 300-13LC, 22L, 25L | 4.6 | |
| ePMP Force 200L | 4.7.0 | |
| ePMP 4000, Force 400 GPS, 400 CSM, 425 | 5.1.0 | |
| ePMP 4600, ePMP4600L, ePMP Force 4600C, ePMP Force 4525, ePMP Force 4500, ePMP Force 4625 | 5.4.0 | |
| PMP | PMP 450i, PMP 450, PMP 450m, PMP 430 SM | 15.0.1 |
| PTP 450, and PTP 450i | 15.0.1 | |
| MicroPoP Omni/Sector | 16.2.1 | |
| PMP 450v | 23.0 | |
| PTP | PTP 650 | 01-47 |
| PTP 670 (650 Emulation) | 01-47 | |
| PTP 670, PTP 700 | 02-67 | |
| PTP 820/850 | PTP 820C, 820E, 820F, 820G, 820S | 11.9 |
| PTP 850C, 850E | 11.9 | |
| Xirrus (Enterprise Wi-Fi) | XA4-240 | 8.7.0 |
| XD2-230 | 8.7.0 | |
| XD2-240 | 8.7.0 | |
| XD4-130 | 8.7.0 | |
| XH2-120 | 8.7.0 | |
| XH2-240 | 8.7.0 | |
| XR-620 | 8.7.0 | |
| XR-630 | 8.7.0 | |
| XR-2226 | 8.7.0 | |
| XR-2236 | 8.7.0 | |
| XR-2247 | 8.7.0 | |
| XR-2426 | 8.7.0 | |
| XR-2436 | 8.7.0 | |
| XR-2447 | 8.7.0 | |
| XR-4426 | 8.7.0 | |
| XR-4436 | 8.7.0 | |
| XR-4447 | 8.7.0 |
Supported Browsers
cnMaestro supports the following browsers:
| Platform | Browser | Version |
|---|---|---|
| Linux | Firefox | 45 and above |
| Chrome | 49 and above | |
| MacOS | Safari | 9 and above |
| MS Windows | Internet Explorer | Deprecated |
| Microsoft Edge | 44.17763.1.0 | |
| Firefox | 45 and above | |
| Chrome | 49 and above |
Significant Fixes
The following issues have been fixed:
| Id | Details |
|---|---|
| CNSSNG-10396 | Sector Visualization: allow user to switch sector radius “mode”. |
| CNSSNG-14932 | PMP/ePMP Configuration Backup: LAST BACKUP date and time is not updating if device under an MSP account. |
| CNSSNG-15244 | Web workers are not spawned with the count which is mentioned in the all.json. |
| CNSSNG-26223 | Unable to add the device in the cnMaestro CBRS management tool. |
| CNSSNG-27651 | Default device name not shown in Configuration tab. |
| CNSSNG-27905 | No Subscription available error observed while migrating AOS APs to cnMaestro cloud, leading to failure to migrate Xirrus APs. |
| CNSSNG-28134 | Block option is not working in clients. |
| CNSSNG-32694 | Google login is available before accepting T&C. |
| CNSSNG-33511 | cnMaestro X Cloud: nas_id_custom parameter missing in the get request response of the end point. |
| CNSSNG-34758 | cnMaestro Essentials (On-Premises): PMP 450 graphs not working after cnMaestro upgrade. |
| CNSSNG-34839 | Issue importing data. |
| CNSSNG-35059 | Unable to configure native VLAN in AP Groups API. |
| CNSSNG-35121 | Email logo is not displaying properly in the email. |
| CNSSNG-35683 | cnMaestro X (Cloud): Microsoft Azure login not working in the Guest Access portal. |
| CNSSNG-35728 | SIM file configured with static IP is not getting added to cnMaestro and BBU in NOC. |
| CNSSNG-36450 | Option to filter the Alarms based on the Name field. |
| CNSSNG-36452 | Message description not getting completed even after expanding the table. |
| CNSSNG-36545 | Include AP MAC in Client reports (last connected AP detail). |
| CNSSNG-37031 | Unable to delete Devices from 5.0.0 r9 build throws “Error While deleting the devices”. |
| CNSSNG-37071 | Backward compatibility issues in Devices Clients NBI API. |
| CNSSNG-37415 | Unable to login for MSP Tenant Account After on-perm Upgrade from 4.1.0 to 5.0.0. |
Known Issues
The following issues exist:
| Id | Issue | Details |
|---|---|---|
| CNSSNG-11299 | AP Regulatory Channel list support check needed for checking valid channels. | |
| CNSSNG-11389 | Microsoft Edge Browser does not support system OVA file upgrade. | Workaround : Use the Google Chrome browser |
| CNSSNG-12812 | cnPilot R-series dual radio devices (r-201P, r-195W) AP Group country code/SSID configured from overrides getting applied only to 2.4 GHz radio. | |
| CNSSNG-12888 | Connected Clients count in the WLAN page is not properly shown when SSID is overridden for the WLAN at Device level. | |
| CNSSNG-14030 | CBRS race condition: SM “stuck” in cnMaestro during reparenting if import and start occurs as SMs 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-14518 | Device Type selection needs to be provided at Site and AP Group for Report generation. | |
| CNSSNG-15356 | If a device has a weak serial number in a non-CBRS build, and the sector is imported first, the device will not contact cnMaestro. | |
| CNSSNG-15432 | Deleting a device in Base Infrastructure and claiming it immediately to another Managed Account returns Device Registration Failed message. | |
| CNSSNG-15595 | cnMatrix Hostname falls back to old Hostname if the template is pushed for the first time (if a Switch Group already exists). | |
| CNSSNG-15656 | Duplicate entries observed in 802.11ax Clients Report. | |
| CNSSNG-16197 | CBSDID search will not work when device was synced from tool without obtaining grant first. | Workaround : Perform CBSDID search from domain proxy view on Cloud to obtain mac address, then perform MAC address search on tool to find the device. |
| CNSSNG-18856 | cnVision Client is not shown under hub. | Workaround : Reboot the Client |
| CNSSNG-18913 | On resizing, the graph/widgets are not properly rendering. | |
| CNSSNG-18923 | After migration Reports Job page is empty due to cached data. | Workaround : Clear Cache and Cookies after migration. |
| CNSSNG-18927 | The configuration push from the Onboarding page is getting device timeout error in ePMP 1000 Hotspot device. | |
| CNSSNG-19264 | Unmanaged expired device approve button is not disabled. | |
| CNSSNG-19275 | Issues related to offline alarm of expired devices. | |
| CNSSNG-20508 | Last Super Administrator deletion should be shown proper error message. | |
| CNSSNG-20605 | User-Defined Overrides (Advanced) should be handled from Switch Groups > Switches > Actions > Configuration tab. | |
| CNSSNG-20745 | AP Count is -1 in Anchor when deregistering the device from Anchor. | |
| CNSSNG-20820 | After server upgrade, device throws error [Invalid CBSD ID and Grant ID], even though the Domain Proxy shows the device is registered. | |
| CNSSNG-21068 | Not able to deregister or delete the SM when PMAC mismatched (SM reported different PMAC). | Workaround: Reinitialize the SM from inside the sector of the AP, not by directly searching for the SM in the tool; then deregister and delete the device. |
| CNSSNG-21264 | Auto refresh does not work when Site/Tower/Device details are updated in Network level map. | |
| CNSSNG-21271 | SM status is missing in AP details on map. | |
| CNSSNG-21345 | RF Statistics related information should not be available in reports for XV type device. | |
| CNSSNG-21396 | Issues related to cnMatrix onboarding overrides. | |
| CNSSNG-23732 | Min Data Rate and Multicast Data Rate configuration push always sets default for both bands. | |
| CNSSNG-24529 | Multi-floor issue with Firefox browser. | |
| CNSSNG-24823 | Device overrides and config apply will not work after Migration from 3.1.0 to 3.1.1 due to cache. | |
| CNSSNG-24826 | Site Floorplan: in Edit mode, able to drag devices outside the boundary without an error. | |
| CNSSNG-25071 | If ePSK entries exist under an MSP WLAN, then upon disabling MSP in the account, the MSP WLAN ePSK count persists. | |
| CNSSNG-25150 | AOS device Configuration Job times out if Device is in DHCP. | |
| CNSSNG-25238 | AOS device WebSocket does not disconnect for an X account downgraded to Pure ESS after Retention expired. | |
| CNSSNG-25758 | Able to see cnPilot R-series AP Groups in Enterprise View. | |
| CNSSNG-28140 | Graphs alignment issues when menu bar is expanded. | |
| CNSSNG-28151 | Total device count and count displayed in Recommended Software metrics do not match. | |
| CNSSNG-28282 | Scheduled Reports for Expired device is completed. | |
| CNSSNG-28326 | AP Groups/Sites/Towers list all types of devices while generating reports. | |
| CNSSNG-28544 | While moving from one managed account to another, PTP device details are not updated properly. | |
| CNSSNG-30024 | Total Bytes and other KPIs doubled if navigated from Top User. | |
| CNSSNG-30040 | Change Bulk Edit and Import labels. | |
| CNSSNG-31607 | Voucher without enable access can save. | |
| CNSSNG-31626 | Export current page as CSV/PDF downloads all the client login events. | |
| CNSSNG-31883 | Techdump is not downloaded for PMP devices | |
| CNSSNG-32313 | Wired client list is empty when navigated back from a client. | |
| CNSSNG-33336 | Failed Reports are shown in green color. | |
| CNSSNG-33442 | Audit logs are not generated while creating graphical report templates. | |
| CNSSNG-33660 | The template should have a scroll bar. | |
| CNSSNG-33834 | Switch port operations are getting disabled. | |
| CNSSNG-33861 | Completed reports should transfer to Completed column immediately. | |
| CNSSNG-33908 | PMP performance reports have fields missing. | |
| CNSSNG-34447 | When both BTS and CPE config push with “sysName” field, under Configuration tab the change is not reflected. | |
| CNSSNG-36711 | Request timed out error seen when changing pagination from 10 to 25 in graphical report template page. | |
| CNSSNG-36717 | Assists are not showing any report for CPE until manual support. | |
| CNSSNG-36723 | Enabling Show Interfering Sectors should not display all the towers under the network. | |
| CNSSNG-36769 | Unable to apply custom application configuration after traversing from other pages. | |
| CNSSNG-36782 | Home sites are not listed while moving devices from inventory page. | |
| CNSSNG-37734 | Scheduled/Completed column in Reports is empty at all levels. |
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.
Cambium Support : The Cambium Support team is available 24x7 to answer questions and resolve issues.