NETCONF/YANG interface is used to accomplish customer requests.
The prerequisite configuration for Status Information and Alarm and Event Information is to enable NETCONF server on the
embedded wireless controller by using the following command:
netconf-yang
The above command not only enables notifications, but also allows for configuration and operation access (OAM) via Netconf/Yang.
For more information on Netconf/Yang, see the NETCONF Protocol chapter of the Programmability Configuration Guide at: https://www.cisco.com/c/en/us/support/ios-nx-os-software/ios-xe-17/products-installation-and-configuration-guides-list.html
In the Status Information Received Synchronously type, the following information is exported though NETCONF:
All the data for the items listed above is already available as the
embedded wireless controller operational data exported through NETCONF. The examples below explain where the data items listed are available.
The following command is used in the
embedded wireless controller:
wireless tag site village_name_1
The site tags can be retrieved by NETCONF using the get-config operation.
Example output for Name of the Village:
<site-cfg-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-wireless-site-cfg">
[...]
<site-tag-configs>
<site-tag-config>
<site-tag-name>village_name_1</site-tag-name>
<description>custom user site tag for a village</description>
</site-tag-config>
[...]
</site-tag-configs>
The
embedded wireless controller's operational data contains all the connected (joined) APs and lists their site tags. The example output displays the detailed
information about the APs and the site tags. The following example displays the relevant fields and the corresponding
embedded wireless controller show commands:
Example output of Access Point per Village:
<data>
<access-point-oper-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-wireless-access-point-oper">
[...]
<radio-oper-data>
<wtp-mac>00:1b:0c:00:02:00</wtp-mac> #show ap dot11 {24ghz|5ghz} summary "MAC Address"
<radio-slot-id>0</radio-slot-id> #show ap dot11 {24ghz|5ghz} summary "Slot"
<ap-mac>00:1b:0c:00:02:00</ap-mac>
<slot-id>0</slot-id>
<radio-type>1</radio-type> # 1 - 2.4GHz, 2 - 5GHz
<admin-state>enabled</admin-state> #show ap dot11 {24ghz|5ghz} summary "Admin State"
<oper-state>radio-up</oper-state> #show ap dot11 {24ghz|5ghz} summary "Oper State"
[...]
[...]
<capwap-data>
<wtp-mac>00:1b:0c:00:02:00</wtp-mac> #show ap summary "Radio MAC"
<ap-operation-state>registered</ap-operation-state> #show ap summary "State"
<ip-addr>10.102.140.10</ip-addr> #show ap summary "IP Address"
[...]
<admin-state>1</admin-state> #show ap status "Status", 1 - Enabled, 2 - Disabled
<location>default-location </location> #show ap summary "Location"
<country-code>CH </country-code>
<name>AP_A-1</name> #show ap summary "AP Name"
[...]
<tag-info>
[...]
<site-tag>
<site-tag-name>village_name_1</site-tag-name> #show ap name AP_A-1 config general "Site Tag Name"
[...]
</site-tag>
[...]
The operational data of the
embedded wireless controller contains all the connected wireless clients information, which includes detailed client device information, such as the MAC
address, IP address, State and the AP name.
Example output of the Number of clients currently online and logged in each village and each AP:
<data>
<client-oper-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-wireless-client-oper">
<common-oper-data>
<client-mac>00:00:1a:04:00:02</client-mac> #show wireless client summary "MAC Address"
<ap-name>AP_A-1</ap-name> #show wireless client summary "AP Name"
[...]
<co-state>client-status-run</co-state> #show wireless client summary "State"