cnMaestroTM 3.1.

0 Release Notes
Introduction

This document highlights new features and significant updates in cnMaestro On-Premises.

Important
cnMaestro 3.1.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
3.0.0/3.0.2/3.0.3/3.0.4.

Important: Web Browser

Restart your browser (or clear the browser cache with a hard reload) if you are having UI
problems with the 3.1.0 version.

Important: Two Interface Installations

Please review the section below on the enforcement changes for Management traffic
through eth0 and Device traffic through eth1.

Wireless Client Application Visibility

A dedicated page provides insight into the applications accessed by a Wi-Fi Client. This is only
supported for Enterprise Wi-Fi 6 Access Points. The feature must be enabled in the AP Group, so
the Access Points collect the application data and forward to cnMaestro.

Applications View

The Application page provides aggregate and time-series application details.

Wireless Client Dashboard and Performance

Wireless Client Dashboard and Performance pages improve insight into Client activity. This feature is
accessed by clicking any Client (Clients > Wireless Clients) at the System, Network, Site, or Wi-Fi
AP levels.

Wireless Clients Table

The Wireless Clients Table is presented below.

Wireless Client Dashboard and Performance Views

The Client Dashboard provides application and runtime details on the Clients. The Performance
page (not shown) displays key performance parameters over time.

CBRS Co-Existence for CommScope and Federated Wireless

Support is added for CBRS Co-Existence using CommScope or Federated Wireless SAS. This
support is already available for Google SAS users.

For CommScope and Federated Wireless, a "Merge User ID" option is displayed when importing a
new sector. The default behavior (when set to "yes") results in the tool sending CBRS registration
requests with the SAS User ID prepended to the Sector ID and Spectrum Reuse ID. This allows the
SAS to distinguish between operators (if both operators pick the same Reuse ID). In most cases,
operators will want the default behavior.

See the Cambium 20.3 PMP Training Course on the Cambium Networks Learning site for more
information. It details cases where an operator might want to set this to “no”.
Federated Wireless Enhancements

Federated Wireless operators will see the following additions to the Spectrum Inquiry Response pop-
up GUI.

1. A second view of the bar graph showing channel sorting by ranking.

2. A timer near the bottom of the pop-up GUI which counts down to the next CPAS cycle and
guides operators to wait until the timer expires to obtain a newly sorted spectrum inquiry
response, before making the final channel selections for grant requests.

See the CBRS Consolidated Procedures Guide for more details.

Other CBRS Enhancements

The addition and countdown timer shown above is available for Google and Federated Wireless
operators.

3.1.0 also adds support for newer CBRS alarms and events introduced in PMP version R21.0. The
ability for an operator to manually clear these CBRS alarms by alarm type has also been added, as
shown in the screenshot below.

Wi-Fi AP Configuration Updates and Bulk Overrides

The Wi-Fi AP Configuration flow has been simplified, and Bulk Overrides are added to efficiently
update values across many APs.

Primary Configuration Page

The simplified Device Configuration page is presented below. It is now used to filter devices.

AP Group/Template Selection and Bulk Overrides Page

A subsequent update page supports Bulk Overrides applied to selected devices.

Wireless Clients Report

Existing Wireless Clients Report is enhanced to provide an aggregate view of Client activity within a
period. Report generation can be scheduled and downloaded in CSV format from the
Administration > Jobs > Reports page.
.

Note the previous Client Report was a Session Report, which detailed statistics for each Client
connection. This has been moved to the Client Dashboard as Roaming History.

Guest Access Login Events Report

A new report type is added for Guest Access Login Events. Report generation can be scheduled and
downloaded in CSV format from the Administration > Jobs > Reports page.

Enhanced Packet Capture for Enterprise Wi-Fi APs

The existing Packet Capture tool is enhanced to create a packet capture file (with a ‘.pcap’
extension) that can be downloaded. It allows packet capture on a single interface or simultaneously
on multiple interfaces. This feature is supported for Enterprise Wi-Fi APs running software version
6.4 or higher.
SDR Moved to Essentials

The Software Defined Radios (SDR) support for XV3-8 Wi-Fi APs is now an Essentials feature.

