配置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伺服器。服務提供商使用這些報告為其客戶生成賬單記錄。

工作流程

  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上啟用和啟動這些服務：

  • 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)應用伺服器，以便運行「服務清單」報告。

  1. 選擇Infrastructure Manager > Customer Management > Customer > Cluster。選擇相關應用程式。例如，CUCM或CUC伺服器，如下圖所示。

  2. 將平台和管理員憑據新增到每個應用程式，如下圖所示。

新增憑據

要新增憑據，

  1. 按一下Credentials頁籤。
  2. 按一下「Add New」。
  3. 選擇Credential Type。

    附註：要運行UC應用程式報告收集，需要PLATFORM和ADMIN。

  4. 填寫使用者ID、密碼和重新輸入密碼欄位。
  5. 按一下「Save」。
  6. 重複以新增下一個憑據型別。

新增網路地址

  1. 按一下Network Address頁籤。
  2. 按一下「Add New」。
  3. 選擇Network Space:服務提供商空間。
  4. 輸入IPV4地址。

    對於Cisco Unified Communications Manager和Cisco Unity Connection，這是必需的。

群集應用程式

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

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

概述頁面

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

  1. 務必勾選「Enable Schedule」覈取方塊。

    附註：此處的「報告格式版本」是關鍵。

  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 Page上配置Configuration Page。

  3. 在Service Inventory Settings部分，配置SI伺服器的主機名/IP地址。SI主機名必須輸入為IP地址或完全限定域名。如果CUCDM伺服器未配置啟用DNS，請在Hostname欄位中輸入IP地址。 

    使用者名稱欄位呈灰色顯示（硬編碼）。

    CUCDM使用使用者名稱adminsftp將資料傳輸到SI應用程式。您無法更新此欄位。

  4. 在「密碼」欄位中，輸入adminsftp使用者帳戶的密碼。出於安全考慮，此步驟需要作為身份確認。此密碼與在Cisco HCM-F安裝過程中設定的HCS管理員密碼相同（或者在安裝後更改）。 

    附註：CUCDM在SI傳送原始SOAP請求時從SI獲取此密碼。

  5. 在「服務提供商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服務日誌檔案

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

  1. 輸入以下命令： 
    admin:
    set trace tracelevel
     [an error occurred while processing this directive]
  2. 輸入tracelevel(使用CLI命令show tracelevels查詢允許的tracelevels) — 詳細
  3. 輸入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]

驗證

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

TAC Authored

由思科工程師貢獻

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

這份文件是否有所幫助？

Feedback意見

讓思科協助您

本文件適用於這些產品