cnMaestro 5.0.0 (On-Premises) Release Notes


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 X

Graphical and Data reports can be emailed to as many as 5 recipients.


Guest Access Portal Self-Registration (SMS and Email) X

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 X

Google Authentication is available for Wi-Fi onboarding of BYOD employees and students in educational environments.


Custom Enterprise Applications X

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 X

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 X

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 X

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 X

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 X

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 X

The Swagger documentation for the RESTful API is available at:

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
Tyndall 101
Tyndall 201
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 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.


My instance tells me te following:

Unsupported Upgrade - 5.0.0-r5 OVA cannot be applied on 4.1.0-r3

Any way to upgrade 4.1.0-r3 to 5.0.0-r5?

Info @All,

the problem was related to AVX, changing the CPU emulation on hypervisor to host made it work.

1 Like

Thanks. Same here on Proxmox 8.1. Changed CPU to host and upgrade ok.

1 Like

I don’t know in which language you all are talking in. We run cnMaestro using KVM as the hypervisor. Any thoughts on that we would need to do to be able to install 5.0.0-r5?

We are not able to use cnMaestro 5.0.0-r5 because the xeon processors in our servers do not support the avx instruction. I guess we are stuck on 4.1.0-r3 forever.

The cloud based version is a non starter.

Hi, I have mounted the new OVA with cnmaestro 5 and I have not been able in any way to restore the backup of version 4.1, without knowing of any bugs in this regard, let me know if possible, it always gives an error once supposedly finished. Thank you.


1 Like

We have the same problem. Have you figured it out?

1 Like

Not yet, this week I will talk to support

I have 2 anchor accounts, 1 is where the SAS is paid and all our devices are connected to the other (long story IDK). Well as part of the migration I wanted to change and consolidate to a single anchor account. So on the new instance of cnMaestro I used the anchor account that is used to pay the bills, the backup came off cnMaestro that used the other cambiumID.

I had to reload r4 because for some reason you cannot change the cambiumID and make it the same as our other cnMaestro and then the backup loaded just fine. Then I was able to upgrade to R5.

OK, thanks for sharing the experience, I’ll look into that topic.

OK, thanks for sharing the experience, I’ll look into that topic.

Hi, I have finally been able to solve the problem, the way to do it was to first delete the anchor to the cloud, then generate the backup and then restore that backup in release 5, otherwise it had not worked for me.

1 Like