使用SNMP v2、SNMP v3和NetCONF使用Prime基础设施管理Catalyst 9800无线控制器系列

简介

本文档介绍如何将Catalyst 9800系列无线控制器(C9800 WLC)与使用简单网络管理协议和Netconf的Prime基础设施(3.x)集成。  包括SNMPv2和SNMPv3的配置详细信息。

先决条件

要求

思科建议您了解

• C9800 WLC
• Prime基础设施版本(PI)3.5
• SNMP

使用的组件

本文档中的信息基于以下软件和硬件版本：

• C9800 WLC
• 思科IOS-XE直布罗陀16.10.1到17.3

Note:Prime Infra 3.8仅支持17.x 9800 WLC。如果您尝试使用Prime Infra 3.8管理16.12 WLC，客户端将不会显示在Prime基础设施上

配置

要使Prime基础设施配置、管理和监控Catalyst 9800系列无线局域网控制器，它需要能够通过CLI、SNMP和Netconf访问C9800。将C9800添加到Prime基础设施时，需要指定telnet/SSH凭证以及SNMP社区字符串、版本等。PI使用此信息来验证可达性并清点C9800 WLC。它还将使用SNMP推送配置模板，并支持AP和客户端事件陷阱。但是，为了使PI收集接入点(AP)和客户端统计信息，需要利用Netconf。默认情况下，Netconf在C9800 WLC上未启用，需要在16.10.1版（16.11.1中提供GUI）上通过CLI手动配置。

使用的端口

C9800和Prime基础设施之间的通信使用不同的端口。

• Prime Infra中可用的所有配置和模板将通过SNMP和CLI推送。这使用UDP端口161。
• C9800 WLC本身的运行数据通过SNMP获取。这使用UDP端口162
• AP和客户端操作数据利用流遥测。
  Prime基础设施到WLC:TCP端口830 - Prime Infra使用此端口将遥测配置推送到9800台设备（使用netconf）
  WLC到Prime基础设施：TCP端口20828（适用于IOS-XE 16.10和16.11）或20830（适用于IOS-XE 16.12、17.x及更高版本） —

Note:Keepalive每5秒发送一次，即使没有要报告的遥测数据也是如此

Note:如果Prime基础设施和C9800之间有防火墙，请务必打开这些端口以建立通信

Cat 9800 WLC上的SNMPv2配置

GUI:

步骤1.导航至Administration > SNMP > Slide以启用SNMP

步骤2.单击“社区字符串”并创建只读和读写社区名称

CLI：

(config)#snmp-server community <snmpv2-community-name> 
(optional)(config)# snmp-server location <site-location>
(optional)(config)# snmp-server contact <contact-number>

Cat 9800 WLC上的SNMPv3配置

GUI:

Note:自17.1 IOS-XE起，Web UI仅允许您创建只读v3用户。您需要按照CLI过程创建读写v3用户。

CLI：

单击V3用户。创建用户，选择“authPriv”、SHA和AES协议并选择长密码。MD5和DES/3DES是不安全的协议，虽然它们在9800中仍是一个选项，但不应选择它们，也不应再进行完全测试。

Note:SNMPv3用户配置未反映在运行配置中。仅显示SNMPv3组配置

CLI：

(config)#snmp-server view primeview iso included
(config)#snmp-server group <v3-group-name> v3 auth write primeview 
(config)#snmp-server user <v3username> <v3-group-name> v3 auth {md5 | sha} <AUTHPASSWORD> priv {3des | aes | des} {optional for aes 128 | 192| 256} <PRIVACYPASSWORD>



9800#show snmp user

User name: Nico
Engine ID: 800000090300706D1535998C
storage-type: nonvolatile	 active
Authentication Protocol: SHA
Privacy Protocol: AES128
Group-name: SnmpAuthPrivGroup

Cat 9800 WLC上的NETCONF配置

GUI（从16.11开始）：

导航至管理> HTTP/HTTPS/NetConf

CLI：

(config)#netconf-yang

