配置HCM-F服务资产报告

简介

本文档介绍如何在托管协作解决方案(HCS)9.2.1部署中创建服务资产(SI)报告，以及此过程中思科托管协作调解实施(HCM-F)服务资产与思科统一通信域管理器(CUCDM)8.1.X之间的交互。

先决条件

要求

本文档没有任何特定的要求。

使用的组件

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

• CUCDM 8.1.X
• HCM-F 9.2.1

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

背景信息

Cisco HCS SI是为服务提供商提供报告以用于计费的应用。这些报告包含有关客户、用户、设备以及当前在CUCDM上调配的其他详细信息的数据。此外，SI可以直接从Cisco Unified Communications Manager和Cisco Unity Connection应用服务器为未配置CUCDM的Cisco HCM-F中调配的客户生成报告。SI按可配置的定期间隔自动将报告文件传输到远程SFTP服务器。服务提供商使用这些报告为其客户生成计费记录。

工作流

1. SI报告由管理员通过服务资产配置进行计划和配置。
2. SI Web服务根据设置的计划向CUCDM提交简单对象访问协议(SOAP)请求。
3. CUCDM接收此SOAP请求并触发事务以创建服务资产相关数据，CUCDM通过SFTP将此数据发送到HCM-F SI。
4. SI会看到新文件，解压缩文件，并处理文件。
5. SI最终输出一个.si文件。
6. SI创建所有文件（包括.si）的备份副本，以便以后检索和现场支持（如有必要）。
7. SI将.si文件传输到GUI中配置的SFTP主机。

先决条件

必须安装和配置HCM-F和CUCDM。必须在HCM-F上激活和启动以下服务：

• 思科CDM数据库
• Cisco Tomcat
• 思科HCS SI UI

如果计划通过SI管理接口配置SI，请使用Cisco HCS北向接口Web服务。如果您计划通过Cisco HCM-F NBI配置SI，请使用Cisco HCS实施服务。如果您计划运行Cisco HCS CUCDMSync服务，请确保Cisco HCS CUCDMSync服务正在运行。使用Cisco HCS调配适配器服务，以便自动同步可以将CUCDM数据传播到共享数据存储库。SI从共享数据存储库获取CUCDM的连接数据。Cisco HCS调配适配器服务调配凭证和SNMP信息，并在Cisco Unified Communications Manager设备上调配远程系统日志数据。

CUCDM报告和支持的UC应用报告所需的服务不同。

对于CUCDM报告，您需要以下服务：

• Cisco HCS调配适配器服务
• Cisco Tomcat
• Cisco HCS服务资产
• 思科HCS SI UI
• 思科CDM数据库
• Cisco HCS实施服务
• Cisco HCS CUCDMSync服务
• Cisco HCS UCSMSync服务
• Cisco HCS VCenterSync服务

对于支持的UC应用报告，您需要以下服务：

• Cisco HCS调配适配器服务
• Cisco Tomcat
• Cisco HCS服务资产
• 思科HCS SI UI
• 思科CDM数据库

必须在CUCDM 8.1.X上激活和启动Web服务。

=>[webservices] # 

show

|OPTION |VALUE |DESCRIPTION |
|------ |----- |----------- |
|Enabled |True |Enable Webservice |
|8.1.0 |True |Enable version 8.1.0 webservices interface |
|8.0.0 |False |Enable version 8.0.0 compatible webservices interface |

配置

注意：使用命令查找工具（仅限注册用户）可获取有关本部分所使用命令的详细信息。

确保已在HCM-F中将CUCDM添加为管理应用实例。这是因为HCM-F服务清单依赖于CUCDM的数据来生成SI报告，因此需要添加它。

为此，请选择基础结构管理器>管理网络>管理应用程序>添加新建。

• API版本 — 从此下拉列表中，选择8.1.0或8.0。

  与8.1.2之前的CUCDM版本集成时，API版本必须设置为8.0。与CUCDM 8.1.2或更高版本集成时，API版本可以设置为8.0或8.1。另请注意，如果配置了8.0 API版本，SIP中继将不会同步，并且仅会为客户位置同步位置名称。

• 端口 — 端口默认为8181。这是SI用于向CUCDM发送第一条SOAP消息的SOAP端口。
  
  
• 凭证 — 选择凭证类型ADMIN并提供用户ID（在本例中为hcmf）。 此用户用于访问CUCDM。

注意：此用户还需要在CUCDM中使用相同的密码。要检查此项，请从CUCDM GUI中选择General Administration > Administration Users。

