配置HCM-F服務庫存報告

下載選項

PDF (706.0 KB)
在多種裝置上使用 Adobe Reader 檢視
ePub (477.4 KB)
在 iPhone、iPad、Android、Sony Reader 或 Windows Phone 上的各種應用程式中檢視
Mobi (Kindle) (509.4 KB)
在 Kindle 裝置或多部裝置的 Kindle 應用程式上檢視

已更新: 2016 年 2 月 10 日

文件 ID:119380

無偏見用語

本產品的文件集力求使用無偏見用語。針對本文件集的目的，無偏見係定義為未根據年齡、身心障礙、性別、種族身分、民族身分、性別傾向、社會經濟地位及交織性表示歧視的用語。由於本產品軟體使用者介面中硬式編碼的語言、根據 RFP 文件使用的語言，或引用第三方產品的語言，因此本文件中可能會出現例外狀況。深入瞭解思科如何使用包容性用語。

關於此翻譯

思科已使用電腦和人工技術翻譯本文件，讓全世界的使用者能夠以自己的語言理解支援內容。請注意，即使是最佳機器翻譯，也不如專業譯者翻譯的內容準確。Cisco Systems, Inc. 對這些翻譯的準確度概不負責，並建議一律查看原始英文文件（提供連結）。

簡介

