This document explains about the device on boarding to cnMeastro NOC server and configuring the DHCP server either Windows or Linux to send the DHCP options 15, 43 and 60 to the Cambium Devices.
1) Minimum Required Software Version for Devices in order to on board to cnMaestro NOC :-
cnPilot E400/E500: 2.5.1-r9
ePMP 1000 Hotspot: 2.5.1-r9
ePMP: 2.6.2-RC12
cnPilot R200P/R201P: 4.2.3-R4
PMP 450 or 450i : 14.2.1(Support From June 2016 end tentatively)
2) Onboarding Methods :-
Devices can be on boarded to cnMaestro NOC server in the following ways
Claim Through MAC Address
Claim Through Static URL without Cambium ID and on Boarding key
Claim Through Static URL with Cambium ID and on boarding key
Zero touch on boarding using DHCP option 43
Zero touch on boarding using DHCP option 15
Order of Device Discovery
2.1 Claim Through MAC address
In order to claim through mac address , please follow the following steps
Login to NOC server using default username and password (admin/admin) or the Username and Password set by the Administrator at the time of NOC server installation
Navigate to Home->On board Devices-> Claim from cnMaestro
Select the Device type for which on boarding is to be done and provide the MAC Address in the combo box and click the Claim Devices button.
Multiple MAC Addresses of same device type can be claimed using ( , ) separator between MAC Addresses or by entering them in the new line
Note :- Before claiming through MAC Address user needs to Login to device GUI and navigate to Configure->System menu in ePMP 1000/ePMP 1000 HotSpot/cnPilot E400/E500 devices or Administration->cnMaestro in cnPilot R200P/R201P devices or Configuration->cnMaestro in PMP devices.
cnPilot R200P/R201P
Navigate to Administrator > cnMaestro tab
2. Enter NOC static URL in the cnMaestro URL field.
cnPilot E400/E500 and ePMP 1000 HotSpot
Navigate to Configure > System
2. Under Management section, enter NOC static URL in the cnMaestro URL field
ePMP 1000 AP/SM
Navigate to Configuration > System
2.Under cnMaestro section, enter NOC static URL in the cnMaestro URL field
PMP 450 or 450i AP/SM/BHM/BHS(Support from June 2016 End Tentatively)
Navigate to Configuration > cnMaestro
2.Under configuration section, enter NOC static URL in the cnMaestro URL field
2.2 Claim Through Static URL without Cambium ID and on Boarding key
In order to claim the devices using the static url without cambium id and on boarding key please follow the below steps
Login to device GUI and navigate to Configure->System menu in ePMP 1000/ePMP 1000 HotSpot/cnPilot E400/E500 devices or Administration->cnMaestro in cnPilot R200P/R201P devices or Configuration->cnMaestro in PMP devices.
Provide the NOC static url https://NOCIPADDRESSORHOSTNAME and click save.
Reboot the device if necessary for devices like cnPilot R200P/R201P and PMP Devices
Device will come to the on boarding queue in the cnMaestro Home->On board Devices->On board page and the user can approve the device
2.3 Claim Through Static URL with Cambium ID and on Boarding key
In order to claim the devices using the static url with cambium id and on boarding key please follow the below steps
Login to NOC server using default username and password (admin/admin) or the Username and Password set by the Administrator at the time of installation
Navigate to Home->On board Devices-> Claim from Device page
Select the checkbox for “Enable Cambium ID based authentication to onboard devices”
Click on Add new and select the username from the drop down box and specify the on boarding key and click save.
Login to device GUI and navigate to Configure->System menu in ePMP 1000/ePMP 1000 HotSpot/cnPilot E400/E500 devices or Administration->cnMaestro in cnPilot R200P/R201P devices or Configuration->cnMaestro in PMP devices.
Provide the NOC static url https://NOCIPADDRESSORHOSTNAME and Cambium ID(cnmaestro_on_premises) and on boarding key for that user and click save.
Reboot the device if necessary for devices like cnPilot R200P/R201P and PMP Devices
Device will come to the on boarding queue in the cnMaestro Home->On board Devices->On board page and the user can approve the device
2.4 Zero touch on boarding using DHCP option 43
In order to claim the devices using DHCP option 43 user needs to follow the below steps
Configure the Linux or windows DHCP server to send the options 43 and 60 to the Cambium Devices. Please follow the section for DHCP Configuration
For claiming devices through this method user need not specify the static url in the device as the device obtains this url from DHCP option 43
User need not specify anything else in the device as this is Zero touch on board
Device will come to the on boarding queue in the cnMaestro Home->On board Devices->On board page and the user can approve the device
2.5 Zero touch on boarding using DHCP option 15
In order to claim the devices using DHCP option 15 user needs to follow the following steps
Configure the Linux or windows DHCP server to send the options 15 to the Cambium Devices. Please follow the section for DHCP Configuration
For claiming devices through this method user need not specify the static url in the device as the device obtains this url from DHCP option 15(cnmaestro.companyname.com)
User need not specify anything else in the device as this is Zero touch on board
Device will come to the on boarding queue in the cnMaestro Home->On board Devices->On board page and the user can approve the device
2.6 Order of Device Discovery :-
The device discovery order is as follows in cnMaestro NOC Server and if any of the options is not configured the discovery method will fallback to the next option
Static cnMaestro URL
Option 43
Option 15
Cloud.cambiumnetworks.com
3) DHCP Configuration
3.1 Linux DHCP Options (ISC-DHCP-Server)
A DHCP Server can be used to configure the IP Address, Gateway, and DNS servers for Cambium devices. If you administer the DHCP Server, you can also configure DHCP Options that will tell the devices how to access the cnMaestro (so the URL doesn’t need to be set on each device). Cambium devices support DHCP Options 43 and 15 for setting the cnMaestro On-Premises URL.
Using DHCP Option 43
DHCP Option 43 returns the cnMaestro On-Premises URL as a Vendor-Specific Option. DHCP Option 43 is returned in tandem with DHCP Option 60 (the Vendor Class Identifier, or VCI). The VCI for the individual Cambium products is listed below.
Product
VCI (DHCP Option 60)
cnPilot R200 P
Cambium-cnPilot R200P
cnPilot R201P
Cambium-cnPilot R201P
cnPilot E400/E500
Cambium-WiFi-AP
ePMP
Cambium
ePMP 1000 Hotspot
Cambium-WiFi-AP
Typically, Option 43 will be the preferred mechanism to configure the cnMaestro URL. Example configuration for the ISC DHCP Server is presented below (from the /etc/dhcp/dhcpd.conf file).
option option-43 code 43 = string;
# ePMP/PMP Devices
class "Cambium" {
match if option vendor-class-identifier = "Cambium";
# DHCP server MUST return the device’s Vendor Class back, in the offer.
option vendor-class-identifier "Cambium";
# cnMaestro On-Premises IP is 192.168.0.100
option option-43 "https://192.168.0.100";
}
# WiFi Devices
class "Cambium-WiFi-AP" {
match if option vendor-class-identifier = "Cambium-WiFi-AP";
option vendor-class-identifier "Cambium-WiFi-AP";
option option-43 "https://192.168.0.100";
}
# cnPilot R200P Devices
class "Cambium-cnPilot R200P" {
match if option vendor-class-identifier = "Cambium-cnPilot R200P";
option vendor-class-identifier "Cambium-cnPilot R200P";
option option-43 "https://192.168.0.100";
}
# cnPilot R201P Devices
class "Cambium-cnPilot R201P" {
match if option vendor-class-identifier = "Cambium-cnPilot R201P";
option vendor-class-identifier "Cambium-cnPilot R201P";
option option-43 "https://192.168.0.100";
}
Using DHCP Option 15
DHCP Option 15 allows the device to derive the cnMaestro URL from the domain name. For example, if the domain name in DHCP Option 15 is “mycompany.com”, then the device will try to access the cnMaestro server at “cnmaestro.mycompany.com” (essentially the string “cnmaestro” is prepended to the domain). The domain itself, and the IP address of cnMaestro, must be configured in the DNS server for this to work correctly.
Sample configuration for the ISC DHCP Server is presented below (from the /etc/dhcp/dhcpd.conf file).
option domain-name "mycompany.com";
Note :- User needs to map the cnmaestro.mycompany.com to the proper NOCSERVERIPADDRESS in the DNS server for on boarding to work properly