Cambium Networks

Services Server
Release Notes

System Release 1.2

• Product
System Release 1.2
Description
• Installation
•• Product Description
Fixed Issues
•• Known
Installation
Issues
• Fixed Issues
• Known Issues
 CAMBIUM NETWORKS

TABLE OF CONTENTS

General information .................................................................................................................... 3

2BVersion information ............................................................................................................................3
Contacting Cambium Networks .........................................................................................................3
Feedback..............................................................................................................................................3
Product Description.................................................................................................................... 4
Overview ..............................................................................................................................................4
Supported Devices ..............................................................................................................................4
Client/Server Requirements................................................................................................................5
Obtaining The Software .............................................................................................................. 5
Installation ................................................................................................................................... 5
Data Migration from 32 bit CNS Servers ............................................................................................5
Installing CNS Server 1.2 ....................................................................................................................6
Frequently Asked Questions (FAQ) .......................................................................................... 7
Issues Resolved From Previous Release ................................................................................. 8
Known Issues .............................................................................................................................. 8

2
 CAMBIUM NETWORKS

General information
Version information
2B

Issue Date of issue Remarks

001v000 June 2014 Initial release.

001v002 July 2014 Final release.

Contacting Cambium Networks

Support website: http://www.cambiumnetworks.com/support

CNS Server forum: http://mgmt.community.cambiumnetworks.com/

Main website: http://www.cambiumnetworks.com

Sales enquiries: [email protected]

Support enquiries: [email protected]

Telephone number list: http://www.cambiumnetworks.com/support/contact-support/

Address: Cambium Networks Limited,

3800 Golf Road, Suite 360
Rolling Meadows, IL 60008

Feedback
We appreciate feedback from the users of our products. This includes feedback on the quality and content of our
software as well as the structure, content, accuracy, or completeness of our documents. Send feedback to
[email protected].

3
 CAMBIUM NETWORKS

Product Description
Overview
The Cambium Networks Services (CNS) Server is a network management application provided by Cambium
Networks to manage ePMP devices.
Release 1.2 of the CNS Server introduces the following features and enhancements:
• Configure: Simplify network configuration and maintain consistency by centrally managing device settings
via user-defined templates.
o Create configuration templates for AP and STA
o Create configuration templates for specific functional groups (i.e. RF, networking)
o Push configuration templates to individual or batches of radios
o View current configuration of devices on demand.

• Native 64 bit support: CNS Sever now supports native 64-bit installations.
o Simplifies deployment and improves performance
o Note that if users of CNS Server 1.1 choose to retain existing data (i.e. discovered devices,
historical performance, etc.) a manual migration procedure is available below. Future releases of
CNS Server will provide automatic migration of this database.
o Starting with the CNS Server 1.2 (official release), 32-bit installations will no longer be
supported.

• HTTPS: The CNS Server can now use HTTPS for improved security.

• ePMP 2.0 Support: Full support for the 2.0 firmware. Firmware greater than 2.0 will also be supported, but
new features introduced after 2.0 will not be available.

• Improved Device Monitoring

o Simplified presentation of device historical performance data
o Addition of an AP “Connected STA” table with all relevant STA information

• Cambium Networks Device (CND) support file imports: Import device updates without having to do a
complete installation of the CNS Server.

• Additional Networking Configuration Options

o When multiple network interface cards are available, define which interface to use when managing
the devices.
o In cases where the CNS Server is behind a NAT, define an IP address that the devices can use
when doing configuration and upgrade operations.

For additional information on the features please review the CNS Server Quick Start Guide as well as the
documentation available from the CNS Server user interface.

Supported Devices
The table below shows the devices and software versions supported for this release.

Device Version

ePMP AP/STA 2.0 or greater. Note: The Configuration feature requires that the
ePMP devices be running version 2.0 software or greater to work
properly.

4
 CAMBIUM NETWORKS

CMM 3 3.0

CMM 4 4.0

Etherwan 8 port switches 1.3

Etherwan 14 port switch 1.93

Other versions of the devices listed above may be supported, however certain functionality may not be available, or
they will be discovered as generic devices.
Any device not listed in the table above will be discovered as a generic device provided that:

1. The device supports the standard 1213 MIB.

