简介
本文档介绍数字网络架构中心(DNAC)和互联移动体验(CMX)服务器集成上播放功能的基本配置和故障排除。
回放是CMX定位服务的一部分,该服务通过无线楼层地图提供终端主机实时定位和跟踪,该地图可与DNA分析功能集成。
先决条件
要求
Cisco 建议您了解以下主题:
- DNA中心和CMX必须已集成。
— 已在DNAC WebGUI > Design > Network Hierarchy部分添加或导入楼层图。
— 终端主机显示在对应的映射上。
— 基本的linux基础版。
使用的组件
本文档中的信息基于以下软件和硬件版本:
— 运行版本2.1.2.5的DNA中心
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备都已配置用于测试目的。如果您的网络处于活动状态,请确保您了解所有命令的潜在影响。
故障排除
本部分提供了可用于对配置进行故障排除的信息。
DNA 中心
步骤1.在DNAC CLI上验证DNA映射服务状态
$ magctl appstack status | egrep "STATUS|dna-maps-service"
NAMESPACE NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE
fusion dna-maps-service-7dffd9d6b6-58qjb 1/1 Running 3 133d <none>
它需要使服务处于“就绪”和“运行”状态。
$ magctl service status dna-maps-service
Name: dna-maps-service-7dffd9d6b6-58qjb
Namespace: fusion
Node:
Start Time: Tue, 01 Dec 2020 19:43:27 +0000
Labels: pod-template-hash=3899858262
serviceName=dna-maps-service
version=7.14.117.62009
Annotations: <none>
Status: Running
IP:
Controlled By: ReplicaSet/dna-maps-service-7dffd9d6b6
Containers:
dna-maps-service:
Container ID: docker://ddbe6999823a6830983611c1900c4a5d255b40b5a1957bef2d2ecddcd606a0b9
Image: maglev-registry.maglev-system.svc.cluster.local:5000/fusion/dna-maps-service:7.14.117.62009
Image ID: docker-pullable://maglev-registry.maglev-system.svc.cluster.local:5000/fusion/dna-maps-service@sha256:0b6510c1c29d260492647b586ffb714f1689ae7ec9d5f63905bb0ad4dac738c9
Ports: 22222/TCP, 11111/TCP
Host Ports: 0/TCP, 0/TCP
State: Running
.
.
.
.
Conditions:
Type Status
Initialized True
Ready True
ContainersReady True
PodScheduled True
.
.
.
.
Events: <none>
注意:建议运行此命令集几次(每10分钟),以确保服务不会持续重新启动。如果服务持续重新加载,请参阅第二个命令以验证最后一个服务事件部分,以了解详细信息。
步骤2.检验CMX服务器是否在DNA Center Web GUI上配置,并且可通过ping访问
1.单击 图标。
2.转至“系统” > 设置> DNA空间/CMX服务器。
3.确认CMX服务器已添加到正确的部分并标记为“已注册状态”。
4.从DNAC CLI对CMX服务器执行ping操作。
5.单击 图标。
6.转至“设计” > “网络设置” > “无线”。
7.在“DNA空间/CMX服务器”部分确认所需服务器已在全局层次结构或所需站点上选择并保存。
步骤3.打开DNA映射调试级别
1.单击 图标
2.转至“系统” > “设置” >“调试日志”。
3.在“服务”列表中,选择dna-maps-service。然后选择Debug 作为Logging Level并定义时间戳。
4.单击“保存”,这将自动开始调试所选服务。
注意:在DNAC版本2.1.2.x(Wolverine)之前,不支持通过DNAC Web GUI运行dna映射调试。因此,需要在DNAC CLI上手动打开服务调试
要在dna-maps-service上生成调试级别,我们需要连接到DNAC CLI并将API参数修改为所需值:
生成身份验证令牌
$ curl -s -k -u admin -X POST https://
/dna/system/api/v1/auth/token | jq -r .Token
使用以下CURL命令启用dna-maps-service的调试。确保响应恢复为200 OK
$ curl -k -i -X POST 'https://
/api/v1/dna-maps-service/testing/logging/level?loggingLevel=5 ' --header 'X-Auth-Token:
' --form 'Content-Type='
示例:
$ curl -k -i -X POST 'https://x.x.x.x/api/v1/dna-maps-service/testing/logging/level?loggingLevel=5 ' --header 'X-Auth Token:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiI1ZjQ2NDZkOGE3NmQ4ZDAwY2UzNzA4ZWYiLCJhdXRoU291cmNlIjoiaW50ZXJuYWwiLCJ0ZW5hbnROYW1lIjoiVE5UMCIsInJvbGVzIjpbIjVmNDY0NmQ4YTc2ZDhkMDBjZTM3MDhlZSJdLCJ0ZW5hbnRJZCI6IjVmNDY0NmQ3YTc2ZDhkMDBjZTM3MDhlYyIsImV4cCI6MTYxODQyNDE3OCwiaWF0IjoxNjE4NDIwNTc4LCJqdGkiOiIwYTU4YWVmYS03ZTgwLTRlOGUtODg4OC0wODBiNTk4ZWM0NTciLCJ1c2VybmFtZSI6ImFkbWluIn0.Li0BGN3VeVRIeWlrUsd94hnQt0xlCx0fJHCAtg0pQ7wx9MMC1UMImcuFabHXUgVmHcDrIAgds5GyBnNaPKfgs9qsvmjhJyVHZdT7_f8YJ2BihkgEokfJbIkcb7Ulp7AqIzceACYpZXeBmfQtDCNDyJveoz1XLaKu69JYzArf8UaPzg3jHVoq9m6N5ohypMC-pmsp87-SbOoD-2x660K7Ankzqqtxw4vhyAp0atcYujPg0-8G4fkOPrLE-Cw6SXb8YonrjWVPbrBwfqENTr6sUj7SrPlH_CVBGzRG20YxaYvn_yeGG8E1pbCgDEK2UjyRaH-FM9BHIqY3TNUIf0mdvQ' --form 'Content-Type='
HTTP/1.1 100 Continue
HTTP/1.1 200 OK
步骤4.开始收集服务日志以进行分析
$ magctl service logs -rf dna-maps-service | lql
这将开始在CLI上显示日志,建议在应用终端上保存日志记录,或在命令末尾添加选项> log.txt,以便将输出自动存储到/home/mublev路径上的日志文件中。
步骤5.触发DNAC API将GET请求发送到CMX服务器。在DNAC Web GUI
1.进入非工作终端主机所在的楼层映射。
2.单击最终主机蓝色图标。这将打开一个新的侧选项卡,其中包含客户端360信息以及MAC地址、IP和相关信息。
3.再次单击“回放”选项卡。
此时,DNA中心将在CLI上显示后端服务调试,DNAC和CMX服务器之间进行转换。
示例:
|2021-03-31 16:23:13,024 | DEBUG | scheduler-12 | | o.s.web.client.RestTemplate | - Created GET request for "https://x.x.x.x/api/location/v3/clients/count?associatedOnly=true "
|2021-03-31 16:23:13,024 | DEBUG | scheduler-12 | | o.s.web.client.RestTemplate | - Setting request Accept header to [application/xml, text/xml, application/json, application/*+xml, application/*+json]
|2021-03-31 16:23:16,028 | DEBUG | scheduler-12 | | o.s.web.client.RestTemplate | - GET request for "https://x.x.x.x/api/location/v3/clients/count?associatedOnly=true " resulted in 503 (Service Unavailable); invoking error handler
|2021-03-31 16:23:16,030 | ERROR | scheduler-12 | | c.c.a.m.c.p.i.CMXVerificationRestClientImpl | - Error occurred during interaction with CMX to get client counts for CMX IpAddr x.x.x.x org.springframework.web.client.HttpServerErrorException: 503 Service Unavailable at org.springframework.web.client.DefaultResponseErrorHandler.handleError(DefaultResponseErrorHandler.java:89)
~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.handleResponse(RestTemplate.java:708)
~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.doExecute(RestTemplate.java:661)
~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.execute(RestTemplate.java:621)
~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at org.springframework.web.client.RestTemplate.exchange(RestTemplate.java:539)
~[spring-web-4.3.19.RELEASE.jar:4.3.19.RELEASE] at com.cisco.apicem.maps.cmx.proxy.impl.CMXVerificationRestClientImpl.checkCMXServiceability(CMXVerificationRestClientImpl.java:169)
~[cmx-proxy-7.14.264.62702.jar:7.14.264.62702] at com.cisco.csg.ngmaps.impl.apicem.integration.diagnostic.cmx.CMXDiagnosticJob.diagnose(CMXDiagnosticJob.java:114)
~[classes/:na] at jdk.internal.reflect.GeneratedMethodAccessor118.invoke(Unknown Source) ~[na:na]
警告:故障排除完成后,需要再次将调试级别设置为默认值,以防在DNAC CLI上配置
$ curl -k -i -X POST 'https://
/api/v1/dna-maps-service/testing/logging/level?loggingLevel=3 ' --header 'X-Auth-Token:
' --form 'Content-Type='
示例:
$ curl -k -i -X POST 'https://x.x.x.x/api/v1/dna-maps-service/testing/logging/level?loggingLevel= 3' --header 'X-Auth-Token:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiI1ZjQ2NDZkOGE3NmQ4ZDAwY2UzNzA4ZWYiLCJhdXRoU291cmNlIjoiaW50ZXJuYWwiLCJ0ZW5hbnROYW1lIjoiVE5UMCIsInJvbGVzIjpbIjVmNDY0NmQ4YTc2ZDhkMDBjZTM3MDhlZSJdLCJ0ZW5hbnRJZCI6IjVmNDY0NmQ3YTc2ZDhkMDBjZTM3MDhlYyIsImV4cCI6MTYxODQyNDE3OCwiaWF0IjoxNjE4NDIwNTc4LCJqdGkiOiIwYTU4YWVmYS03ZTgwLTRlOGUtODg4OC0wODBiNTk4ZWM0NTciLCJ1c2VybmFtZSI6ImFkbWluIn0.Li0BGN3VeVRIeWlrUsd94hnQt0xlCx0fJHCAtg0pQ7wx9MMC1UMImcuFabHXUgVmHcDrIAgds5GyBnNaPKfgs9qsvmjhJyVHZdT7_f8YJ2BihkgEokfJbIkcb7Ulp7AqIzceACYpZXeBmfQtDCNDyJveoz1XLaKu69JYzArf8UaPzg3jHVoq9m6N5ohypMC-pmsp87-SbOoD-2x660K7Ankzqqtxw4vhyAp0atcYujPg0-8G4fkOPrLE-Cw6SXb8YonrjWVPbrBwfqENTr6sUj7SrPlH_CVBGzRG20YxaYvn_yeGG8E1pbCgDEK2UjyRaH-FM9BHIqY3TNUIf0mdvQ' --form 'Content-Type='
HTTP/1.1 100 Continue
HTTP/1.1 200 OK
相关信息