Caution:如果在C9800上启用aaa new-model，则您还需要配置
(config)#aaa authorization exec default <local or radius/tacacs group>
(config)#aaa authentication login default <local or radius/tacacs group>
C9800上的Netconf使用默认方法（您不能更改此方法）同时用于aaa authentication login和aaa authorization exec。如果要为SSH连接定义不同的方法，可以在“line vty”命令行下执行此操作。Netconf将继续使用默认方法。

当将9800控制器添加到其资产时，Prime基础设施将覆盖您配置的aaa authentication login default和aaa authorization exec default方法，并仅在WLC上尚未启用Netconf时将其指向本地身份验证。如果Prime基础设施能够使用netconf登录，则不会更改配置。这意味着，如果您使用TACACS，则在将9800添加到Prime后将失去CLI访问。如果这是您的首选项，您可以随后恢复这些配置命令，并使其指向TACACS。

配置（Prime Infrastructure 3.5及更高版本）

步骤1.捕获Catalyst 9800 WLC上配置的无线管理IP地址

GUI:

导航至Configuration > Interface:无线

CLI：

# show wireless interface summary

步骤2.捕获权限15用户凭证和启用密码

GUI:

导航至“管理”>“用户管理”

        

CLI：

# show run | inc username
# show run | inc enable

第3步获取SNMPv2社区字符串和/或SNMPv3用户（如果适用）

GUI:

对于SNMPv2，导航至Administration > SNMP > Community Strings

对于SNMPv3，导航至 管理> SNMP > V3用户

CLI:

For SNMPv2 community strings
# show run | sec snmp 

For SNMPv3 user
# show user

第4步在Prime基础设施GUI上，导航至点击 Configuration > Network :网络设备>点击+旁的下拉菜单>选择添加设备

步骤5.在“添加设备”弹出窗口中，输入将用于与Prime基础设施建立通信的9800接口IP地址。

步骤6.导航至SNMP选项卡，并提供在C9800 WLC上配置的SNMPv2只读和读写社区字符串

步骤7.如果使用SNMPv3，请从下拉选项v3中提供SNMPv3用户名。从Auth-Type 下拉列表匹配之前配置的身份验证类型，从Privacy Type 下拉列表中选择在C9800 WLC上配置的加密方法

步骤8.导航至“添加设备”的“Telnet/SSH”选项卡，提供“权限15用户名和密码”和“启用密码”。单击“Verify Credentials(验证凭证)” ，确保CLI、SNMP凭证工作正常。然后单击“添加”

验证

验证遥测状态

步骤1.检验C9800上是否启用了Netconf:

#show run | inc netconf
netconf-yang

如果不存在，请遵循“Cat 9800 WLC上的NETCONF配置”部分。

步骤2.检验从C9800到Prime的遥测连接

#show telemetry internal connection
Telemetry connection

Address Port Transport State Profile
------------------------------------------------------------------
x.x.x.x 20828 cntp-tcp Active

Note:x.x.x.x是Prime基础设施的ip地址，状态应为“活动”。如果状态不是活动，请参阅故障排除部分

步骤3.在Prime基础设施上，导航至Inventory > Network Devices > Device Type:无线控制器

步骤4.要查看与Prime基础设施的遥测连接的详细信息，请运行

#show telemetry internal protocol cntp-tcp manager x.x.x.x 20828
Telemetry protocol manager stats:

Con str                : x.x.x.x:20828::
Sockfd                 : 79
Protocol               : cntp-tcp
State                  : CNDP_STATE_CONNECTED
Table id               : 0
Wait Mask              :
Connection Retries     : 0
Send Retries           : 0
Pending events         : 0
Source ip              : <9800_IP_ADD>
Bytes Sent             : 1540271694
Msgs Sent              : 1296530
Msgs Received          : 0

步骤5.检验C9800的遥测订用状态以及它们显示为“有效”的事实

#show telemetry ietf subscription configured
Telemetry subscription brief

ID Type State Filter type
-----------------------------------------------------
68060586 Configured Valid transform-na
98468759 Configured Valid tdl-uri
520450489 Configured Valid transform-na
551293206 Configured Valid transform-na
657148953 Configured Valid transform-na
824003685 Configured Valid transform-na
996216912 Configured Valid transform-na
1072751042 Configured Valid tdl-uri
1183166899 Configured Valid transform-na
1516559804 Configured Valid transform-na
1944559252 Configured Valid transform-na
2006694178 Configured Valid transform-na

