cnMaestro on Premises Server Monitoring, Management and Troubleshooting

This document explains how to monitor, management and troubleshooting cnMaestro On Premises server (i.e. NOC server). The cnMaestro On Premises server supports the followings: 

  • Monitoring
  • Server Health Monitoring
  • Management
  • Server Reboot
  • Server data Export
  • Server data Import
  • cnMaestro software package update
  • Manage device software images
  • Troubleshooting
  • cnMaestro Technical Support Dump
  • Log Level Settings
  • cnMaestro CLI commands

 Server Health Monitoring :

Navigation path : Manage > Server > Monitoring page

cnMaestro On Premises server provides health monitoring capabilities . This page displays various health statistic of server like CPU Utilization, CPU Load, CPU Jumps, Memory Usage, Disk Usage and Swap Usage.

All these statistics are plotted in the form of graphs and it gets updated at every 5 minutes interval for the 1/2/4/6/12/24 Hour display formats. However the page get updated every 1 hour for 1 week display format. It provides flexibility to operator to view the hourly/Daily/Weekly data. It also helps to find any health issues with Server such as CPU or Memory hikes and disk/swap usage.

 Server Reboot :

Navigation path: Manage > Server > Operations > Reboot Virtual Machine tab

cnMaestro On Premises provides the capability to Reboot server. The operator can reboot the server from cnMaestro instead of logging into CLI and triggering rebooting.

ServerReboot.PNG

Data Export :

Navigation path : Manage >Server >Operations > Import/Export Server Data tab

cnMaestro On Premises provides the capability to operator to Export the server data.

This feature is helpful for the operator to migrate the server data to a different NOC server or Cloud server.

Data Import :

Navigation path : Manage > Server > Operations > Import/Export Server Data tab

cnMaestro On Premises server provides the server  to operator to Import the server data.

This feature is helpful for useful for the operator to migrate the data to a different NOC server or Cloud server.

cnMaestro Package Update :

Navigation path : Manage >Server >Operations page > Apply cnMaestro Package tab

cnMaestro On Premises server provides the feature to update the software patch.

This feature is helpful for the operator to apply any hotfixes for the critical issues without waiting for the next software release.

Technical Support Dump :

Navigation path : Manage >Server >Diagnostics page > Technical Support Dump tab

cnMaestro on premises server provides Technical Support Dump capability. This feature helps operator to download dump of On Premises server and router logs and other useful debugging information.

This downloaded dump can be forwarded to Cambium customer support team for investigation and technical support.

Note :     It is advised to send the server technical support dump as well as the device Technical Support Dump in order to debug whether it is a device or server issue.

In order to take a device technical dump go to Monitor > Tools page and click Tech Support Dump icon (highlighted in below screenshot) to download logs and config file of the device. This file can be sent to the Cambium Support team for further debugging of the issue. It is supported for all device types.

Scenario-6.png

  • Log Level Settings :

Navigation path : Manage->Server->Diagnostics page

cnMaestro On Premises server provides the Log Level settings capability to operators. The Log Level Severity can be changed at runtime and it does not require reboot of server to take effect.

This feature is useful for the operators to change log details at run time based on need to debug any anonymities of server .

Manage Device Software Images :

The minimum required software version for devices in order to On Board to cnMaestro On Premises server are as follows

  • cnPilot E400/E500: 2.5.1-r9
  • ePMP 1000 Hotspot: 2.5.1-r9
  • ePMP: 2.6.2
  • cnPilot R200P/R201P: 4.2.3-R4
  • PMP 450 or 450i : 14.2.1(Support From June 2016 end tentatively)

The Cambium’s device software images can be downloaded from https://support.cambiumnetworks.com/ or Forum or cnMaestro On Premises server by navigating to Operate >Software Update > Manage Images.

Select the device and click the download icon to update respective device software images.

CLI Commands

cnMaestro on premises server CLI supports the following operations

  • Data Export
  • Data Import
  • Technical Support Dump
  • Server Package Update

In order to execute these commands, the operator needs to login to the  CLI prompt using default username and password (i.e cambium/cnmaestro) or the username and password set by the operator at the time of installation. These commands have to be executed using root user permissions. The user should type “Sudo su” on command prompt after CLI logging in.

CLI - Data Export :

Syntax : root@cnmaestro:/home/cambium# cnmaestro-export [-h] [--scp] [destination]

Data export can be done and the exported file can be saved locally or in the remote server using the SCP option. By default this file will be stored at the below location with the timestamp:

Location : 

/tmp/downloads/cnmaestro-export_cnmaestr_20160620T125119.tar.gz

Usage :

root@cnmaestro:/home/cambium# cnmaestro-export –h

CLI - Data Import :

Syntax  : root@cnmaestro:/home/cambium# cnmaestro-import  <File Location>

The data import can be done from specified path of exported data or from a remote file using the SCP option.

Usage :-  root@cnmaestro:/home/cambium# cnmaestro-import –h

CLI - Technical Support Dump :

The technical support dump can be downloaded using the command “cnmaestro-techdump”.

The file will be by default saved in below location with proper timestamp:

Location :

/tmp/downloads/cnmaestro-techdump_cnmaestr_20160620T130754.tar.gz

Usage : root@cnmaestro:/home/cambium# cnmaestro-techdump –h

CLI - Software Package Update :

The software package update can be done using the command “cnmaestro-update <FileLocation>”

The update file can be located locally or in the remote location which will be copied using SCP.

Usage :   root@cnmaestro:/home/cambium# cnmaestro-update –h

Configure NTP :- 

NTP is not configured on the released OVA, because it may negatively interact with the default time synchronization
within the VM. If you want to use NTP rather than the default, you can enable it through the cnMaestro command line (accessed through the CLI). The steps are below:
1. Make sure your virtual machine has Internet access, so it can reach an external NTP server.
2. From the command-line, type "sudo apt-get install ntp". Select "yes" when prompted. An NTP server will be
installed and started.
3. Turn off all time synchronization in your VM configuration. The steps to accomplish this are involved and
presented in the VMware Knowledge Base article 1189 (https://kb.vmware.com/kb/1189).

5 Likes