本文檔介紹在此過程中，如何在託管合作解決方案(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應用伺服器為在Cisco HCM-F中調配但未配置CUCDM的客戶生成報告。SI按可配置的定期間隔自動將報告檔案傳輸到遠端SFTP伺服器。服務提供商使用這些報告為其客戶生成賬單記錄。

工作流程

SI報告由管理員通過「服務資產配置」進行計畫和配置。
根據設定的時間表，SI Web服務向CUCDM提交簡單對象訪問協定(SOAP)請求。
CUCDM收到此SOAP請求並觸發事務，以便建立服務清單相關資料，CUCDM通過SFTP將此資料傳送到HCM-F SI。
SI會看到新檔案，解壓縮該檔案並處理該檔案。
SI最終輸出一個.si檔案。
SI建立所有檔案（包括.si）的備份副本，以便在以後進行檢索並在必要時提供現場支援。
SI會將.si檔案傳輸到GUI中配置的SFTP主機。

必要條件

必須安裝和配置HCM-F和CUCDM。必須在HCM-F上啟用和啟動這些服務：

Cisco CDM資料庫
Cisco Tomcat
Cisco HCS SI UI

如果您計畫通過SI管理介面配置SI，請使用Cisco HCS北向介面Web服務。如果您計畫通過Cisco HCM-F NBI配置SI，請使用Cisco HCS實施服務。如果計畫運行Cisco HCS CUCDMSync服務，請確保正在運行Cisco HCS CUCDMSync服務。使用Cisco HCS Provisioning Adapter Service，以便自動同步可以將CUCDM資料傳播到共用資料儲存庫。SI從共用資料儲存庫獲取CUCDM的連線資料。Cisco HCS調配介面卡服務調配憑證和SNMP資訊，並在Cisco Unified Communications Manager裝置上調配遠端系統日誌資料。

所需的服務在CUCDM報告和受支援的UC應用報告之間有所不同。

對於CUCDM報告，您需要以下服務：

Cisco HCS布建配接器服務
Cisco Tomcat
Cisco HCS服務庫存
Cisco HCS SI UI
Cisco CDM資料庫
Cisco HCS實施服務
Cisco HCS CUCDMSync服務
Cisco HCS UCSMSync服務
Cisco HCS VCenterSync服務

對於支援的UC應用報告，您需要以下服務：

Cisco HCS布建配接器服務
Cisco Tomcat
Cisco HCS服務庫存
Cisco HCS SI UI
Cisco 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 |

[an error occurred while processing this directive]

設定

附註：使用命令查詢工具(僅供已註冊客戶使用)可獲取本節中使用的命令的更多資訊。

確保已將CUCDM新增為HCM-F中的管理應用程式例項。這是因為HCM-F服務清單依賴於CUCDM的資料生成SI報告，因此需要新增該報告。

為此，請選擇Infrastructure Manager > Management Network > Management Application > Add New。

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用來將第一個SOAP消息傳送到CUCDM的SOAP埠。
憑據 — 選擇憑據型別ADMIN並提供使用者ID（本例中為hcmf）。此使用者用於訪問CUCDM。

附註：此使用者還需要存在於具有相同密碼的CUCDM中。要檢查這一點，請在CUCDM GUI中選擇General Administration > Administration Users。

新增/配置此使用者時，請確保已選中Web服務訪問。（此使用者由HCM-F SI用於向CUCDM傳送WebService請求，因此需要啟用它。）

現已涵蓋源自CUCDM的報告生成。但是，對於在Cisco HCM-F中調配但未配置CUCDM的客戶，SI還可以直接從受支援的UC應用程式、Cisco Unified Communications Manager和Cisco Unity Connection應用程式伺服器生成報告。

如果沒有配置CUCDM，則需要手動新增Cisco Unified Communications Manager(CUCM)和Cisco Unity Connection(CUC)應用伺服器，以便運行「服務清單」報告。

選擇Infrastructure Manager > Customer Management > Customer > Cluster。選擇相關應用程式。例如，CUCM或CUC伺服器，如下圖所示。
將平台和管理員憑據新增到每個應用程式，如下圖所示。

新增憑據

要新增憑據，

按一下Credentials頁籤。
按一下「Add New」。
選擇Credential Type。
附註：要運行UC應用程式報告收集，需要PLATFORM和ADMIN。
填寫使用者ID、密碼和重新輸入密碼欄位。
按一下「Save」。
重複以新增下一個憑據型別。

新增網路地址

按一下Network Address頁籤。
按一下「Add New」。
選擇Network Space:服務提供商空間。
輸入IPV4地址。
對於Cisco Unified Communications Manager和Cisco Unity Connection，這是必需的。

群集應用程式

對下一個群集應用程式重複所有。

接下來，在HCM-F的「服務清單配置」頁面上配置「服務清單」部分，如下圖所示。

概述頁面

您可以在此處設定時間表，定義您希望報告開始的時間。

務必勾選「Enable Schedule」覈取方塊。
附註：此處的「報告格式版本」是關鍵。
選擇希望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報告

為了確保正確生成9.1(1)和9.0(1)版HCS報告格式，請導航到Infrastructure Manager > Management Application。在此頁面上，請務必選擇CUCDM軟體版本8.0或8.1，而不是版本7.4。
接下來，在HCM-F上的Service Inventory Configuration Page上配置Configuration Page。
在Service Inventory Settings部分，配置SI伺服器的主機名/IP地址。SI主機名必須輸入為IP地址或完全限定域名。如果CUCDM伺服器未配置啟用DNS，請在Hostname欄位中輸入IP地址。
使用者名稱欄位呈灰色顯示（硬編碼）。

CUCDM使用使用者名稱adminsftp將資料傳輸到SI應用程式。您無法更新此欄位。
在「密碼」欄位中，輸入adminsftp使用者帳戶的密碼。出於安全考慮，此步驟需要作為身份確認。此密碼與在Cisco HCM-F安裝過程中設定的HCS管理員密碼相同（或者在安裝後更改）。
附註：CUCDM在SI傳送原始SOAP請求時從SI獲取此密碼。
在「服務提供商SFTP設定」部分，配置主機名和埠(22)以及要向其傳送.si報告檔案的SFTP伺服器的使用者名稱/密碼。

疑難排解

本節提供的資訊可用於對組態進行疑難排解。

重要日誌包括：

activelog tomcat/logs/catalina.out — 包括與CUCDM之間的請求和響應消息。
activelog tomcat/logs/si/log4j — 包含所有特定於SI的操作。

附註：如果使用不帶CUCDM的SI，還應檢視以下日誌：
- /var/log/active/hcs/chpa — 設定介面卡服務日誌檔案
- /var/log/active/hcs/ucpa - ucpa服務日誌檔案

完成以下步驟，將日誌級別設定為詳細（調試）級別：

輸入以下命令：
```
admin:
```
set trace tracelevel
[an error occurred while processing this directive]
輸入tracelevel(使用CLI命令show tracelevels查詢允許的tracelevels) — 詳細
輸入servicename - Cisco Tomcat
已成功更新記錄。

完成上述操作後，請按照您的計畫等待下一次報告生成。首先要檢查的是是否可以在VOSS中看到事務。搜尋名為CreateServiceInventory的事務。此事務應成功。

請注意，您可以在事務輸出中看到使用者ID是之前在HCM-F和CUCDM中配置的hcmf使用者。

完成後，檢查檔案是否正確進入SI。瞭解報告資料結構在SI中的運作方式很重要。SI檔案的格式是基於ASCII的檔案，副檔名為「.si」。（統一通訊應用服務清單通用格式的副檔名為.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]#

[an error occurred while processing this directive]

/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]#

[an error occurred while processing this directive]

/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

[an error occurred while processing this directive]

/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

[an error occurred while processing this directive]

若要從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)

[an error occurred while processing this directive]

驗證

目前沒有適用於此組態的驗證程序。

由思科工程師貢獻

Andrea Cingolani
Cisco TAC工程師
Kurt Van De Vel
Cisco TAC工程師

這份文件是否有所幫助？

意見

讓思科協助您

開啟支援問題單
(需有思科服務合約)

本文件適用於這些產品

Hosted Collaboration Solution (HCS)