Mesh Peers Moved to Essentials

The Mesh Peers detailed view is moved to Essentials.

cnArcher Installation Summary
The cnArcher Installation Summary is available at Network Services > cnArcher Installation
Summary. It is only supported by PMP SMs, and the cnArcher mobile application version must be
1.6.37 or higher.

cnArcher is used to install PMP Subscriber Modules (SMs), ePMP SMs, and cnRanger SMs. The
Installation Summary provides an overview of the data collected by cnArcher during the installation
process.

A list of PMP installations is presented below.

Details are captured and displayed for each install, including pictures taken at the site.
Map Enhancements
The MAP view is moved to the side tabs to provide better access.
Traffic Separation Enforced for Dual Interfaces
cnMaestro supports configuring two interfaces: eth0 for management/cluster traffic and eth1 for
control/device traffic. In previous versions of cnMaestro, the Web UI and Device traffic enforcement
was not enabled, because they both connected to the same Web Server. This behavior is updated in
3.1.0, and all Web UI traffic is now required to traverse eth0, and all Device traffic eth1.

Two Interface Installations

cnMaestro 3.1.0 enforces Web UI traffic through eth0 and Device traffic through eth1 in two
interface installations.

Citrix Hypervisor Installation

cnMaestro can be installed on Citrix Hypervisor (formerly known as XenServer). For detailed
installation steps, refer to Citrix Hypervisor Installation Appendix in the cnMaestro On-Premises
User Guide.

API Updates
The Swagger documentation for the updated RESTful API is found at:
https://docs.cloud.cambiumnetworks.com/api/3.1.0/index.html.

Changes to Existing APIs

Path Details
GET /api/v2/networks Type field is added for 60 GHz cnWave Networks.

New APIs

Path Details

GET /api/v2/cnwave60/networks/{network_id}/devices/overrides Multiple device configuration.

PUT /api/v2/cnwave60/networks/{network_id}/devices/overrides
GET /api/v2/cnwave60/networks/{network_id}/links
PUT
/api/v2/cnwave60/networks/{network_id}/links/{link_name}/{igniti
on|status}
POST /devices/{mac}/pull_config
Commit multiple device configuration.
Network level links topology.
Perform operation on device's link.
Initiate device pull configuration request.
 Returns result of device pull configuration
GET /devices/{mac}/pull_config
request.

Features Removed

Feature Name Details

L2GRE/EoGRE Tunnel Concentrator
As communicated during the 3.0.0 On-Premises release, this
feature is removed in 3.1.0. Please refer to the community
post for more details -
https://community.cambiumnetworks.com/t/deprecati
ng-l2gre-concentrator-from-cnmaestro-on-
premises/76275

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

V1000 1.0
60 GHz cnWave V3000 1.0
V5000 1.0
cnMatrix EX2K/EX1K 2.0.4-r1
cnPilot R200, R200P 4.4.2-R2
cnPilot R201, R201P 4.4.2-R2
cnPilot Home
cnPilot R190V, R190W 4.4.2-R2
cnPilot R195P 4.5.2
cnPilot R195W 4.7
Sierra 800 1.0.1.0-r1
cnRanger Tyndall 101 1.0.1.0-r1
Tyndall 201 2.0.0.0-r1
cnReach N500 5.2.17e
Hub 360r, FLEXr 4.6
cnVision
Client Micro, Mini, Maxr 4.6
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
Enterprise Wi-Fi
cnPilot e510 3.11.4-r9
XV3-8 6.0
XV2-2 6.1
XV2-2T0 6.3.5
XE3-4 6.4
ePMP 1000 Hotspot ePMP 1000 Hotspot 2.5.2-r3
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
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

PMP 450i, PMP 450, PMP 450m, PMP 430 SM 15.0.1

PMP PTP 450, and PTP 450i 15.0.1
MicroPoP Omni/Sector 16.2.1
PTP 650 01-47
PTP PTP 670 (650 Emulation) 01-47
PTP 670, PTP 700 02-67

Supported Browsers
cnMaestro supports the following browsers:

Platform Browser Version