步骤 6：可以按订用ID查看订用统计信息，或使用

#show telemetry internal subscription { all | id } stats
Telemetry subscription stats:

Subscription ID  Connection Info            Msgs Sent  Msgs Drop  Records Sent
------------------------------------------------------------------------------
865925973        x.x.x.x:20828::      2          0          2
634673555        x.x.x.x:20828::      0          0          0
538584704        x.x.x.x:20828::      0          0          0
1649750869       x.x.x.x:20828::      1          0          2
750608483        x.x.x.x:20828::      10         0          10
129958638        x.x.x.x:20828::      10         0          10
1050262948       x.x.x.x:20828::      1369       0          1369
209286788        x.x.x.x:20828::      15         0          15
1040991478       x.x.x.x:20828::      0          0          0
1775678906       x.x.x.x:20828::      2888       0          2889
1613608097       x.x.x.x:20828::      6          0          6
1202853917       x.x.x.x:20828::      99         0          99
1331436193       x.x.x.x:20828::      743        0          743
1988797793       x.x.x.x:20828::      0          0          0
1885346452       x.x.x.x:20828::      0          0          0
163905892        x.x.x.x:20828::      1668       0          1668
1252125139       x.x.x.x:20828::      13764      0          13764
2078345366       x.x.x.x:20828::      13764      0          13764
239168021        x.x.x.x:20828::      1668       0          1668
373185515        x.x.x.x:20828::      9012       0          9012
635732050        x.x.x.x:20828::      7284       0          7284
1275999538       x.x.x.x:20828::      1236       0          1236
825464779        x.x.x.x:20828::      1225711    0          1225780
169050560        x.x.x.x:20828::      0          0          0
229901535        x.x.x.x:20828::      372        0          372
592451065        x.x.x.x:20828::      8          0          8
2130768585       x.x.x.x:20828::      0          0          0

故障排除

Prime基础设施故障排除

• 要检查Prime基础设施，首先需要检查的是IP地址和接口。Prime基础设施不支持双宿主，不会侦听其第二个端口上的遥测。
• 您在Prime基础设施中添加的WLC的IP地址必须是用作“无线管理接口”的IP地址。 必须能从控制器端的无线管理接口访问Prime基础设施IP地址。
• 如果使用服务端口（设备上的gig0/0）进行发现，WLC和AP将显示为资产中的托管状态，但WLC和关联接入点的遥测将不起作用。 
• 如果您看到Prime基础设施上的遥测状态为“成功”，但AP计数为0，则可能是Prime基础设施可以连接到端口830上的WLC，但控制器无法连接到端口20830上的Prime基础设施。

对于任何SNMP问题或设备配置问题，请从Prime基础设施收集以下日志

cd /opt/CSCOlumos/logs/

[root@prime-tdl logs]# ncs-0-0.log

Tdl.logs

对于遥测/珊瑚问题，首先检查珊瑚状态：

shell

cd /opt/CSCOlumos/coralinstances/coral2/coral/bin

./coral version 1

./coral status 1

./coral stats 1

如果一切正常，请从prime coral logs文件夹收集以下日志

Note:根据Prime基础设施版本及其支持的IOS-XE版本数量，Prime基础设施上可能有多个Coral实例。查看版本说明以了解更多详细信息，例如：https://www.cisco.com/c/en/us/td/docs/net_mgmt/prime/infrastructure/3-7/release/notes/bk_Cisco_Prime_Infrastructure_3_7_0_Release_Notes.html

步骤1:

cd /opt/CSCOlumos/coral/bin/

[root@prime-tdl bin]# ./coral attach 1

Attached to Coral instance 1 [pid=8511]

Coral-1#cd /tmp/rp/trace/

Coral-1#ls

Collect the  “Prime_TDL_collector_R0-”* logs

Coral-1# cd /tmp/rp/trace/
Coral-1# btdecode P* > coralbtlog.txt
Coral-1# cat  coralbtlog.txt

这些日志也可在以下目录中找到：

*解码的跟踪文件将在路径中可用

/opt/CSCOlumos/coralinstances/coral2/coral/run/1/storage/harddisk

