Introduction
This document highlights new features and significant updates in cnMaestro On-Premises.
Important |
cnMaestro 2.3.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.1.0/2.2.0 OVA. |
Important: Web Browser |
You may need to restart your browser (or clear the browser cache with a hard reload) after the 2.3.0 update. |
Webhooks (On-Premises)
Webhooks provides real-time streaming for Alarms using a push notification model. It uses HTTPS POST to asynchronously forward alarm data to external Web Services, such as Slack, Twilio, Zapier, Datadog, and PagerDuty. Webhooks configuration is available at Application > Settings > Webhooks.
Audit Logs
cnMaestro now supports Audit Logs, which record administrator activities. Audit Logs entries can be found at Application > Audit Logs.
System Events (On-Premises)
cnMaestro System events are now accessible. They include infrastructure events (such as for high availability) and system resources (such as CPU, disk, and memory).
Syslog Server (On-Premises)
Ability to stream events and audit logs to an external system log server. Syslog server configuration is available at Application > Settings.
Automatic Software Update
Support automatic software update during onboarding and for managed devices. This feature allows one to configure a software version and automatically update devices during onboarding for new devices, or through scheduled updates for currently managed devices. Software Update Jobs are split to track the progress of manual and automatically created jobs. The Automatic Software Update option is available at Application > Server > Software Images.
Software Update > Auto Jobs
Troubleshooting Tools for On-Premises (On-Premises)
Support basic troubleshooting tools such as ping, DNS Lookup and Traceroute in the On-Premises server. This feature is available at Application > Server > Diagnostics > Network Tools.
Increased cnMaestro Users Limit (On-Premises)
The limit for cnMaestro users is increased from 10 to 100. Please note10 remains the maximum for Essentials, and 100 uses will be a future Pro feature.
Web Access for Device UI Launch
Launch the device Web UI using the configured access protocol (HTTP/HTTPS) rather than defaulting to HTTPS. For this feature to work correctly, cnPilot Enterprise devices must be mapped to AP Groups.
Special Characters in Object Names
Support special characters in Networks, Sites, Towers, AP Groups, WLANs, and Managed Accounts names. Previously, special characters were limited to hyphen (–) and underscore (_).
Association ACL in Managed Accounts (MSP)
Association ACLs are now available in Managed Accounts (previously, they were limited to the Base Infrastructure).
Improvements to Configuration Sync
Configuration Sync is enhanced for cnPilot devices to automatically execute blocked jobs when they become unblocked. Earlier, manual intervention was needed.
Rename AP Groups and WLANs
Ability to rename AP Groups and WLANs.
Roaming History for Mesh Peers
Roaming history for Mesh Peers is available and similar to regular wireless clients.
Exclusive WiFi4EU Template for Guest Access Portal
WiFi4EU template added to support easy customization of splash page for WiFi4EU-based Guest Access Portals.
Hostname Change for cnPilot Home Devices
Push hostname changes to cnPilot Home devices. This requires device software version 4.6-R5 or higher.
Improvements to cnMatrix Support
The improvements include the ability to modify hostname and a new Tools page for advanced debugging. These features are supported on cnMatrix devices running software version 2.0.5 or higher.
Report for Capped PMP SMs
Capped SM data is available in the Inventory view and SM Device Details page.
Inventory View
Device Details Page
Additional Statistics and Performance Graphs for PTP
Aux Speed And Duplex |
Aux Rx Frames Oversize |
Aux Rx/Tx Bandwidth Utilization |
Main PSU Speed And Duplex |
Main PSU Rx Frames Oversize |
Main PSU Rx/Tx Bandwidth Utilization |
SFP Speed And Duplex |
SFP Rx Frames Oversize |
SFP Rx/Tx Bandwidth Utilization |
The following Performance graphs have also been added
Aux Rx/Tx Throughput |
Main PSU Rx/Tx Throughput |
SFP Rx/Tx Throughput |
Zero Touch Onboarding for ePMP SM Devices (Cloud)
ePMP SM devices will automatically appear in the Onboarding Queue, as long as their parent AP is already onboarded. This functionality is already supported for PMP. This configuration is available at Application > Settings.
General UI Improvements
Improved responsive design for mobile devices, especially configuration. Also, column resizing and column reordering capabilities in grids.
Swagger Support for NBI API Documentation (On-Premises)
Swagger documentation can be launched from Services > API Clients for individual API Clients. It also provides a live playground to test APIs.
API Updates (On-Premises)
New APIs
Path |
Details |
Software Update (Section 23) |
|
/jobs?type=software |
List of software update jobs |
/jobs?type=software |
Create a software update job |
/jobs/{job_id}?type=software |
Get software update job by specific job id |
/jobs/{job_id}/details?type=software |
Get software update job device details |
Managed Accounts (Section 20) |
|
/msp/managed_accounts |
Create a managed account |
/msp/managed_accounts/{account_name} |
Update a managed account |
/msp/managed_accounts/{account_name} |
Delete a managed account |
Managed Services (Section 21) |
|
/msp/managed_services |
Create a managed service |
/msp/managed_services /{service_name} |
Update a managed service |
/msp/managed_services /{service_name} |
Delete a managed service |
/msp/managed_services |
List of managed services |
New device support added |
|
PTP |
Check Device API (Section 8) , statistics API (Section 13), performance API (Section 14) |
cnMatrix |
Check Device API (Section 8) , statistics API (Section 13), performance API (Section 14) |
cnReach |
Check Device API (Section 8) , statistics API (Section 13), performance API (Section 14) |
Wired clients API (Section 15.2 ) |
|
/api/v1/devices/wired_clients |
List wired clients |
AP Group API |
|
/wifi-enterprise/ap_groups |
List AP Groups |
WLAN API |
|
/wifi-enterprise/wlans |
List WLANs |
Updated/Deprecated APIs
Path |
Details |
Devices API |
|
/api/v1/devices |
· maximum_range field will be in Kilometers |
Statistics API |
|
/api/v1/devices/statistics |
· distance field is changed to be in Kilometers |
Performance API |
|
/api/v1/devices/performance |
· In 2.x we also changed the response format inside the radio object. |
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 |
|
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 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 |
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-6461 |
Add Device Name configuration support for cnPilot R. |
CNSSNG-7009 |
Include failure reason in configuration syncReason when configuration fails for WiFi devices. |
CNSSNG-10554 |
Association ACL configuration support is available only in Base Infrastructure Profile. |
CNSSNG-10629 |
Support renaming AP Groups and WLANs. |
CNSSNG-10765 |
Auto upgrade feature. |
CNSSNG-10803 |
Track units for ePMP/PMP "Max Range" mile or kilometres. |
CNSSNG-11637 |
Use web access mode configured on devices to launch device web UI. |
CNSSNG-11922 |
Add WLAN API is failing in the AP groups page, when the server has more than 2000+ WLANs. |
CNSSNG-12055 |
Add support to update active and inactive software versions in a single job with site-based update support. |
CNSSNG-12088 |
Allow special chars in Site names. |
CNSSNG-12327 |
Add support for Mesh Peers history. |
CNSSNG-12393 |
User intervention required when configuration jobs are blocked. |
CNSSNG-12394 |
Verification Failed configuration scenario not handled well. |
CNSSNG-12463 |
Wireless client Page not showing EPSK username for connected clients. |
CNSSNG-12578 |
Show details for capped PMP SMs in cnMaestro. |
CNSSNG-13539 |
Problems with saving the L2TP Tunnel configuration. |
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-7372 |
Auto sync always times out if the device IP changes during auto sync |
|
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 |
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 particular WLAN at device level. |
|
CNSSNG-13457 |
For cnPilot-R devices, if hostname has an embedded quotation mark, the name is truncated when pushed to devices. |
|
RBN-280 |
DHCP Option 15 not working for cnPilot Home |
DHCP Option 15 onboarding is not working for cnPilot Home devices (R-series). These devices cannot use this onboarding mechanism. |
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.
- 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.