How to create Templates in cnMaestro for PMP radio

Summary: 

This article demonstrates how to create a template in cnMaestro for ePMP devices

Solution:

A good method for creating new templates is to make the desired configuration change directly on a test device's web GUI and then export the configuration to use as a baseline.

If the test device is managed using cnMaestro you can go to Configure -> Devices, find that device and click the page icon under the View column. This will display the device's configuration as a template which you can save from that view.

If the test device is not managed by cnMaestro, from the device web UI download the Configuration File. The downloaded file can be used to create a template.

Search the text of the template for the configuration that you are interested in like Channel Frequency, Bandwidth etc. and remove everything else. You may use the text editor/Notepad++ for this part. Most of the parameters should have 1 or 2 matching with what you set in the web GUI.

Syntax

PMP devices need "cfgFileString" and "cfgFileVersion". 

There was an update made to automatically insert these parameters for the user before pushing to the device but that is not been deployed yet. For now, you should include them in all your templates.

 

{

                 "userParameters": {

                                     ...

                                                        },

                 "cfgFileString": "Canopy configuration file",

                 "cfgFileVersion": "1.0"

}

        Note:

  1. When you are done editing, validate the template using http://jsonlint.com/ to ensure the format is still correct. In case the format is not valid, this will tell you the exactly where is the issue. Most likely it will be a missing/extra comma or semicolon.
  2. You may also verify the template by applying it via device GUI and check for GUI error messages.
  3. The template should be in Json format

Sample:

Template to set the frequency on the PMP AP:

 

{

"userParameters": {

                                      "apRadioConfig": {

                                                                  "radioFreqCarrier": 3317500

                                                                       },

                                     "cfgFileString": "Canopy configuration file",

                                      "cfgFileVersion": "1.0"

                                       }

}

       Note:

  1. Some attributes are related to one another and if you wish to change the ethernet port speed, for example, you need to disable auto-negotiation as well. Some attributes will require a reboot of the device.
  2. A detailed description of each parameter and possible values can be found in the MIB file. The latest version of the MIB file as available at https://support.cambiumnetworks.com/files/pmp450/

Useful videos on configuring/pushing templates using cnMaestro

3 Likes