此产品的文档集力求使用非歧视性语言。在本文档集中,非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言,文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。
思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言,希望全球的用户都能通过各自的语言得到支持性的内容。 请注意:即使是最好的机器翻译,其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任,并建议您总是参考英文原始文档(已提供链接)。
本文档介绍如何将Catalyst 9800系列无线控制器(C9800 WLC)与Prime基础设施(3.x)集成。
Cisco 建议您了解以下主题:
本文档中的信息基于以下软件和硬件版本:
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您的网络处于活动状态,请确保您了解所有命令的潜在影响。
注意: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。在C9800 WLC上默认未启用Netconf,需要通过16.10.1版本上的CLI手动配置(16.11.1中提供GUI)。
C9800和Prime基础设施之间的通信使用不同的端口。
Prime基础设施到WLC:TCP端口830 - Prime Infra使用此端口将遥测配置推送到9800台设备(使用Netconf)。
WLC到Prime基础设施:TCP端口20828(适用于Cisco® IOS XE 16.10和16.11)或20830(适用于Cisco IOS XE 16.12、17.x和更高版本)。
注意:Keepalive每5秒发送一次,即使没有要报告的遥测数据也是如此。
注意:如果Prime基础设施和C9800之间存在防火墙,请确保打开这些端口以建立通信。
GUI:
步骤1.导航至 Administration > SNMP > Slide to Enable SNMP
.
步骤2.单击 Community Strings
并创建只读和读写社区名称。
CLI:
(config)#snmp-server community <snmpv2-community-name> (optional)(config)# snmp-server location <site-location> (optional)(config)# snmp-server contact <contact-number>
GUI:
注意:从17.1 Cisco IOS XE开始,Web UI仅允许您创建只读v3用户。您需要遵循CLI过程创建读写v3用户。
CLI:
点击 V3 users
并创建用户。选择 authPriv
, SHA
和 AES protocols
,然后选择长密码。 MD5
和 DES/3DES
是不安全的协议,尽管它们仍是9800中的一个选项,但必须不再选择它们,也不再对其进行完全测试。
注意: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
GUI(从16.11开始):
导航至 Administration > HTTP/HTTPS/Netconf
.
CLI:
(config)#netconf-yang
警告:如果在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身份验证登录和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(如果这是您的首选项)。
步骤1.捕获Catalyst 9800 WLC上配置的无线管理IP地址。
GUI:
导航至 Configuration > Interface: Wireless
.
CLI:
# show wireless interface summary
步骤2.捕获权限15用户凭证并启用密码。
GUI:
导航至 Administration > User Administration
.
CLI:
# show run | inc username # show run | inc enable
步骤3.获取适用的SNMPv2社区字符串和/或SNMPv3用户。
GUI:
对于SNMPv2,导航至 Administration > SNMP > Community Strings
.
对于SNMPv3,导航至 Administration > SNMP > V3 Users
.
CLI:
For SNMPv2 community strings # show run | sec snmp For SNMPv3 user # show user
步骤4.在Prime基础设施GUI上,导航至 Configuration > Network: Network Devices
,点击旁边的下拉列表 +
选择 Add Device
.
步骤5.在 Add Device
弹出窗口,输入9800上用于与Prime基础设施建立通信的接口ip地址。
步骤6.导航至 SNMP
选项卡并提供 SNMPv2 Read-Only and Read-Write Community Strings
在C9800 WLC上配置。
步骤7.如果使用SNMPv3,请从下拉列表中选择 v3
和提供SNMPv3用户名。从 Auth-Type
下拉列表匹配先前配置的身份验证类型和 Privacy Type
下拉列表选择C9800 WLC上配置的加密方法。
步骤8.导航至 Telnet/SSH
选项卡 Add Device
,提供特权15用户名和密码以及启用密码。点击 Verify Credentials
确保CLI和SNMP凭证正常工作。然后点击 Add
.
步骤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
注意:x.x.x.x是Prime基础设施的ip地址,且状态必须为Active。如果状态不是Active,请参阅故障排除部分。
步骤3.在Prime基础设施上,导航至 Inventory > Network Devices > Device Type: Wireless Controller
.
步骤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
对于任何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基础设施版本及其支持的Cisco 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上,Coral服务可以在容器外重新启动,使用如下:
"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
重启珊瑚号,这是强制性的。如果键入“Exit”,则可以离开珊瑚实例,然后:
./coral/bin/coral restart 1
注意:在Prime 3.8上,可以使用“sudo /opt/CSCOlumos/coralinstances/coral2/coral/bin/coral restart 1”在容器外部重新启动珊瑚服务
如果您需要解码Coral日志文件,可以使用以下内容在Coral容器中解码:
btdecode Prime_TDL_collector_*.bin
注意:启用Coral的调试级别后,必须重新启动Coral。
要监控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#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
点击 DB Query
.导航tohttps://<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
C9800不能同时由PI和DNA中心以读写方式管理(例如,仅由DNAC进行保证并使用Prime Infra推送模板)。 因此,如果计划将C9800作为网络管理解决方案迁移到DNAC,则需要在将C9800添加到DNA Center之前将其从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
注意:如果您同时使用DNAC和Prime基础设施管理9800控制器,由于Prime管理,DNAC库存合规性预期会失败。
版本 | 发布日期 | 备注 |
---|---|---|
1.0 |
30-Aug-2021 |
初始版本 |