Firefox 45 and above
Linux
Chrome 49 and above
MacOS Safari 9 and above
Internet Explorer Deprecated
Microsoft Edge 44.17763.1.0
MS Windows
Firefox 45 and above
Chrome 49 and above

Significant Fixes
The following issues have been fixed:

Id Details
CNSSNG-20441 DMZ external proxy is not working when cnMaestro has no internet.
CNSSNG-20556 Cannot sort wireless clients by hostname.
If an MSP account user is deleted, then the devices claimed by that user
CNSSNG-21169
are not reconnecting to cnMaestro.
AP not syncing: Configuration failed: system_name: Only alphabets, digits,
CNSSNG-21590
hyphens and underscores are allowed.
CNSSNG-22079 RF Quality does not update properly for ePMP 11 AX SM devices.
Alarm count is seen, but no record found in the alarms when clicking on
CNSSNG-22190
the alarm.
CNSSNG-22343 Alarm for link down still exists even if link is removed.
CNSSNG-22443 URL is stripped in the latest cnMaestro version 3.0.4-r59.
CNSSNG-22473 Announcement sync fails on on-premises connectivity.
SNMPv3 Username, SNMPv3 Password are mandatory fields under
CNSSNG-22506
Enterprise AP Groups>Configuration>Management.
CNSSNG-22911 Clients Now column in AP Groups table is not updating properly.
CNSSNG-22931 Does not showing performance on SFP port of TX2012R-P
CNSSNG-23062 Offline APs shown as online.

Known Issues
The following issues exist:

Id Issue Details
 Radio Software Update is not happening
CNREACH-139
for EP-based devices.
When cnMaestro On-Premises
is rebooted, after Data Import,
sometimes DHCP and Disk
Errors are encountered.
CNSSNG-4083 DHCP errors after cnMaestro reboot Workaround: Explicitly run the
dhclient command from the
Command Line (accessed
through the CLI) after reboot to
assign the IP address.
After RADIUS Proxy Retries are
exhausted in cnMaestro On-
RADIUS Proxy drops packets after Premises, all subsequent
CNSSNG-5365
retrying exhausted RADIUS packets are dropped.
Workaround: Reboot
cnMaestro server.
High Availability: Network cable unplug:
CNSSNG-9631 Device count is taken from Primary and
jobs/users list is taken from Secondary.
High Availability: Network cable unplug:
Devices onboarded during network
CNSSNG-9632
disconnect need to be reapproved by
user.
Certificate exports are not part of Data Certificates must be exported
CNSSNG-10145
Backup and Restore manually.
During Migration, moving, or deleting a
device from the Managed Account will
CNSSNG-10187
mark all events and alarms as undefined
once Migration has completed
AP Regulatory Channel list support
CNSSNG-11299 check needed for checking valid
channels.
Microsoft Edge Browser does not Workaround: Use the Google
CNSSNG-11389
support in system OVA file upgrade. Chrome browser
Failed - Bad Certificate' errors while
CNSSNG-11987 downloading the generated report after a
period of report generation.
cnPilot R-series dual radio devices (r-
201P, r-195W) AP Group country
CNSSNG-12812
code/SSID configured from overrides
getting applied only to 2.4 GHz radio.
Connected Clients count in the WLAN
CNSSNG-12888 page is not properly shown when SSID is
overridden for the WLAN at Device level.
Mismatch in Clients count for cnPilot E-
CNSSNG-13054 series device at WLAN and AP Group
configuration level.
Workaround: To avoid this
CBRS race condition: SM "stuck" in issue, follow the suggested SM
cnMaestro during reparenting if import reparenting procedures listed in
CNSSNG-14030
and start occurs as SMs arrive in the latest version of Cambium
onboarding queue CBRS standalone procedures
document.
Device Type selection needs to be
CNSSNG-14518 provided at Site and AP Group for
Report generation.
Deleting a device in Base Infrastructure
CNSSNG-15432
and claiming it immediately to another
 Managed Account returns Device
