本文档介绍在Catalyst 9800 WLC上使用策略(SLUP)配置智能许可并进行故障排除。
Cisco 建议您了解以下主题:
本文档不限于特定的软件和硬件版本。
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您的网络处于活动状态,请确保您了解所有命令的潜在影响。
警告:本文中的说明包含有用的建议或对于文档未涵盖的材料的引用。建议您阅读每个备注。
本文未涉及Catalyst 9800上的所有智能许可方案,请参阅使用策略配置的智能许可指南以获取更多信息。但是,本文确实提供了一系列有用的命令,用于对Catalyst 9800上的使用策略问题的直接连接、CSLU和内部智能许可进行故障排除。

选项1.直接连接到思科许可证中心:

选项2.通过CSLU连接:

选项3.使用思科许可证中心进行连接(内部)。
思科网络订用中提供的统一许可将许可证实施引入本地客户。
完成本指南中的步骤对于确保使用SLUP正确配置您的设备至关重要,这样您的设备在Cisco IOS XE软件映像升级时便无需强制执行。

图 1:Web UI AP合规性(不合规)
AP合规性信息在控制器上(Meraki控制面板、Catalyst Center 2.3.7.9)和设备上(Web UI、CLI)提供。
图1显示了Web UI上的AP合规性信息示例。不合规AP具有Non-Compliant许可证状态,前提是假设该AP为“Never Licensed”。
正确配置SLUP后,您的AP将反映更新的合规状态。

图 1:Web UI AP合规性(合规)
注意:如果您已成功配置SLUP,且接入点上仍显示“不合规状态”,则确认您已购买足够的许可,且这些许可证已存放到正确的智能帐户(SA)和虚拟帐户(VA)中。
Catalyst 9800中引入了使用策略的智能许可功能,代码版本为17.3.2。初始17.3.2版本遗漏了WLC WebUI中的SLUP配置菜单,该菜单是随17.3.3版本引入的。SLUP在以下几个方面不同于传统的智能许可:
警告:如果您使用的是Cisco Catalyst 9800-CL无线控制器,请确保您熟悉以Cisco IOS® XE Cupertino 17.7.1开始的强制ACK要求。请参阅Cisco Catalyst 9800-CL无线控制器的RUM报告和确认要求。
在思科许可证中心创建令牌后,为了建立信任,需要执行这些命令。
configure terminal
ip http client source-interface
ip http client secure-trustpoint
license smart transport smart
license smart url default
exit
write memory
terminal monitor
license smart trust idtoken all force
Cisco Smart License Utility Manager(CSLU)是基于Windows的应用程序(在Linux上也可用),使客户能够从其本地管理许可证及其关联的产品实例,而不必直接将支持智能许可的产品实例连接到Cisco License Central。
本节仅介绍9800无线配置。使用CSLU配置许可(例如安装CSLU、配置CSLU软件等)还需要执行其他步骤,这些步骤在配置指南中介绍。无论您是要实施产品实例启动的通信方法还是CSLU启动的通信方法,还是要完成相应的任务序列。
(config)#license smart transport cslu
(config)#exit
#copy running-config startup-config(config)#license smart url cslu http://:8182/cslu/v1/pi
(config)#exit
#copy running-config startup-config 配置CSLU发起的通信时,需要的唯一操作是检查并确保从控制器到CSLU的网络可达性。
使用内部思科许可证中心的配置与直接连接非常相似。内部版本需要运行版本8-202102或更高版本。对于SLUP版本(17.3.2及更高版本),建议使用CSLU URL和传输类型。URL可从智能许可>资产> <虚拟帐户> >常规部分下的本地WebUI界面获取。
configure terminal
ip http client source-interface
ip http client secure-trustpoint
license smart transport cslu
license smart url cslu http:///cslu/v1/pi/ (see previous paragraph on how to get exact URL)
crypto pki trustpoint SLA-TrustPoint
revocation-check none
exit
write memory
terminal monitor
本地思科许可证中心不需要使用信任令牌。
注意:如果您正在获取消息,%PKI-3-CRL_FETCH_FAIL:信任点SLA-TrustPoint的CRL获取失败,这是因为您尚未在SLA-TrustPoint下配置revocation-check none。这是用于智能许可的信任点。在内部版本中,许可服务器上的证书通常是自签名证书,因此不能进行CRL验证,因此需要配置无撤销检查。
注意:从代码版本17.9.2开始,尚不支持经过身份验证的代理。如果您在基础设施中使用经过身份验证的代理,请考虑使用思科智能许可证实用程序管理器(CSLU),它支持此类服务器。
要在使用智能传输模式时使用代理服务器与思科许可证中心通信,请完成以下步骤:
configure terminal
ip http client source-interface
ip http client secure-trustpoint
license smart transport smart
license smart url default
license smart proxy address
license smart proxy port
exit
write memory
terminal monitor
license smart trust idtoken all force
可以在CLI或GUI中配置的报告间隔无效。
无论通过Web界面或CLI配置什么报告间隔,9800 WLC都会每8小时与思科许可证中心或内部进行通信。这意味着新加入的接入点可以在初次加入后8小时内显示在思科许可证中心。
您可以使用show license air entities summary命令计算并报告许可证的下一次时间。此命令不是典型的show tech或show license all输出的一部分:
WLC#show license air entities summary
Last license report time........................: 07:38:15.237 UTC Fri Aug 27 2021
Upcoming license report time....................: 15:38:15.972 UTC Fri Aug 27 2021
No. of APs active at last report................: 3
No. of APs newly added with last report.........: 0
No. of APs deleted with last report..............: 0
Catalyst 9800 WLC可以拥有其所有许可配置和信任工厂重置,并且仍保留所有其他配置。这需要WLC重新加载:
WLC-1#license smart factory reset
%Warning: reload required after "license smart factory reset" command
请务必注意,在重新设置许可证工厂后,需要等待一小时才能再次授权WLC,以备其处于AirGap模式。
如果需要更换9800 WLC,新设备必须注册到思科许可证中心/内部版本,并且它被视为新设备。释放之前设备的许可证计数需要在产品实例下手动删除:

早于17.3.2的早期WLC版本使用一种特殊的离线许可方法,称为特定许可证注册(SLR)。 在使用SLUP(17.3.2及更高版本)的版本中,此许可方法已被弃用。
如果您将使用SLR的9800控制器升级到17.3.2或17.4.1之后的版本,建议您迁移到离线SLR报告,而不是依赖SLR命令。保存许可证使用情况RUM文件并将其注册到智能许可门户。由于SLR在更新的版本中不再存在,因此会报告正确的许可证计数并释放所有未使用的许可证。许可证不再受阻,但会报告确切的使用计数。
新的SLUP使用smartreceiver.cisco.com域建立信任,而不是传统智能许可使用的tools.cisco.com。在撰写本文时,此域解析为多个不同的IP地址。并非所有这些地址都可执行ping操作。Ping不得用作来自WLC的Internet可达性测试。无法ping通这些服务器并不意味着它们无法正常工作。
必须使用端口443上的telnet而不是ping来测试连通性。可以根据smartreceiver.cisco.com域或直接根据服务器IP地址检查Telnet。如果流量未被阻塞,端口必须在输出中显示为打开:
WLC-1#telnet smartreceiver.cisco.com 443
Trying smartreceiver.cisco.com (192.330.220.90, 443)... Open <-------
[Connection to 192.330.220.90 closed by foreign host]
如果在配置令牌时启用terminal monitor命令,则WLC将在CLI中打印出相关日志。如果运行show logging命令,也可以获取这些消息。成功建立的信任的日志如下所示:
WLC-1#license smart trust idtoken <token> all force
Aug 22 12:13:08.425: %CRYPTO_ENGINE-5-KEY_DELETED: A key named SLA-KeyPair has been removed from key storage
Aug 22 12:13:08.952: %CRYPTO_ENGINE-5-KEY_ADDITION: A key named SLA-KeyPair has been generated or imported by crypto-engine
Aug 22 12:13:08.975: %PKI-6-CONFIGAUTOSAVE: Running configuration saved to NVRAM
Aug 22 12:13:11.879: %SMART_LIC-6-TRUST_INSTALL_SUCCESS: A new licensing trust code was successfully installed on P:C9800-CL-K9,S:9PJK8D9OCNB.
没有已定义的DNS服务器或具有无法正常工作的DNS服务器的WLC的日志:
Aug 23 09:19:43.486: %SMART_LIC-3-COMM_FAILED: Communications failure with the Cisco Smart Software Manager (CSSM) : Unable to resolve server hostname/domain name
在这种情况下,请验证是否配置了有效的DNS服务器。欢迎使用任何可用的公共DNS服务器IP:
ip name-server
具有正常运行的DNS服务器,但没有互联网访问的WLC的日志:
Aug 23 09:23:30.701: %SMART_LIC-3-COMM_FAILED: Communications failure with the Cisco Smart Software Manager (CSSM) : No detailed information given
即使WLC和思科许可证中心/内部许可证之间的通信已加密并通过HTTPS传输,执行数据包捕获仍可揭示导致信任无法建立的原因。收集数据包捕获的最简单方法是通过WLC Web界面。
导航到故障排除>数据包捕获。创建新的捕获点:

确保Monitor Control Plane复选框已启用。将缓冲区大小增加到最大100MB。添加必须捕获的接口。默认情况下,智能许可流量从无线管理接口发出,或者从使用ip http client source-interface命令定义的接口发出:

启动捕获并运行license smart trust idtoken <token> all force命令:

信任建立的数据包捕获必须包含以下步骤:
由于思科许可证中心云使用3个不同的公有IP地址,为了过滤WLC和思科许可证中心之间的所有数据包捕获,请使用以下wireshark过滤器:
ip.addr==172.163.15.144 or ip.addr==192.168.220.90 or ip.addr==172.163.15.144
如果使用本地思科许可证中心,请过滤思科许可证中心IP地址:
ip.addr==
示例:成功建立信任的数据包捕获,与直接连接的思科许可证中心进行过滤,过滤所有重要数据包捕获:

以下show命令包含有关信任建立的有用信息:
show license status
show license summary
show license tech support
show license air entities summary
show license history message (useful to see the history and content of messages sent to SL)
show tech wireless (actually gets show log and show run on top of the rest which can be useful)
show license history message命令是比较有用的命令之一,因为它可以显示从WLC发送并从思科许可证中心接收回的实际消息。
成功的信任建立同时具有“REQUEST:8月23日10:18:08 2021 Central和“回应:8月23日10:18:10 2021 Central消息。如果RESPONSE行之后没有任何内容,则表示WLC未收到来自思科许可证中心的响应。
以下是成功建立信任的show license history message输出示例:
REQUEST: Aug 23 10:18:08 2021 Central
{"request":"{\"header\":{\"request_type\":\"POLL_REQ\",\"sudi\":{\"udi_pid\":\"C9800-CL-K9\",\"udi_serial_number\":\"9PJK8D7OC
NB\"},\"version\":\"1.3\",\"locale\":\"en_US.UTF-8\",\"signing_cert_serial_number\":\"3\",\"id_cert_serial_number\":\"59152896
\",\"product_instance_identifier\":\"\",\"connect_info\":{\"name\":\"C_agent\",\"version\":\"5.0.9_rel/68\",\"production\":tru
e,\"additional_info\":\"\",\"capabilities\":[\"UTILITY\",\"DLC\",\"AppHA\",\"MULTITIER\",\"EXPORT_2\",\"OK_TRY_AGAIN\",\"POLIC
Y_USAGE\"]}},\"request_data\":\"{\\\"sudi\\\":{\\\"udi_pid\\\":\\\"C9800-CL-K9\\\",\\\"udi_serial_number\\\":\\\"9PJK8D7OCNB\\
\"},\\\"timestamp\\\":1629713888600,\\\"nonce\\\":\\\"11702702165338740293\\\",\\\"product_instance_identifier\\\":\\\"\\\",\\
\"original_request_type\\\":\\\"LICENSE_USAGE\\\",\\\"original_piid\\\":\\\"2e84a42f-c903-44c5-83b2-e62e258c780f\\\",\\\"id\\\
":7898262236}\"}","signature":{"type":"SHA256","key":"59152896","value":"eiJ7IuQaTCFxgUkwls76WZxa5DRI5AvRl2Fi1trn6H1x4HrKS/0fc
OgMqQd5POU6VNsH2j9dHco4T1NJ/aCMbR1MRmkfxyVSWsx4lmjJL1lmpOSi3ZS4FBMvlF/EBOUfowREe2oz2lrQp1cAFpPn5SlaFezW80tMdJm08nv29pO8O7Bffyy
/Nu6SQZfIW+IdF+2qnJeNFAIZbNpg0B5d5HIJvDmDImvDu3bMRHhQAWr2KKzGFr6jPz0hs7bGY/+FlfTLQk5LFEUaKTNH/tuxJPFHlF0BtjIRQtAqy5qDpXdjVJokD
h9//uhsd+NaQyfdRFludkbfUBTFkvPxHW9/5w=="}}
RESPONSE: Aug 23 10:18:10 2021 Central
{"signature":{"type":"SHA256","value":"TXZE034fqAul2jy9V4+HoB2hDShl9au/5sgodiCVatmu671/6MyN7kZfEzREufY8\nOOsh4l+BZ1ZAXyQ/hVf+Q
SLrjTfO4grGeQTcH7yEj0D+gztWXCOu8RBT7/Bo9aBs\n4x1i0E6flPB3BP6yu7KIEUQZ8yHzlwDT+mVtJGi6TRrtYnV3KQMpCUmF5F5Jby78\nVNHOakQHVE0Ozrg
wOksf3SfXreNZJuzWXzjHvtmlusCQXw7ZTBzffYsNKO0lkJlr\nvgB2PkV7JUlsA481kpIvlPul6IiJXqk+2PC2IzCrCLG57lVN3XgX6lcU581P7HK7\nrSt3mfdyK
1pEl2SHyQ/DAw==","piid":null,"cert_sn":null},"response":"{\"header\":{\"version\":\"1.3\",\"locale\":\"en_US.UTF-8\",\"timesta
mp\":1629713890172,\"nonce\":null,\"request_type\":\"POLL_REQ\",\"sudi\":{\"udi_pid\":\"C9800-CL-K9\",\"udi_serial_number\":\"
9PJK8D7OCNB\"},\"agent_actions\":null,\"connect_info\":{\"name\":\"SSM\",\"version\":\"1.3\",\"production\":true,\"capabilitie
s\":[\"DLC\",\"AppHA\",\"EXPORT_2\",\"POLICY_USAGE\",\"UTILITY\"],\"additional_info\":\"\"},\"signing_cert_serial_number\":\"3
\",\"id_cert_serial_number\":\"59152896\",\"product_instance_identifier\":\"\"},\"status_code\":\"FAILED\",\"status_message\":
\"Invalid ProductInstanceIdentifier: 2e84a42f-c903-44c5-83b2-e62e258c780f provided in the polling request for polling id: 7898
262236\",\"retry_time_seconds\":0,\"response_data\":\"\"}","sch_response":null}
使用license smart trust idtoken all force命令尝试建立信任后几分钟运行此命令。IOSRP日志非常详细。附加 | include smart-agent”到命令以仅获取智能许可日志。
show logging process iosrp start last 5 minutes
show logging process iosrp start last 5 minutes | include smart-agent
您还可以运行这些调试,然后重新配置许可命令以强制建立新连接:
debug license events
debug license errors
debug license agent all
WLC上的嵌入式数据包捕获是查看WLC是否从思科许可证中心或内部收到任何信息的简单方法。如果没有响应,防火墙可能会阻止某些内容。
如果未收到来自思科许可证中心云或内部云的响应,show license history message命令会在发出请求后1秒打印空响应。
例如,这可能使您相信已收到空响应,但实际上根本没有响应:
REQUEST: Jun 29 11:12:39 2021 CET
{"request":"{\"header\":{\"request_type\":\"ID_TOKEN_TRUST\",\"sudi\":{\"udi_pid\":\"C9800-CL-K9\",\"udi_serial_number\":\"9V4ZPZPN8DW\"},\"version\":\"1.3\",\"locale\":\"en_US.UTF-8\",\"product_instance_identifier\":\"\",\"connect_info\":{\"name\":\"C_agent\",\"version\":\"5.0.9_rel/68\",\"production\":true,\"additional_info\":\"\",\"capabilities\":[\"UTILITY\",\"DLC\",\"AppHA\",\"MULTITIER\",\"EXPORT_2\",\"OK_TRY_AGAIN\",\"POLICY_USAGE\"]}},\"request_data\":\"{\\\"sudi\\\":{\\\"udi_pid\\\":\\\"C9800-CL-K9\\\",\\\"udi_serial_number\\\":\\\"9V4ZPZPN8DW\\\"},\\\"timestamp\\\":1624957959810,\\\"nonce\\\":\\\"12527456165463158693\\\",\\\"product_instance_identifier\\\":\\\"\\\",\\\"hostname\\\":\\\"myc9800-CL\\\",\\\"token\\\":\\\"ZmI3YmNmYzYtNTdhZC00N2QwLTkyMjUtOTVmMjM5YmYzNzNlLTE2Mjc1NDkx%0AODEyMjN8Tkw4YU9zaTJDa045K2U3aG5xdlp2SE9VOGJxMkJmc0dNMWpKT0FJ%0AeUZqUT0%3D%0A\\\",\\\"mode\\\":\\\"PERMANENT\\\",\\\"force\\\":false,\\\"software_tag_identifier\\\":\\\"regid.2018-05.com.cisco.WLC_9500C,1.0_85665885-b865-4e32-8184-5510412fcb54\\\",\\\"device_list\\\":[{\\\"sudi\\\":{\\\"udi_pid\\\":\\\"C9800-CL-K9\\\",\\\"udi_serial_number\\\":\\\"9V4ZPZPN8DW\\\"},\\\"software_tag_identifier\\\":\\\"regid.2018-05.com.cisco.WLC_9500C,1.0_85665885-b865-4e32-8184-5510412fcb54\\\",\\\"product_instance_identifier\\\":\\\"\\\",\\\"csr\\\":\\\"MIICnjCCAYYCAQAwODE2MDQGA1UEAxMtMjlCQUM2OEQ3MDQ0NzQ1NzE2QjVDOEYxODdGM0Q0Q0QxNTIwOEVGRjo6MSwyMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAmGCVOO1Q/LiZs3je+Zvo+OsJilTb1vpL7sA80TjprHyLkqQ9mMCub1GunwtF18jzIRa1COUPk9vDsY7bD9btvIG80x2MQFAPPmiNFR4ccvuLYzGl+XjjTjgjbsZpov6S6n3rRGJVyd5aS0S8+JCCljzwtv2rHV628RlWFwlEyzcp4Kt5dm8QBnc+dcYWWIn/X9aExPbf9P96HVL6T6+SomKT/h5hQP8wyz8ycol3XjcXN6gD/XZFyOydZ3oayi/RWjRlA0NThHPQy03bdtFiEakA8ZEWmduNRvTnmSsqKQBVVa43gjgoBzANTAOyXv6e33TRN3bQdV6UuSLcqrw1PwIDAQABoCEwHwYJKoZIhvcNAQkOMRIwEDAOBgNVHQ8BAf8EBAMCBaAwDQYJKoZIhvcNAQEFBQADggEBAHwhn+YcbEuJyYrkcFlaEfzRbJcz9KXXAZASykW7ql3fSlv+PaHePdrh9vsxmkXiVo+UnBbk4Kr5a/mdXEG/4NOeToGUwEqf38ktZMJyL81Whl/FEj83Lhmy7Z5paJrSCWwPc14nHFEFJ4BuelbfmPwiK+Y6X0RHEL92ySH6UNNlVgsWsQbHnHLbacDBsjOcyf9N3xAZc/IDxakSUSYMgFGnBXwkP4aN6XZLfKKGvXtYuIs7D+omRpMijYxQfHzvVnauGi7jiDXEAJjUueNHyztgpPi191j84oEVFHvAEhhMRNakrEEp4jyD2bYOr+CVbbxbYiBd2GKDs1/I1N1XSgM=\\\",\\\"id_cert_sn\\\":\\\"\\\"}]}\"}"}
RESPONSE: Jun 29 11:12:40 2021 CET
与Cisco License Central或On-prem的通信需要9800端的良好证书。它可以自签名,但不能无效或过期。在这种情况下,数据包捕获会显示当9800 HTTP客户端证书过期时思科许可证中心发送的未知CA的TLS警报。
智能许可使用ip http client配置,该配置不同于WLC Web界面使用的ip http server。这意味着需要正确配置以下命令:
ip http client source-interface
ip http client secure-trustpoint
使用show crypto pki trustpoints命令可以找到信任点名称。建议使用自签名证书TP-self-signed-xxxxxxxxxx证书或制造商安装证书(MIC),通常称为CISCO_IDVID_SUDI,仅在9800-80、9800-40和9800-L上提供。
请注意,执行TLS侦听的设备(例如具有SSL解密功能的防火墙)可能会阻止C9800与思科许可服务器建立成功的握手,因为提供的HTTPS证书是防火墙证书而不是思科许可服务器证书。
| 版本 | 发布日期 | 备注 |
|---|---|---|
15.0 |
05-Jun-2026
|
替换文本,将对“思科智能软件管理器(SSM)”的引用替换为“思科许可证中心”。 |
14.0 |
04-Nov-2025
|
在故障排除部分修复了show命令 |
13.0 |
28-Jul-2025
|
添加了有关Airgap许可证在出厂重置后的说明 |
12.0 |
22-Jul-2025
|
添加了DNS服务器配置命令 |
11.0 |
20-Aug-2024
|
固定一个URL |
10.0 |
01-Mar-2024
|
重新认证 |
9.0 |
12-Jan-2023
|
已添加有关身份验证代理支持的详细信息 |
8.0 |
15-Dec-2022
|
增加了CSLU和17.7详细信息 |
7.0 |
20-May-2022
|
添加了debug命令 |
6.0 |
26-Apr-2022
|
已添加有关代理的部分 |
5.0 |
14-Jan-2022
|
增加了内部版本要求 |
4.0 |
12-Jan-2022
|
添加有关内部CSSM的注释 |
3.0 |
05-Oct-2021
|
添加了一条有关内部SSM的小注释 |
2.0 |
02-Sep-2021
|
较小的格式更改 |
1.0 |
02-Sep-2021
|
初始版本 |