通过HCM-F在PLM中添加新UC应用产品实例时的故障排除问题

简介

本文档介绍在通过HCM-F将新的统一应用产品实例添加到PLM时，托管许可证管理器(HLM)和Prime许可证管理器(PLM)的常规故障排除步骤。此外，在您提交TAC案例之前，请执行核对表。

先决条件

要求

Cisco 建议您了解以下主题：

• 思科托管协作解决方案(HCS)
• 思科托管协作调解功能(HCM-F)
• 思科Prime许可证管理器(PLM)

使用的组件

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

• HCM-F 10.6.2
• PLM 10.5.2

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您使用的是真实网络，请确保您已经了解所有命令的潜在影响。

问题：HCM-F管理员无法将UC集群分配给PLM实例

HCM-F作业失败，错误如图所示：

为了解决此问题，需要HLM详细日志，因为若干条件可能导致相同的GUI错误。

登录HCM-F，CLI启用日志级别并收集日志。

运行以下命令：

set trace level

输入tracelevel（使用CLI“show tracelevels”查找允许的跟踪级别）：                              详细

输入servicename ::Cisco HCS许可证管理器服务

重现问题并收集日志。

文件获取activelog /hcs/HLM/*

解决方案 1

在集群应用发布服务器中添加服务提供商IP地址。HCM-F无法连接到UC应用，因为缺少IP服务提供商。

2016-09-21 18:25:21,659 INFO  [264674] UCAppDeploymentModeConnection: Opening secure connection to: https://null:8443/platform-services/services/DeploymentModeService?wsdl

2016-09-21 18:25:21,659 INFO  [264674] UCAppDeploymentModeConnectionPort successfully opened

2016-09-21 18:25:21,688 INFO  [264674] UCAppDeploymentModeConnection: Setting userName for SOAP connection to: ccmadmin

2016-09-21 18:25:21,688 INFO  [264674] UCAppDeploymentModeConnection: Accepting Certificate from UC Application

2016-09-21 18:25:21,688 INFO  [264674] UCAppDeploymentModeConnection.getDeploymentMode Called

2016-09-21 18:25:21,695 ERROR [264674] UCAppAPI.getDeploymentMode() CaughtException: Error writing to XMLStreamWriter.

2016-09-21 18:25:21,695 ERROR [264674] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  Error writing to XMLStreamWriter.

2016-09-21 18:25:21,696 DEBUG [264674] hlmSDRUtil.updateJob

2016-09-21 18:25:21,750 DEBUG [264674] hlmSDRUtil.beginTransaction

 

验证

要进行验证，请导航至Application Management > Cluster Application

解决方案 2

在端口8443上启用HCM-F和UC应用之间的IP连接。

HCM-F配置正常，但HLM模块无法打开通向UC应用的tcp连接。请参阅“验证”部分，了解如何进一步排除此问题

2016-09-21 18:34:33,745 INFO  [264677] UCAppDeploymentModeConnection: Opening secure connection to: https://10.48.50.72:8443/platform-services/services/DeploymentModeService?wsdl

2016-09-21 18:34:33,746 INFO  [264677] UCAppDeploymentModeConnectionPort successfully opened

2016-09-21 18:34:33,764 INFO  [264677] UCAppDeploymentModeConnection: Setting userName for SOAP connection to: ccmadmin

2016-09-21 18:34:33,764 INFO  [264677] UCAppDeploymentModeConnection: Accepting Certificate from UC Application

2016-09-21 18:34:33,764 INFO  [264677] UCAppDeploymentModeConnection.getDeploymentMode Called

Failed to connect :

2016-09-21 18:35:09,801 ERROR [264677] UCAppAPI.getDeploymentMode() CaughtException: Error writing to XMLStreamWriter.

2016-09-21 18:35:09,801 ERROR [264677] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  Error writing to XMLStreamWriter.

2016-09-21 18:35:09,801 DEBUG [264677] hlmSDRUtil.updateJob

2016-09-21 18:35:09,856 DEBUG [264677] hlmSDRUtil.beginTransaction

2016-09-21 18:35:09,859 DEBUG [264677] hlmSDRUtilcommitTransaction

2016-09-21 18:35:09,990 INFO  [264677] AgentFSM::currentState changed from null0 to stopped

2016-09-21 18:35:09,990 INFO  [264677] Agent route no longer needed...moving it to stopped routes

2016-09-21 18:35:09,990 INFO  [264677] Route removed from context >HLM(be75ce6c-f4ca-464e-aa0f-8204f6cb1fa3)<

 验证

• 验证UC应用是否已启动并正在运行。

• 验证UC应用与HCM-F之间的连接。

admin:utils network ping XXX.YYY.WWW.ZZZ

• 验证端口8443是否未被防火墙阻止。收集数据包捕获并检验TCP握手是否成功建立。
  

admin:utils network capture eth0 file filename coount 10000 size all port 8443 host ip xxx.yyy.www.zzz

其中xxx.yyy.www.zzz是UC应用服务提供空间

• 验证是否可访问以下链接。
  

https://UC_APP_IP_ADDRRESS:8443/platform-services/services/DeploymentModeService?wsdl

解决方案 3

• 重新键入平台UC应用密码以与UC应用密码匹配，因为HLM无法发送消息。
  
  
• 在UC应用中启动平台管理员Web服务

2016-10-06 16:24:49,592 INFO  [252833] UCAppDeploymentModeConnection: Opening secure connection to: https://10.48.50.14:8443/platform-services/services/DeploymentModeService?wsdl

2016-10-06 16:24:49,592 INFO  [252833] UCAppDeploymentModeConnectionPort successfully opened

2016-10-06 16:24:49,616 INFO  [252833] UCAppDeploymentModeConnection: Setting userName for SOAP connection to: ccmadmin

2016-10-06 16:24:49,616 INFO  [252833] UCAppDeploymentModeConnection: Accepting Certificate from UC Application

2016-10-06 16:24:49,616 INFO  [252833] UCAppDeploymentModeConnection.getDeploymentMode Called

2016-10-06 16:24:51,877 ERROR [252833] UCAppAPI.getDeploymentMode() CaughtException: Could not send Message.

2016-10-06 16:24:51,878 ERROR [252833] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  Could not send Message.

2016-10-06 16:24:51,878 DEBUG [252833] hlmSDRUtil.updateJob

2016-10-06 16:24:51,939 DEBUG [252833] hlmSDRUtil.beginTransaction

2016-10-06 16:24:51,942 DEBUG [252833] hlmSDRUtilcommitTransaction

2016-10-06 16:24:52,054 INFO  [252833] AgentFSM::currentState changed from null0 to stopped

2016-10-06 16:24:52,054 INFO  [252833] Agent route no longer needed...moving it to stopped routes

2016-10-06 16:24:52,054 INFO  [252833] Route removed from context >HLM(ad495160-864d-4b74-8aec-cc708036b5e0)<

2016-10-06 16:24:52,054 DEBUG [252833]
 

验证

• 验证平台管理Web服务是否在UC应用上运行

导航至Cisco Unified Serviceability > Platform Service > Platform Administrative Web Service

• 在访问wsdl文件时验证平台管理Web服务回复

https://UC_APP_IP_ADDRRESS:8443/platform-services/services/DeploymentModeService?wsdl

解决方案 4

联系思科TAC，将PLM部署模式改回HCS

 

2016-10-07 11:37:55,581 INFO  [238120] UCAppDeploymentModeConnection: Opening secure connection to: https://10.48.52.10:8443/platform-services/services/DeploymentModeService?wsdl

2016-10-07 11:37:55,581 INFO  [238120] UCAppDeploymentModeConnectionPort successfully opened

2016-10-07 11:37:55,608 INFO  [238120] UCAppDeploymentModeConnection: Setting userName for SOAP connection to: ccmadmin

2016-10-07 11:37:55,608 INFO  [238120] UCAppDeploymentModeConnection: Accepting Certificate from UC Application

2016-10-07 11:37:55,608 INFO  [238120] UCAppDeploymentModeConnection.getDeploymentMode Called

2016-10-07 11:37:55,980 DEBUG [238120] UCAppDeploymentModeConnection.getDeploymentMode Response Recieved

2016-10-07 11:37:55,980 INFO  [238120] UCAppDeploymentModeConnection.getDeploymentMode Completed returning value: Enterprise

2016-10-07 11:37:55,980 INFO  [238120] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  Found current UC app deployment mode to be: Enterprise

2016-10-07 11:37:55,980 INFO  [238120] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  Found current Global deployment mode to be: HCS

2016-10-07 11:37:55,980 INFO  [238120] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  Setting the UC app deployment mode to be: HCS

2016-10-07 11:37:55,981 INFO  [238120] UCAppDeploymentModeConnection: Opening secure connection to: https://10.48.52.10:8443/platform-services/services/DeploymentModeService?wsdl

2016-10-07 11:37:55,981 INFO  [238120] UCAppDeploymentModeConnectionPort successfully opened

2016-10-07 11:37:55,993 INFO  [238120] UCAppDeploymentModeConnection: Setting userName for SOAP connection to: ccmadmin

2016-10-07 11:37:55,993 INFO  [238120] UCAppDeploymentModeConnection: Accepting Certificate from UC Application

2016-10-07 11:37:55,993 INFO  [238120] UCAppDeploymentModeConnection.setDeploymentMode Called

2016-10-07 11:37:56,183 DEBUG [238120] UCAppDeploymentModeConnection.setDeploymentMode Response Recieved

2016-10-07 11:37:56,189 INFO  [238120] UCAppRestartSystemConnection: Opening secure connection to: https://10.48.52.10:8443/platform-services/services/RestartSystemService?wsdl

2016-10-07 11:37:56,205 INFO  [238120] UCAppRestartSystemConnection: Setting userName for SOAP connection to: ccmadmin

2016-10-07 11:37:56,205 INFO  [238120] UCAppRestartSystemConnection: Accepting Certificate from UC Application

 

2016-10-07 11:54:12,248 INFO  [238120] ELMApi: initialized, connected to plm-hcs10

2016-10-07 11:54:12,248 DEBUG [238120] ELMApi: createCluster called - force registration is enabled.

2016-10-07 11:54:12,248 DEBUG [238120] ELMApi:Creating Cluster with clusterName: test-cluster-Z|HostName: 10.48.52.10|userid: ccmadmin|password: ******|Type: HUCM

2016-10-07 11:54:12,360 DEBUG [238120] ELMApi: createCluster  Response status = 400

2016-10-07 11:54:12,360 ERROR [238120] ELMApi: createCluster completes with an error. LM resp status: 400

2016-10-07 11:54:12,360 ERROR [238120] HLMClusterLicenseAgent:  Failed to assign cluster test-cluster-Z due to an internal error in LM plm-hcs10

2016-10-07 11:54:12,360 DEBUG [238120] hlmSDRUtil.updateJob

2016-10-07 11:54:12,412 DEBUG [238120] hlmSDRUtil.beginTransaction

2016-10-07 11:54:12,415 DEBUG [238120] hlmSDRUtilcommitTransaction

2016-10-07 11:54:12,538 INFO  [238120] AgentFSM::currentState changed from null0 to stopped

2016-10-07 11:54:12,539 INFO  [238120] Agent route no longer needed...moving it to stopped routes

2016-10-07 11:54:12,539 INFO  [238120] Route removed from context >HLM(8032fcf3-9368-4644-a46f-46445247e893)<

2016-10-07 11:54:12,539 DEBUG [238120] +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

2016-10-07 11:54:12,539 DEBUG [238120]  Agent info : HLM(8032fcf3-9368-4644-a46f-46445247e893): RED

Assign test-cluster-Z to plm-hcs10 is Failed

验证

通过浏览以下URL验证PLM部署模式。需要PLM平台用户ID和密码

           https://PLM_IP_Address /elm-resources/

解决方案 5

在端口8443上启用HCM-F和PLM之间的IP连接。从日志中，HLM无法连接到PLM

2016-10-18 12:17:47,119 DEBUG [264677] ELMApi:Creating Cluster with clusterName: cluster delta|HostName: 10.48.55.26|userid: administrator|password: ******|Type: HUCM

2016-10-18 12:17:47,904 DEBUG [43] KeepAliveConsumerProcessor::process -- enter

2016-10-18 12:17:47,905 DEBUG [43] KeepAliveConsumerProcessor::process -- received broadcast message for service sdrcnf

2016-10-18 12:17:47,905 DEBUG [43] noChange -- sdrcnf is Alive

2016-10-18 12:17:47,905 DEBUG [43] KeepAliveMonitor::setExpiresBy:

2016-10-18 12:17:47,905 DEBUG [43]   now:         18/10/2016 12:17:47.905

2016-10-18 12:17:47,905 DEBUG [43]   expected by: 18/10/2016 12:19:47.905

2016-10-18 12:17:47,905 DEBUG [71] KeepAliveConsumerProcessor::process -- enter

2016-10-18 12:17:47,906 DEBUG [71] KeepAliveConsumerProcessor::process -- received broadcast message for service sdrcnf

2016-10-18 12:17:47,906 DEBUG [71] noChange -- sdrcnf is Alive

2016-10-18 12:17:47,906 DEBUG [71] KeepAliveMonitor::setExpiresBy:

2016-10-18 12:17:47,906 DEBUG [71]   now:         18/10/2016 12:17:47.906

2016-10-18 12:17:47,906 DEBUG [71]   expected by: 18/10/2016 12:19:47.906

2016-10-18 12:17:50,188 ERROR [264677] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  javax.ws.rs.WebApplicationException: javax.xml.bind.MarshalException

- with linked exception:

[java.net.NoRouteToHostException: No route to host]

2016-10-18 12:17:50,188 DEBUG [264677] hlmSDRUtil.updateJob

2016-10-18 12:17:50,247 DEBUG [264677] hlmSDRUtil.beginTransaction

2016-10-18 12:17:50,249 DEBUG [264677] hlmSDRUtilcommitTransaction

2016-10-18 12:17:50,356 INFO  [264677] AgentFSM::currentState changed from null0 to stopped

2016-10-18 12:17:50,356 INFO  [264677] Agent route no longer needed...moving it to stopped routes

验证

 验证PLM和HCM-F之间的连接

admin:utils network ping XXX.YYY.WWW.ZZZ

问题：HCM-F管理员无法将UC集群分配给PLM实例

作业失败，错误如图所示

;

解决方案

在HCM-F或CUCDM中添加平台凭证

2016-10-06 16:26:48,508 DEBUG [264674] hlmSDRUtilcommitTransaction

2016-10-06 16:26:48,624 ERROR [264674] HLMClusterLicenseAgent: .null0_AssignClusterToELMRequest  no platform credential is configured for test-cluster-Y

2016-10-06 16:26:48,624 DEBUG [264674] hlmSDRUtil.updateJob

2016-10-06 16:26:48,675 DEBUG [264674] hlmSDRUtil.beginTransaction

2016-10-06 16:26:48,677 DEBUG [264674] hlmSDRUtilcommitTransaction

2016-10-06 16:26:48,798 INFO  [264674] AgentFSM::currentState changed from null0 to stopped

2016-10-06 16:26:48,798 INFO  [264674] Agent route no longer needed...moving it to stopped routes

2016-10-06 16:26:48,798 INFO  [264674] Route removed from context >HLM(1b32a922-3619-44b0-8004-7f6fc930c419)<

2016-10-06 16:26:48,798 DEBUG [264674] +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

2016-10-06 16:26:48,798 DEBUG [264674]  Agent info : HLM(1b32a922-3619-44b0-8004-7f6fc930c419): RED

Assign test-cluster-Y to plm-hcs10 is Failed

2016-10-06 16:26:48,798 DEBUG [264674]  AgentMessageProcessor::Agent is stopped after process, removed it from persistence store

 

验证

验证平台凭证是否已配置到HCM-F

导航至Application Management > Cluster Application > Credential > Platform

或

导航至管理>默认凭证> UC应用类型(CUCM/CUCXN)平台