* ade# cd /opt/CSCOlumos/coralinstances/coral2/coral/run/1/storage/harddisk

* ade# cp coraltrace.txt /localdisk/defaultRepo

步骤2.要在调试模式下启用Coral，需要在debug.conf文件中设置调试级别。

从容器内：

echo "rp:0:0:tdlcold:-e BINOS_BTRACE_LEVEL=DEBUG;" > /harddisk/debug.conf

或在Prime 3.8上，可使用

"sudo /opt/CSCOlumos/coralinstances/coral2/coral/bin/coral restart 1"

如果重新启动无助于以下操作，可以用于擦除珊瑚实例并顺利启动：

sudo /opt/CSCOlumos/coralinstances/coral2/coral/bin/coral stop 1

sudo /opt/CSCOlumos/coralinstances/coral2/coral/bin/coral purge 1

sudo /opt/CSCOlumos/coralinstances/coral2/coral/bin/coral start 1

重新启动Coral，这是必填项。您可以先键入“Exit”离开珊瑚实例，然后：

./coral/bin/coral restart 1

Note:在Prime 3.8上，可使用“sudo /opt/CSCOlumos/coralinstances/coral2/coral/bin/coral restart 1”在容器外重新启动Coral服务。

如果需要解码Coral日志文件，可以在Coral容器内使用：

btdecode Prime_TDL_collector_*.bin

Note:启用Coral的调试级别后，必须重新启动Coral。

Catalyst 9800 WLC故障排除

要监控Prime Infra推送到C9800 WLC的配置，可以运行EEM小程序

#config terminal
#event manager applet catchall
 #event cli pattern ".*" sync no skip no
 #action 1 syslog msg "$_cli_msg"

从WLC配置中删除所有遥测订用

有时，您可能想要取消配置在WLC上配置的所有遥测订用。只需使用以下命令即可完成此操作：

WLC#term shell
WLC#function removeall() {
for id in `sh run | grep telemetry | cut -f4 -d' '`
do
conf t
no telemetry ietf subscription $id
exit
done
}
WLC#removeall

启用跟踪

# debug netconf-yang level debug

要验证：

WLC#show platform software trace level mdt-pubd chassis active R0 | inc Debug

pubd                            Debug           

WLC#show platform software trace level ndbman chassis active R0 | inc Debug

ndbmand                         Debug     

      

查看跟踪输出

show platform software trace message mdt-pubd chassis active R0

show platform software trace message ndbman chassis active R0

检查订用ID以获取AP信息：

单击数据库查询

转至：https://<Prime_IP>/webacs/ncsDiag.do

从ewlcSubscription中选择*，其中OWNINGENTITYID如“%Controller_IP”和CLASSNAME='UnifiedAp'

从WLC

验证订用ID正在发送信息，且cntp计数器上没有丢弃。

show tel int sub all stats

show telemetry internal protocol cntp-tcp connector counters drop

show telemetry internal protocol cntp-tcp connector counters queue

show telemetry internal protocol cntp-tcp connector counters rate

show telemetry internal protocol cntp-tcp connector counters sub-rate

show telemetry internal protocol cntp-tcp connector counters reset

从PI迁移到DNA中心

C9800不能同时由Prime基础设施(PI)和DNA中心以读写方式管理（例如，仅让DNAC做保证，使用Prime Infra推送模板就很好）。 因此，如果计划将DNAC作为网络管理解决方案，则在将C9800添加到DNA中心之前，需要将其从Prime基础设施中删除。当从PI 3.5中删除/删除C9800时，PI在清点时推送到C9800的所有配置都不会回滚，这些配置需要从系统中手动删除。具体而言，为C9800 WLC建立的用于发布流遥测数据的订用信道不会被删除。 

要确定此特定配置，

#show run | sec telemetry

要删除此配置，请运行命令的“no”形式：

(config) # no telemetry ietf subscription <Subscription-Id>
Repeat this CLI to remove each of the subscription identifiers. 


(config) # no telemetry transform <Transform-Name>
Repeat this CLI to remove each of the transform names

Note:如果您同时使用DNAC和Prime基础设施管理9800控制器，则由于Prime管理，DNAC库存合规性预期会失败。