Registration Failed message.
cnMatrix Hostname fall backs to old
Hostname if the template is pushed for
CNSSNG-15595
the first time (if a Switch Group already
exists)
Duplicate entries observed in 802.11ax
CNSSNG-15656
Clients Report.
Issues related to Monetization
CNSSNG-15838
Subscription Events.
Subscriptions are not listed in the correct
CNSSNG-16019
order.
Workaround: Perform CBSDID
search from domain proxy view
CBSDID search will not work when
on Cloud to obtain mac
CNSSNG-16197 device was synced from tool without
address, then perform MAC
obtaining grant first.
address search on tool to find
the device.
Workaround: User must
After the migration completed for PPPoE
manually apply the AP Group
CNSSNG-17011 with server update, devices still show in
again on devices with minor
sync.
changes to the AP Group.
Tier issues related to 450i, 450i AP, and
CNSSNG-18710
450i SM.
On resizing, the graph/widgets are not
CNSSNG-18913
properly rendering.
After migration Reports Job page is Workaround: Clear Cache and
CNSSNG-18923
empty due to cached data. Cookies after migration.
Configuration push from Onboarding
CNSSNG-18927 page is getting device timeout error in
ePMP 1000 Hotspot device.
Graphs plotting is getting empty if the
CNSSNG-18936
page is zoomed out/in.
Unmanaged expired device approve
CNSSNG-19264
button is not disabled.
Expired Wi-Fi devices are not handled
CNSSNG-19273
for AP Group dashboards and tree level.
Expired devices count should not be
CNSSNG-19274
added to connection health graph.
Issues related to Offline alarm of expired
CNSSNG-19275
devices.
support for scheduled config jobs feature
CNSSNG-19511 is missing at Switch groups > Switches >
Actions > Configuration tab
Last Super Administrator deletion should
CNSSNG-20508
be shown proper error message.
User-Defined Overrides (Advanced)
CNSSNG-20605 should be handled from Switch Groups >
Switches > Actions > Configuration tab.
AP Count is -1 in Anchor when
CNSSNG-20745
deregistering the device from Anchor.
After server upgrade, device throws error
[Invalid CBSD ID and Grant ID], even the
CNSSNG-20820
Domain Proxy shows the device is
registered.
Not able to deregister or delete the SM Workaround: Reinitialize the
CNSSNG-21068 when PMAC mismatched (SM reported SM from inside the sector of the
different PMAC). AP, not by directly searching for
 the SM in the tool; then
deregister and delete the
device.
Auto refresh is not working when
CNSSNG-21264 Site/Tower/Device details are updated in
network level map.
cnMatrix devices are not reflecting in
CNSSNG-21268
maps.
CNSSNG-21271 Map: SM status is missing in AP details.
RF Statistics related information should
CNSSNG-21345 not be available in reports for XV type
device.
Issues related to cnMatrix onboarding
CNSSNG-21396
overrides.
Left side menu is not properly shown in
CNSSNG-21425
Firefox browser.
SM icon is missing in Network-level
CNSSNG-21703
Maps.
CNSSNG-22089 New Changes in Clients report in 3.1.0.
On Demand Packet Capture: Supported
CNSSNG-22116 Channel list for few country codes differs
between CnMaestro and AP.
Start now/ later buttons should be
CNSSNG-22518 disabled if wireless LANs are not
selected.
The device overrides are getting updated
CNSSNG-23100 with null values on every device
reconnect.
UI does not allow to save configuration
CNSSNG-23284
for eth4 interfaces.
Cloud Sync with cnMaestro as Proxy Workaround: Use the external
CNSSNG-23298
server will not work. server proxy
Workaround: Find the pid of
the CnsCloudSyncServer using
Cloud sync: cambium id is not getting
"sudo ps -ef | grep CnsCloud*"
CNSSNG-23322 updated if the cloud sync fails on the first
And then kill the process using
attempt after OVA upgrade
sudo kill -9 <pid>

Where to Get Help

There are several places to get help with cnMaestro.

1. Cambium Community: The cnMaestro Forum provides the best place to ask questions and
get up-to-date information.
2. On-Premises Quick Start Guide: This guide walks you through the initial management
process and allows you to get onboard 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.
3. Cambium Support: The Cambium Support team is available 24x7 to answer questions and
resolve issues.