添加/配置此用户时，请确保已检查Web服务访问。（HCM-F SI使用此用户向CUCDM发送Web服务请求，因此需要启用该用户。）

现在已涵盖从CUCDM生成报告。但是，SI还可以直接从支持的UC应用、Cisco Unified Communications Manager和Cisco Unity Connection应用服务器为未配置CUCDM的Cisco HCM-F中调配的客户生成报告。

如果未配置CUCDM，则需要手动添加Cisco Unified Communications Manager(CUCM)和Cisco Unity Connection(CUC)应用服务器，以运行服务资产报告。

1. 选择Infrastructure Manager > Customer Management > Customer > Cluster。选择相关应用。例如，CUCM或CUC服务器，如此图所示。

   

2. 将PLATFORM和ADMIN凭证添加到每个应用，如此映像所示。

   

添加凭据

要添加凭据，

1. 单击“凭证”选项卡。
2. 单击新增。
3. 选择凭据类型。

   注意：运行UC应用报告集合需要PLATFORM和ADMIN。

4. 填写“用户ID”、“密码”和“重新输入密码”字段。
5. Click Save.
6. 重复以添加下一个凭据类型。

添加网络地址

1. 单击“Network Address(网络地址)”选项卡。
2. 单击新增。
3. 选择网络空间：服务提供商空间。
4. 输入IPV4地址。

   Cisco Unified Communications Manager和Cisco Unity Connection都需要此功能。

集群应用

对下一个集群应用重复all。

接下来，在HCM-F的“服务资产配置”(Service Inventory Configuration)页面上配置服务资产(Service Inventory)条目，如下图所示。

概述页

您可以在此处设置计划，该计划定义您希望报告何时开始。

1. 请务必选中启用计划复选框。

   注意：报告格式版本是此处的关键。

   

2. 选择希望SI应用提供的报告格式版本。确保您使用SI的兼容版本和任何受支持的UC应用。有关兼容性信息，请参阅《思科托管协作解决方案的兼容性矩阵》。

   Cisco HCS 9.1(1)报告格式版本仅与CUCDM 8.1及更高版本兼容。Cisco HCS 9.0(1)报告格式版本与CUCDM 8.0及更高版本兼容。如果运行CUCDM软件的早期版本，请选择8.6(2)报告格式版本。

SI CUCDM报告

1. 为确保正确生成版本9.1(1)和9.0(1)HCS报告格式，请导航至Infrastructure Manager > Management Application。在此页上，请务必选择CUCDM软件版本8.0或8.1，而不是版本7.4。
2. 接下来，在HCM-F的Service Inventory Configuration页面上配置配置页面。

   

   

3. 在Service Inventory Settings（服务清单设置）部分，配置SI服务器的主机名/IP地址。SI主机名必须输入为IP地址或完全限定域名。如果CUCDM服务器未配置DNS，请在Hostname字段中输入IP地址。 

   用户名字段灰显（硬编码）。

   CUCDM使用用户名adminsftp将数据传输到SI应用。无法更新此字段。

4. 在Password字段中，输入adminsftp用户帐户的密码。出于安全考虑，此步骤需要身份确认。此密码与您在Cisco HCM-F安装（或安装后更改）期间设置的HCS管理员密码相同。 

   注意：当SI发送原始SOAP请求时，CUCDM从SI获取此密码。

5. 在Service Provider SFTP Settings(服务提供商SFTP设置)部分，配置主机名和端口(22)以及要向其发送.si报告文件的SFTP服务器的用户名/口令。

故障排除

本部分提供了可用于对配置进行故障排除的信息。

重要日志包括：

• activelog tomcat/logs/catalina.out — 包括发往CUCDM和发自CUCDM的请求和响应消息。
• activelog tomcat/logs/si/log4j — 包含所有特定于SI的操作。

注意：如果使用不带CUCDM的SI，请查看以下日志：
- /var/log/active/hcs/chpa — 调配适配器服务日志文件
- /var/log/active/hcs/ucpa - ucpa服务日志文件

要将日志级别设置为“详细（调试）”级别，请完成以下步骤：

1. 输入以下命令：

   admin:

   set trace tracelevel

   [an error occurred while processing this directive]
2. 输入跟踪级别(使用CLI命令show tracelevels查找允许的跟踪级别) — 详细
3. 输入servicename - Cisco Tomcat

   记录已成功更新。

完成后，请按照您的计划等待下一次报告生成。首先要检查的是您能否在VOSS中查看事务。搜索名为CreateServiceInventory的事务。此事务应会成功。