2. Implements the ifTable MIB.
3. Implements the ipAddrTable MIB.
4. Has a valid entry at either index 0 or 1 in the ifTable MIB.

For devices discovered as generic devices, management capabilities are limited to the Monitor application. The
device will be periodically polled for reachability, the traps defined by RFC 1215 will be interpreted, and the interface
table will be polled for key statistics. Software upgrade and device configuration are not supported for non-ePMP
devices.

Client/Server Requirements
Refer to the CNS Server 1.2 Quick Start Guide for details on the client and server requirements as well as
recommendations for deployment/security setup and configuration. The quick start guide is available at
https://support.cambiussmnetworks.com/files/cnss.

Obtaining The Software

The CNS Server 1.2 software can be obtained from https://support.cambiumnetworks.com/files/cnss.

Installation
Important – the CNS Server must be installed using a login with either Administrator or root level
permissions. When installing on Linux systems, either login as root, or use sudo when executing the
installer.

Data Migration from 32 bit CNS Servers

The CNS server will no longer support 32 bit platforms. For Customers that are currently using CNS Server
1.0, 1.1 or 1.2 beta (32-bit) and require that the CNS Server database be maintained after migrating to this new
CNS Server 1.2, please follow the steps outline below.

1. Backup the existing database:

a. Open a command shell and change to <server install directory>/stack/postgresql/bin.
b. Run the following command: pg_dump –U postgres –d cnss > “<server install
directory>/backups/cnss_db_backup.sql”
c. Copy the cnss_db_backup.sql file to a separate server or storage media such as a USB drive.
2. If the server is already 64 bit (Windows Server), uninstall the older version of the CNS Server.

5
 CAMBIUM NETWORKS

3. STOP: On the new (or existing) 64 bit server, follow the steps in the “Installing CNS Server 1.2” section
below before moving on to step 4.
4. After installing CNS Server 1.2, stop the CNS Server Service as follows:
a. Linux: service cnsserver stop (run service cnsserver status to verify the service is
down)
b. Windows: sc stop cnsserver (run sc query cnsserver to verify it is down)
5. Restore the database
a. Copy the cns_db_backup.sql file from step 1 above to <server install directory>/backups.
b. Open a command shell and change to <server install directory>/scripts.
c. Drop and create a fresh database by running the following scripts from the command shell:
i. Linux
1. drop_database.sh
2. create_database.sh
ii. Windows
1. drop_database.bat
2. create_database.bat
d. In the command shell, change to <server install directory>/stack/posgresql/bin.
e. Run the following command to import the old data: psql –username=postgres --
dbname=cnss < “<server install directory>/backups/cnss_db_backup.sql”
f. Change to <server install directory>/scripts.
g. Migrate the data by running the following scripts:
i. Linux: migrate_database.sh
ii. Windows: migrate_database.bat
6. IMPORTANT: If HTTP (not HTTPS) was selected during the install, prior to starting the server go to the
Admin page and update the HTTP Mode, HTTP Port, and HTTPS Port to the values specified during initial
installation.
7. Start the CNS Server Service using the following commands:
a. Linux: service cnsserver start (run service cnsserver status to verify it is
operational)
b. Windows: sc start cnsserver (run sc query cnsserver to verify it is operational)

Installing CNS Server 1.2

After downloading the installer, simply run it and follow the installation wizard prompts. If the CNS Server is
installed on a Linux server, be sure to review the host file and dos2unix recommendations from the Quick Start
Guide prior to beginning installation.
Note that console-only installation is also supported. Due to an open issue, the console installer may appear to
freeze for several minutes. If this occurs, wait about 10 minutes and the installation should complete normally.
After the installation wizard completes confirm that the services are running. To confirm the services are running,
open a command prompt and type the following commands:
On Linux:

• service lappstackApache status

• service lappstackPostgreSQL status
• service cnsserver status

On Windows:

• sc query wappstackApache

6
 CAMBIUM NETWORKS

• sc query wappstackPostgreSQL
• sc query cnsserver

If the service is not running it can be started by typing the following commands:
On Linux:

• service lappstackApache start

• service lappstackPostgreSQL start
• service cnsserver start

On Windows:

• sc start wappstackApache
• sc start wappstackPostgreSQL
• sc start cnsserver

Frequently Asked Questions (FAQ)

