Introduction
This document highlights new features and significant updates in cnMaestro 2.4.2 On-Premises.
Important: cnMaestro On-Premises 2.4.2 is a Package release rather than a full OVA image. It must be applied on top of an existing 2.4.1 On-Premises installation. Please follow the steps detailed in section 6.2 of the cnMaestro On-Premises 2.4.2 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.4.2 update.
CBRS Coexistence Phase 1
Two new parameters called “Sector ID” and “Spectrum Reuse ID” have been added to the AP (radio code R20 or later) CBRS configuration page to support Google SAS Co-Existence Phase 1. Cambium will inform operators when these parameters are available in Federated Wireless and CommScope.
Coexistence Sector ID: This parameter is also known as the identifier of a Common Channel Group (CCG) in CBRS Alliance or Principal Subordinate Single Frequency Group (SFG) in WinnForum Release 2. The Google SAS Portal currently calls it “Same Frequency” in the Frequency Management subsection of the per-device Configuration Tab as well as at the top of the per-device Coexistence (Co-ex) tab. Although this can be edited, it defaults to the MAC address of the AP/BHM of this sector. The purpose of the Sector ID is to help the SAS identify which SMs are grouped with a particular AP (same frequency and bandwidth as the AP).
Coexistence Spectrum Reuse ID: This parameter defines a CBRS interference coordination group. It is called Spectrum Reuse in WInnForum Release 2, or Interference Coordination Group (ICG) in CBRS Alliance. The Google SAS Portal currently calls it “Frequency Reuse” in the Frequency Management subsection of the per-device Configuration tab as well as at the top of the per-device Co-ex tab. Multiple sectors can be assigned the same Reuse ID. The SAS will not attempt to coordinate interference between devices using the same Reuse ID. For example, an operator using 2 non-overlapping center frequencies in what is typically called an ABAB deployment could assign 1 Reuse ID to all sectors using center frequency “A”, and a second Reuse ID to all sectors using center frequency “B”.
For additional details, refer to the CBRS Consolidated Management Procedures Guide, version 1.5 or later.
Support for CBRS LTE with 3rd Party BBU/RRH with Cambium SMs
Full Support for Cambium’s 3GHz LTE solution using 3rd party BBU/RRH and Cambium SM/CPE devices. This includes support for all 3 SAS Vendors (Google, CommScope, Federated Wireless).
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 Home | 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 | |
| Enterprise Wi-Fi | cnPilot e400/e500 | |
| 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 | |
| XV3-8 | 6.0 | |
| XV2-2 | 6.1 | |
| 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.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 | |
| Force 300-13L | 4.5.2 | |
| Force 300-13LC, 22L, 25L | 4.6.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.2 | |
| Retro | 16.2.2 | |
| PTP | PTP 650 | 01-47 |
| PTP 670 (650 Emulation) | 01-47 | |
| PTP 670, PTP 700 | 02-67 | |
| cnReach | N500 | 5.2.17e |
| cnRanger (Beta) | Sierra 800 | 1.0.1.0-r1 |
| Tyndall 101 | 1.0.1.0-r1 | |
| Machfu (Beta) | Machfu | 7.1.2-1.1.0.5 |
| cnVision | Hub FLEXr, 360r | 4.6.0 |
| Client MICRO, MINI, MAXr | 4.6.0 |
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-12167 | Wrong Passphrase pushed to AP in WLAN Group. |
| CNSSNG-12455 | MAC Address format should be unique in all configuration parameters. |
| CNSSNG-13171 | Improvements to Spectrum Inquiry Response graph in Tools. This release now shows the height of each bar in the graph proportional to the EIRP, if that information is provided by the SAS vendor. |
| CNSSNG-13867 | Software Update Jobs have completed; however, notification still shows 1 extra count. |
| CNSSNG-14173 | CBRS Management Tool better displays information on operational parameters in SAS responses. This includes a new column to show “SAS Recommended EIRP” printing related text via hover over bubble, and the ability to request the SAS recommended EIRP by clicking on the START button. See the CBRS Consolidated Procedures Guide for more information. |
| CNSSNG-14798 | Option to set Time Zone from cnMaestro UI (On-Premises Only). |
| CNSSNG-15160 | Enable/disable SSH access from cnMaestro UI (On-Premises Only). |
| CNSSNG-15250 | Improvements to CBRS heartbeat interval and timeout handling. |
| CNSSNG-15251 | Separate billing and technical contact information requested on CBRS Services Accounts page, instead of a single set of contact information. |
| CNSSNG-15256 | A Reimport option has been added to the CBRS Management Tool spreadsheet import function. If, for example, an operator made the same configuration mistake on every device in a sector, previous options were to edit every device one-at-a-time via pop-up GUI or delete everything and re-add with a new sheet. Now operators can use the Reimport function to change installation parameters or EIRP in any state, although a deregistration will be triggered. Changing BW or Center frequency is also supported via Reimport, but only if all devices in the sector are deregistered prior. |
| CNSSNG-15258 | The CBRS Management Tool supports live status updates of the CBRS state of the radio. Prior to 2.4.1, the CBRS state of the device was frozen after the device flips to config_sync state. Now this field, as well as others, are updated from the device. See the cnMaestro Cloud User Guide for additional details on live status updates.The CBRS Management Tool supports an Export function to recreate the spreadsheet based on current tool entries. The CBRS management tool also supports ODS file format for import instead of just Excel. Note export to ODS format is not yet supported. Editing EIRP for Config_synced devices is supported from cnMaestro, rather than just directly on the devices. See the CBRS Consolidated Procedures Guide for more information. The CBRS Management Tool now allows editing parameters for devices in Not_Synced config states other than deregistered/unregistered: one can edit parameters in an AUTH/Not_synced state although a deregistration is forced by cnMaestro as part of the edit. |
| CNSSNG-15259 | cnMaestro Reports generate CBRS related data. |
| CNSSNG-15406 | cnMatrix Hostname is not pushed to Switch from Onboarding page if changed along with Switch Group/Template. |
| CNSSNG-15410 | SMs connected to ePMP 3000 are not shown under the AP in the cnMaestro tree. |
| CNSSNG-15525 | Removing devices from CBRS Management Tool no longer deletes them from cnMaestro inventory/onboarding queue. CBRS Tool replaces the old method of Deregister per device via checkbox with Delete and Deregister action buttons. With this improvement, “Deregister All” and “Delete All” options are supported. |
| CNSSNG-15589 | Slightly higher EIRP limits allowed for certain SAS vendor/model combinations as follows: Federated Wireless SAS: 450 SM, old limit = 45 dBm, new limit = 46 dBm, 450 AP, old limit = 45 dBm, new limit = 46 dBm 450i AP old limit = 46, new limit = 47 Google SAS: 450i old limit = 46, new limit = 47 Note : While 16.2.1 radio code supports operation with these higher limits if the Grant is obtained from the cnMaestro tool, 16.2.1 code does not support the radio requesting the higher values directly. Existing operators who deployed devices with these lower limits who want to bump up their power by 1 dB should see the CBRS Consolidated Procedures Guide version 1.3 for editing EIRP on a config_synced radio. Until newer radio software is available, an existing operator who wishes to obtain a grant with 1 dB higher power will have to deregister such device long enough to request a new grant from the tool, then sync this new grant to the device. This should be done in a maintenance window prior to a CPAS cycle. |
| CNSSNG-15621 | The mailing address used as a login to enter MSP users should not be case sensitive |
| CNSSNG-15724 | Alarm CBRS_GRANT_SUSPEND does not clear. |
| CNSSNG-15726 | Invalid configuration generated when VLAN DHCP Relay Agent is cleared. |
| CNSSNG-15903 | Mismatch in parameters in Performance Reports (Backhaul vs Enterprise Account types) |
| CNSSNG-16238 | Account field at AP Group > Network > SIP Subscriber Information does not accept special characters other than underscore (_). |
| CNSSNG-16250 | Exported ePSK entries are not human-friendly. |
| CNSSNG-16402 | DFS Status field with HTML tag in cnMaestro UI. |
| CNSSNG-16471 | “Error while replacing device variables in template” if customer AP Group is pushed from Onboarding page with Auto-Provisioning Rule. |
| CNSSNG-16625 | If the Local IP address is out of DHCP range, that IP should be allowed for cnPilot R-series from AP Group > LAN setting. |
| CNSSNG-17504 | cnPilot R-series SSID Max Client range is wrong and “Allowed Remote IP” does not accept CIDR notation. |
| CNSSNG-18309 | Switch Port configuration does not display for all ports. |
Known Issues
The following issues exist:
| Id | Issue | Details |
|---|---|---|
| AURA-470 | Failure to load success page after Quick Pay authentication. | |
| 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 | After RADIUS Proxy Retries are exhausted in cnMaestro On-Premises, all subsequent RADIUS packets are dropped. | Workaround: Reboot cnMaestro. |
| CNSSNG-9631 | High Availability: Network cable unplug: Device count is taken from Primary and Jobs/Users list is taken from Secondary. | |
| CNSSNG-9632 | High Availability: Network cable unplug: Devices onboarded during network disconnect need 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 marks all the events and alarms undefined once migration is completed. | |
| 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-11987 | Bad Certificate errors while downloading a Report after a period of generation. | |
| CNSSNG-12812 | cnPilot R-series dual radio devices (r-201P, r-195W) AP Group Country Code/SSID configured from Overrides 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-13144 | CBRS Management Tool status field is not 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-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 drop down needs to be provided at Site and AP Group level for Reports generation. | |
| CNSSNG-15432 | Deleting a Device in base infrastructure and claiming it immediately to another Managed Account returns Device Registration Failed message. | |
| 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 a 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-16257 | Exported File Device Type is empty when the original Device Type is mismatched from the imported Type: UI shows incorrect Device Type | Workaround : Reimport with correct Device Type or delete the sector and import with correct Device Type. |
| CNSSNG-16258 | If sector is not started, and Device Type is different, the CBRS process will not start and throw error 200 [installationparam]. | Workaround : Reimport with correct Device Type or delete the sector and import with correct Device Type. |
| CNSSNG-16260 | If SM Device Type is not correct, then SM will never show config synced. | Workaround : Reimport with correct Device Type or delete the sector and import with correct Device Type. |
| CNSSNG-16262 | When moving from part 90 to 96 and CBRS Tool has incorrect Device Type, even though the tool shows configuration synced, the AP will not start transmission. | Workaround : Reimport with correct Device Type or delete the sector and import with correct Device Type. |
| CNSSNG-18501 | MaxEIRP values per device in the Tool Grid and Edit Pop-up don’t reflect and live updates from the radio for the BW. | While the Tool Grid and Edit icon will not have the updated values, a Reimport operation WILL show the proper MaxEIRP values based on radio live updates to the BW. |
| CNSSNG-18523 | Decimal Precision on cnMaestro vs Integer values on the Radio for CBRS EIRP sometimes causes deregistration on Reimport. | This can be seen when doing a Reimport action while using 30Mhz or 15Mhz BW’s. Existing sectors not intended for change might be deregistered after the operators is forced to adjust down the Requested EIRP (for example from 51 to 50.8 for 30Mhz BW). One available workaround is: if, after Reimport, the Requested EIRP shown by default for SMs not modified, shows a value higher than MaxEIRP in the Update EIRP pop-up, exit the pop-up and edit the necessary devices in the Tool 1 at-a-time using the pencil icon to avoid unwanted deregistrations. |
| CNSSNG-18778 | Authorized and config synced PMP and LTE SMs show under the “Calculate EIRP” table of the “Update EIRP” pop-up when a START or Re-Init action is invoked for an LTE sector. | Workaround: Ignore the EIRP values in this table for existing SMs: edit or update what is necessary (i.e. newly added SMs). |
| CNSSNG-18784 | While Importing a new CBRS template of devices into the Management Tool, Spectrum Reuse IDs added in the actual devices do not show as selectable values. | Although Reuse IDs added directly in an AP’s GUI (rather than added on cnMaestro) will show up in the Tool main page via live status, they will not be presented as a selectable ID in the Import Pop-up when adding a new sector. The workaround is to “ADD” this Reuse ID via the Import Pop-up. |
| CNSSNG-18859 | EPMP MP 3000 AP and SM hierarchy in the tree fails if the SM is approved after a long period. | Workaround: Please reboot the SM so it shows under the AP in the cnMaestro tree. |
| FLCN-7857 | cnMaestro GA redirection fails with WLAN is mapped to NATted interface. |
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.