请注意，在事务输出中，您可以看到User ID是HCM-F和CUCDM中之前配置的hcmf用户。

完成后，检查文件是否已正确将其转换为SI。了解报告数据结构在SI中的作用方式非常重要。SI文件的格式是基于ASCII的文件，其文件扩展名为“.si”。（UC应用服务资产通用格式的文件扩展名为.ucsi）

因此，在正常情况下，CUCDM将原始SI文件（压缩）发送到HCM-F。HCM-F(SI)然后按摩数据。（SI可以看到新文件，解压缩文件，并处理文件。）在文件结构中，有许多目录，其中每个目录都有各自的含义，具体取决于数据的状态。在故障排除课程中，只有技术支持中心(TAC)通过根帐户访问这些文件夹。

具体来说，所有文件都存储在SI中：/opt/hcs/si/backup/

• dmuncompressed/ — 这是解压和放置从CUCDM收到的文件的位置。
• cntranslated/ — 然后将文件转换为中间步骤，这些文件将进入此目录。
• cisco-normalized/ — 然后生成一个文件（最终输出的副本），并进入此处。
• sp-normalized/ — 根据GUI上配置的最大文件大小，根据配置的最大填充大小将前面提到的文件拆分为多个块（然后重新编号以排序）。

/opt/hcs/si/backup/dmuncompressed
[root@hcmf921 dmuncompressed]#
20150522210000GMT+1+CUCDM+1+1.dsi  20150622121500GMT+1+CUCDM+1+1.dsi
20150523210000GMT+1+CUCDM+1+1.dsi  20150623121500GMT+1+CUCDM+1+1.dsi
20150524210000GMT+1+CUCDM+1+1.dsi  20150624121500GMT+1+CUCDM+1+1.dsi
20150525210000GMT+1+CUCDM+1+1.dsi  20150625121500GMT+1+CUCDM+1+1.dsi
20150526210000GMT+1+CUCDM+1+1.dsi  20150626121500GMT+1+CUCDM+1+1.dsi
[root@hcmf921 dmuncompressed]#

/opt/hcs/si/backup/cntranslated
[root@hcmf921 cntranslated]#
20150602210000GMT+1+CUCDM+1+1.tsi  20150703121500GMT+1+CUCDM+1+1.tsi
20150603210000GMT+1+CUCDM+1+1.tsi  20150704121500GMT+1+CUCDM+1+1.tsi
20150604210000GMT+1+CUCDM+1+1.tsi  20150705121500GMT+1+CUCDM+1+1.tsi
20150605210000GMT+1+CUCDM+1+1.tsi  20150706121500GMT+1+CUCDM+1+1.tsi
[root@hcmf921 cntranslated]#

/opt/hcs/si/backup/cisco-normalized
[root@hcmf921 cisco-normalized]#
10000GMT+1+CUCDM+1+1.csi  20150703121500GMT+1+CUCDM+1+1.csi
20150603210000GMT+1+CUCDM+1+1.csi  20150704121500GMT+1+CUCDM+1+1.csi
20150604210000GMT+1+CUCDM+1+1.csi  20150705121500GMT+1+CUCDM+1+1.csi
20150605210000GMT+1+CUCDM+1+1.csi  20150706121500GMT+1+CUCDM+1+1.csi
20150606210000GMT+1+CUCDM+1+1.csi  20150707121500GMT+1+CUCDM+1+1.csi
20150607210000GMT+1+CUCDM+1+1.csi  20150708121500GMT+1+CUCDM+1+1.csi
20150608210000GMT+1+CUCDM+1+1.csi  20150709090000GMT+1+CUCDM+1+1.csi

/opt/hcs/si/backup/sp-normalized
[root@hcmf921 sp-normalized]#
20150528210000GMT+1+CUCDM+1+1.si  20150628121500GMT+1+CUCDM+1+1.si
20150529210000GMT+1+CUCDM+1+1.si  20150629121500GMT+1+CUCDM+1+1.si
20150530210000GMT+1+CUCDM+1+1.si  20150630121500GMT+1+CUCDM+1+1.si
20150531210000GMT+1+CUCDM+1+1.si  20150701121500GMT+1+CUCDM+1+1.si
20150601210000GMT+1+CUCDM+1+1.si  20150702121500GMT+1+CUCDM+1+1.si

要从SI提取日志文件，请输入以下命令

file get activelog  tomcat/logs/catalina.out
file get activelog tomcat/logs/si/log4j/XXXXXX (where XXXX are the filenames
 you want to gather)

验证

当前没有可用于此配置的验证过程。