Over time, additional questions will be added to the FAQ on the CNS Server Forum located at:
http://mgmt.community.cambiumnetworks.com/

How can I view the active/inactive software versions, or the GPS firmware version, of all the “GPS Sync
Radios” in the network ?
In CNS Server Upgrade, click on the left-side menu “Reports”. Then select the report with the title “Devices with
Active/Inactive Software Versions”. Click the right-mouse button and select “Launch Report”. A report will be
generated in a new browser with each GPS Sync radio and its IP, MAC, device name, Active/Inactive software and
GPS firmware version and hardware type.

Why is device upgrade or configuration failing?

One possible reason a user may encounter this scenario is due to the fact that the following parameter must be
properly configured, ADMIN  GENERAL  “Network Facing Interface”. For servers with multiple network
interfaces, this parameter instructs CNS Server which interface should be used to communicate with ePMP devices.

If CNS Server is deployed behind a NAT, are there any additional parameters that must be configured in
CNS Server ?
Yes, please configure this parameter: “ADMINGENERAL “Device Accessible IP Address””.
If CNS Server is deployed behind a NAT, this parameter ensures that ePMP upgrades and configuration changes
are successful since the devices are explicitly instructed to download the files from the CNS Server.

In CNS Server, the ePMP device names in the Inventory list all show up as “CambiumNetworks”. How can I
make sure they each have a unique name ?
The “Device Name” in CNS Server is derived from the following fields on ePMP devices.

• STA Web UI: Configure System (Configuration)  System “Device Name”

• AP Web UI: Configure System (Configuration)  System “AP Name (SSID)”

7
 CAMBIUM NETWORKS

This assumes that ePMP ver 2.0 (or later) and CNS Server 1.2 (or later) are used.

Issues Resolved From Previous Release

The following were found by customer testing during the previous release and are fixed in this release.

ID Summary

21734 [Tables] Shift and control select broken when scrolling

21726 [Monitor]WAN Packets Dropped for STA device is showing 200% value

21724 [Monitor] View device toolbar button in inventory view not working.

21654 [Adviser] Fault Dashboard's right click menu does not work

21629 [Performance] - Map response is sluggish for 800 and more devices

21627 [Upgrade]Filter of result notification dialog box is not working

21623 [Discover]Sorting of Numeric columns is not working

21622 [Performance] - Client's response time is significantly high for 2500 devices

21611 [Adviser] Not all legend colors viewable for proxy poll charts in Probes page

21605 [Upgrade] Text field of Result Notification dialog filter is uneditable.

21540 [Discover] Find Devices accepting invalid network range

21535 [Discover]Sorting of Device ID is not working

21528 [Installer] Even when CNSS backend server fails to start, CNSS server is shown as running

21500 [Discover]Progress value exceeds 100% value

21498 [SimpleGrid][Finder] Inventory cells become uneditable

Known Issues
The following issues are currently open and will be addressed in a subsequent release.

Id Summary

CNS-1811 [Migration]View Configuration is not populating Name, device type, version fields

CNS-1803 Verify credential of generic device is showing green color for any login/password

CNS-1758 [Performance] cnsserver service takes unusually higher time to stop on Linux

8
 CAMBIUM NETWORKS

CNS-1653 [Monitor] Conflict between configuring lat/lon and using drag and drop.

CNS-1590 [Launcher]Services tabs are not getting displayed on IE browser

CNS-1516 [Provision]After configuring Community String, Configuration status does not show Success message
[Generic] PostgreSQL server failed to stop while running manager-Linux.run script and clicking Stop All
CNS-1377
button.
CNS-1278 [General] Do not open a RMI port for the Java backend

CNS-1014 [Monitor] [Fault dashboard] Filter not working for events listed in pie-charts and bar graphs.

CNS-810 [Monitor] Map appears to auto pan in some cases.

CNS-809 [Installer] Console installer seems to hang

CNS-751 [Discover] Log file names and events still use the name Finder.logs instead of Discover

CNS-750 [Discover] User is unable to delete half filled row

CNS-736 [Customer Found, Installer] Bitnami fails to install on Windows Server 2008 R2 standard SP1

CNS-539 [Adviser][Device Pages][ChartControlPanel] Lines goes out of the line chart