配置Prime合作保證(PCA) -會議診斷

簡介

本文檔介紹如何配置和設定Prime合作保證(PCA)中的會議診斷部署，以主動監控語音/視訊會議統計資訊。

必要條件

需求

思科建議您瞭解以下主題：

• Call Manager管理員登入
• PCA登入
• 您的網真監控伺服器(TMS)
• 核心/Expressway憑證（如果適用）

  

採用元件

本文檔中的資訊基於PCA版本11.x - 12.x。

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路正在作用，請確保您已瞭解任何指令可能造成的影響。

背景資訊

Cisco Prime Collaboration 11.x支援以下型別的可視性：

• 完全可視性-支援使用JTAPI/HTTP反饋和即時監控資訊（如會議統計資訊和會議資訊）進行呼叫檢測。

• 有限的可視性-使用JTAPI/HTTP反饋進行自動呼叫檢測，但不支援即時監控資訊（如會議統計資訊和會議資訊）。可視性有限的終端在會議拓撲中以半灰色的圖示表示。

Cisco Prime Collaboration 12.x支援以下型別的可視性：

• 完全可視性-支援使用JTAPI/HTTP反饋和即時監控資訊（如會議統計資訊和會議資訊）進行呼叫檢測。
• 無可視性-不支援使用JTAPI/HTTP反饋和即時監控資訊進行呼叫檢測。這些終端在「會議監控」頁面上以完全灰顯的圖示顯示。

將終端限制設定為每個OVA的有限可視性或完全可視性

• 小型開放式虛擬化存檔(OVA)最多可支援500個終端
• 中型OVA支援多達1000個終端
• 大型OVA支援多達1800個終端
• 超大型OVA支援多達2000個終端

有關會議和我們支援的會話的每個PCA支援的裝置清單如下面的表圖所示。

  

設定

案例 1.影片終端註冊到Call Manager的會議

步驟 1.首先，您需要確保呼叫管理器處於「託管」狀態。

導航到資產>資產管理>管理憑據>為Call Manager集群建立配置檔案。

注意：請記住，每個憑據配置檔案都會對配置檔案中列出的每個ip使用相同的憑據。因此，如果您在同一個憑證配置檔案中列出Call Manager發佈伺服器和訂閱伺服器，它將使用這些相同的憑證來發現兩個IP地址。如果您的設定中確實存在導體，請首先發現該導體，然後發現Cisco Call Manager，如圖所示。

步驟 2.確保您已設定了超文本傳輸協定(HTTP)、簡單名稱管理協定(SNMP)和Java電話API (JTAPI)憑證 

此外，您還必須在Call Manager Serviceability中啟用Cisco Computer Telephony Integration (CTI)服務。

Cisco Unified Communications Manager設定

啟用HTTP

如果您要允許Cisco Prime Collaboration使用管理員憑證登入，則無需建立新使用者。或者，如果您要允許Cisco Prime合作管理器使用正確的憑證登入到Cisco Unified Communications Manager，您必須建立新的HTTP使用者組和Cisco Prime合作可用於通訊的相應使用者。

要建立使用者，請執行以下步驟：

步驟 1.使用您的管理員帳戶登入到Cisco Unified CM管理Web介面。

步驟 2.建立具有足夠許可權的使用者組。 導航到使用者管理>使用者設定>訪問控制組，然後使用適當的名稱(在本例中為PC_HTTP_Users)建立新使用者組。現在，選擇Save。

步驟 3. 導航到使用者管理 > 使用者設定 > 訪問控制組，然後選擇查詢。尋找您定義的群組，然後按一下右邊的圖示。

步驟 4.選取將角色指定給群組，然後選取下列角色：

• 標準AXL API訪問
• 標準CCM管理員使用者
• 標準可維護性管理

步驟 5.按一下Save。

步驟 6.從主選單導航到使用者管理>應用程式使用者>建立新使用者。

在「應用程式使用者組態」頁面上指定適當的密碼。您只能從Available Devices文本區域選擇特定型別的裝置，或允許Cisco Prime Collaboration監控所有裝置

步驟 7.在許可權資訊部分中，選擇增加到使用者組，然後選擇在步驟1中建立的組。（例如，PC_HTTP_Users）。

步驟 8.按一下「儲存」。頁面會重新整理，並顯示正確的許可權。

啟用SNMP

預設情況下，Cisco Unified Communications Manager中未啟用SNMP。

若要啟用SNMP：

步驟 1.在Cisco Unified Communications Manager Web GUI中登入Cisco Unified Serviceabilityview。

步驟 2. 導航到工具>服務啟用。

步驟 3.選擇Publisher Server。 

步驟 4.導航到效能>監控服務，然後選中Cisco Call Manager SNMP服務對應的覈取方塊。

步驟 5.在螢幕底部選擇Save。

建立SNMP社群字串：

步驟 1.登入Cisco Unified Serviceabilityview the Cisco Unified Communications Manager Web GUI。

步驟 2.在Cisco Unified Serviceability檢視的主選單中，導航至SNMP > v1/v2c > Community String。

步驟 3.選取伺服器，然後按一下「尋找」。
如果已經定義了社群字串，則社群字串名稱將顯示在搜尋結果中。

步驟 4.按一下「新增」「新建」，在不顯示任何結果的情況下新增字串。

步驟 5.指定所需的SNMP資訊並儲存配置。

注意：僅需要SNMP只讀(RO)訪問。

啟動CTI服務

執行所需的Cisco Unified Communications Manager節點程式，最好在兩個節點上設定。

步驟 1.登入到Cisco Unified Serviceability，該功能可在Cisco Unified Communications Manager圖形使用者介面中檢視。

步驟 2.導航到工具>服務啟用。

步驟 3.從下拉選單中選擇伺服器。

步驟 4.在CM Services部分中，選中Cisco CTI Manager 覈取方塊。

步驟 5. 在螢幕頂部選擇Save

為PCA CTI控制建立應用程式使用者（JTAPI使用者）

JTAPI用於從裝置檢索會話狀態資訊。您必須在呼叫處理器中為CTI控制建立具有接收終端上的JTAPI事件所需許可權的應用使用者。Prime合作管理多個呼叫處理器集群。必須確保群集ID是唯一的。建立一個新的應用使用者，以幫助Cisco Prime Collaboration獲取所需資訊。

要建立新的JTAPI應用程式使用者，請執行以下步驟：

步驟 1.透過您的管理員帳戶登入到Cisco Unified CM管理Web介面。

步驟 2.建立具有足夠許可權的使用者組。 導航到使用者管理>使用者設定>訪問控制組，然後使用適當的名稱(在本例中為PC_HTTP_Users)建立新使用者組。現在，選擇Save。

步驟 3.選擇User Management > User Settings > Access Control Group，然後按一下Find。尋找您定義的群組，並選取右邊的圖示。

步驟 4.按一下「將角色指定給群組」並選取下列角色：

• 標準CTI允許呼叫監控
• 已啟用標準CTI
• 標準CTI允許控制支援互聯Xfer和conf的電話

步驟 5.選取儲存。

步驟 6.從主選單導航到使用者管理>應用程式使用者>建立新使用者。
在「應用程式使用者組態」頁面上指定適當的密碼。您可以從Available Devices文本區域選擇特定型別的裝置，或允許Cisco Prime Collaboration監控所有裝置。

注意：密碼不能包含分號(；)或等於(=)。

步驟 7.在許可權資訊部分，選擇增加到訪問控制組，然後選擇在步驟1中建立的組。（例如，PC_HTTP_Users）。

步驟 8.按一下「儲存」。頁面會重新整理，並顯示正確的許可權。 

注意：如果在增加JTAPI使用者之前管理了Call Manager，請確保已將JTAPI使用者增加到Call Manager的憑據配置檔案中，然後重新搜尋該使用者。

從場景1繼續。步驟：

步驟 3.導航到您建立的Call Manager JTAPI應用使用者，然後將支援的終端從可用裝置移動到受控裝置。

您可以透過裝置關聯功能執行此操作，如圖所示。

如果返回到終端設定為每個OVA的有限可視性或完全可視性的限制，則可以驗證已增加到OVA大小的裝置數量。

在此螢幕中，您可以按裝置名稱、說明或目錄號進行過濾，以幫助您管理和過濾這些裝置，如圖所示。

請注意在步驟7中新增的這些裝置。

 請確定已為此JTAPI使用者新增正確的使用者角色：

• 標準CTI允許呼叫監控
• 已啟用標準CTI
• 標準CTI允許控制支援已連線Xfer和conf的電話，如圖所示。

有關每個PCA支援的裝置清單，有關會議和我們支援的會話，請返回到「背景資訊」部分。

注意：此外，請確保由CTI應用程式使用者控制的裝置在裝置資訊下選中「允許透過CTI控制裝置」覈取方塊，如下圖所示。

注意：在您繼續閱讀下面的內容之前，請務必注意：如果您將終端註冊到Call Manager並且將Call Manager與VCS/TMS整合，那麼您首先會發現VCS/TMS，然後最後會發現Call Manager。這樣，從庫存的角度來看，您的所有基礎設施都會對映到正確的位置。此外，當您發現VCS/TMS時，請確保將預設的Discover頁籤更改為TMS/VCS或呼叫管理器各自的裝置。

步驟 4.接下來，在PCA中，選擇裝置發現並輸入您的呼叫管理器的IP地址，選中Auto-Configuration上的兩個覈取方塊，然後選擇Run Now，如下圖所示。

步驟 5.在Call Manager處於Managed狀態後，繼續執行步驟6。

注意：如果Call Manager未處於Managed狀態，大多數時間都是由HTTP或SNMP引起的，如果需要進一步的幫助，請建立TAC支援案例以使Call Manager處於Managed狀態。

步驟 6. 導航到資產>資產計畫>集群資料發現計畫，選擇立即運行。

注意：這取決於您有多少已註冊/未註冊裝置。此過程可能需要幾分鐘到幾小時之間的任意時間。透過刷新頁面來全天檢查。此外，這會將Call Manager集群對映在一起，並檢索您的所有終端。 完成之後，請繼續下一步。 

注意：如果有任何端點希望獲得支援的會議統計資訊，則在PCA資產中務必提及。確保為報告和所有統計資訊妥善管理這些資訊，以顯示正確的資訊。

步驟 7. 導航到診斷>終端診斷。

要獲取會議終端的最新統計資訊，您需要將其可視性設定為系統允許的最高級別。

選擇您想要在會議診斷中監控的所有終端，然後按一下Edit Visibility，然後選擇Full Visibility，如下圖所示。

有限可視性只顯示拓撲中的裝置，但沒有統計資訊，並且它無法檢索與會議診斷相關的裝置的適用警報。

註：例如，如果您選擇10個終端並選擇「完全可視性」，則它會為每個裝置選擇最高級別的可視性支援。

步驟 8.要進行測試，請導航到診斷>會議診斷，並顯示正在進行或已完成會議，如圖所示。

在這些會議中，您可以檢視音訊和視訊呼叫的平均資料包丟失、延遲和抖動。

此外，獲取會話和所涉及裝置的拓撲。

目前，會議診斷程式根據DN提取資訊，如果您的環境已共用DN，PCA將檢索收到的第一個會議資訊。

會議相關警報

對於會議診斷，您可以接收任何會話的三個不同警報並設定其閾值：

• 封包丟失
• 延遲
• 抖動

對於每種設定，您可以修改預設閾值，或定義您希望與此警報關聯的裝置。

步驟 1.導航到Alarm & Report Administration > Event Customization。

步驟 2.選擇Threshold Rules並確保已選擇Basic。

步驟 3.向下捲動或按一下右側「Category Named Session」，如下圖所示。

步驟 4.選擇警報旁邊的下拉箭頭。您要修改並修改資料包丟失、抖動或延遲的次要、主要或關鍵百分比。

步驟 5.如果您想要驚豔，請將「提升」切換為「驚豔」。

步驟 6.如果要定義與警報關聯的終端，可以選擇Custom Rule。

步驟 7.然後，選擇要用於此警報的Device Type > Select All Devices或Selectable Devices，然後按一下Save。

會議相關報告

對於會議診斷報告，可以檢索和檢視。

有兩個報告：

• 會議報告
• Telepresence終端報告

對於「會議報告」，您可以根據需要檢視一至四週時間範圍內或自定義時間段內的所有會議清單。

步驟 1.導航到報告>會議報告，如圖所示。

會議摘要報告

此報告提供您已選擇為有限/完全可視性的每個終端及其會議的檢視。

此處顯示的統計資料如下：

• 平均會議使用量
• 與會議相關的警報
• 平均丟包、抖動和延遲
• 最長的會議

這有助於您對語音/影片網路中存在的問題進行細緻的檢視，以確定哪些終端的問題最多。

此外，您還可以根據使用情況使用相應的頻寬。

會議詳細資訊報告頁籤

如果確實遇到會議的警報，您可以導航到會議詳細資訊報告頁籤。

選擇會議後，您可以對其進行細化，以查詢您可能有興趣的終端名稱、軟體版本和其他詳細資訊。 

對於Telepresence Endpoint Reports，您可以按終端檢視：

• 此裝置擁有的會議數目
• 使用率百分比
• 終端型號
• 使用量 

此外，您可以透過Change Utilization頁籤更改利用率引數，如下圖所示。

這會設定該裝置的引數，以便系統從使用狀況得知要顯示的百分比。

「No Show Endpoint Summary Report」顯示未出席計畫會議的終端。

在此圖形中，您還可以檢視終端以及總計畫會議數，以及其中有多少會議已經舉行並且沒有節目。

會議視訊測試呼叫

您可以在兩個處於託管狀態的影片終端之間建立點對點影片測試呼叫，以測試您的網路。您可以檢視事件和警報、會話統計資訊、終端統計資訊以及與其他呼叫類似的統計資訊。此呼叫僅支援CTS、C和EX系列編解碼器。

此外，這還可用於驗證會議診斷的所有功能是否正常。

必要條件

• E20編解碼器系列不支援此功能。
• 要使用此功能，必須為終端增加CLI憑證。
• 確保終端已註冊並為終端啟用JTAPI（如果終端已註冊到Unified CM）。
• 如果您在MSP模式下部署了Cisco Prime Collaboration，則影片測試呼叫功能不可用。

步驟 1.導航到診斷>終端診斷。

步驟 2.根據提及的必要條件選取兩個適用的端點。

步驟 3.選擇Run Tests > Video Test Call。

步驟 4.您可以將視訊測試呼叫排定為立即執行或依照重新發生的排程執行。

步驟 5.然後，此影片測試呼叫將顯示在會議診斷螢幕中。

案例 2. 具有非Call Manager註冊端點的會議

步驟 1.確保Telepresence Management Suite (TMS)和Video Communications Server (VCS)憑證可用。

注意：在此場景中發現VCS/TMS時，發現過程非常重要。 如果您的設定中確實有呼叫管理器，請先查詢指揮交換機，然後查詢Cisco Call Manager。

 步驟 2.導航到資產>資產管理>管理憑據> 選擇增加，然後輸入您的TMS資訊，同時為您的VCS建立單獨的憑據配置檔案，如圖所示。

步驟 3.建立憑據配置檔案後，選擇Device Discovery，輸入ip addresses，然後在Discovery頁籤中選擇VCS並發現VCS裝置。 並且，為TMS選擇TMS並輸入它的IP地址。按一下Run Now（如圖所示）。

步驟 4.確保VCS和TMS處於託管狀態。

注意：如果VCS或TMS未處於Managed狀態，大多數時間都是由HTTP或SNMP引起的，如果需要進一步的幫助，請建立TAC案例以使VCS/TMS處於Managed狀態。

注意：使用此URL並在VCS處於「託管」狀態後使用適當的IP地址替換IP_Address _of_VCS_Server。PCA伺服器必須註冊為VCS的反饋伺服器，這樣可以確保在會議會話結束時，VCS發回PCA的資料沒有問題。 

https://<IP_Address_of_VCS_Server>/getxml？location+/Status/feedback時會請求http憑證，輸入後，您必須收到回應，如圖所示。

注意：如果Prime Collaboration未通過HTTP反饋訂閱訂閱VCS，則在註冊的終端加入或離開會話，或向VCS註冊或取消註冊時，VCS不會通知它。在這種情況下，請根據需要將這些終端的可視性設定為完全或受限，並確保您的VCS處於「託管」狀態。

步驟 5. 導航到資產>資產計畫>集群資料發現計畫，選擇立即運行。

注意：此過程可能需要一些時間，因為它在所有基礎設施裝置上執行此功能。因此，如果幾分鐘後仍未完成，請在1-2小時後重新檢查。超大型系統最多可能需要4個小時。 如果有任何端點希望獲得支援的會議統計資訊，PCA資產中必須提及這一點，並且您還要確保這些端點受報告的管理，並且所有統計資訊都顯示正確的資訊。

有關會議及我們支援的會話方面根據PCA支援的裝置清單，請參閱背景資訊部分。

步驟 6. 導航到診斷>終端診斷。

要獲取會議端點的正確統計資訊，您需要將其可視性設定為系統允許的最高級別。

選擇您想要在會議診斷中監控的所有終端，然後按一下Edit Visibility，然後選擇最大可視性。

注意：如果您選擇（例如）10個終端並選擇「完全可視性」，則它會為每個裝置選擇最高級別的可視性支援。

步驟 7.為了測試，n導航到診斷>會議診斷，並且正在或已經完成會議，如下圖所示。

在這些會議中，您可以檢視音訊和視訊呼叫的平均資料包丟失、延遲和抖動。

此外，您還可獲得會話和所涉及裝置的拓撲。

會議相關警報

對於會議診斷，您可以接收三個不同的「警報」（任何會話）並設定其閾值：

• 封包丟失
• 延遲
• 抖動

您可以修改預設閾值、完全停用該閾值或定義您希望與此警報關聯的裝置。

步驟 1.導航到Alarm & Report Administration >Event Customization。

步驟 2.選擇Threshold Rules並確保已選擇Basic。

步驟 3.向下捲動或按一下右側「Category Named Session」，如下圖所示。

步驟 4.選擇要修改的警報旁的下拉箭頭，可以修改資料包丟失、抖動或延遲的次要、主要或嚴重百分比。

步驟 5.如果您要取樣，請將「提升」切換為「取樣」。

步驟 6.如果要定義與警報關聯的終端，請選擇Custom Rule。

步驟 7.接下來，選擇Device Type >，選擇All devices或Selectable devices，然後按一下儲存。

會議相關報告

對於會議診斷報告，可以檢索和檢視。

有兩個報告：

• 會議報告
• Telepresence終端報告

對於「會議報告」，您可以根據需要檢視一至四週時間範圍內或自定義時間段內的所有會議清單。

步驟 1.導航到報告>會議報告，如圖所示。

會議摘要報告

此報告提供您已選擇為有限/完全可視性的每個終端及其會議的檢視。

此處顯示的統計資料如下：

• 平均會議使用量
• 與會議相關的警報
• 平均丟包、抖動和延遲
• 最長的會議

這有助於您對語音/影片網路中可能存在的問題進行細緻的檢視，以確定哪些終端存在最多的問題。

以及根據使用量利用您的頻寬

會議詳細資訊報告頁籤

如果確實遇到會議的警報，您可以導航到「會議詳細資訊報告」頁籤。

選擇會議後，您可以細化以查詢終端名稱、軟體版本以及您可能感興趣的其他詳細資訊。 

對於Telepresence Endpoint Reports，您可以檢視每個終端的

• 此裝置擁有的會議數目
• 使用率百分比
• 終端型號
• 使用量 

此外，您可以透過「更改利用率」頁籤更改「利用率引數」，如圖所示。

這會設定該裝置的引數，以便系統從使用狀況得知要顯示的百分比。

「No Show Endpoint Summary Report」顯示未出席計畫會議的終端。

在此圖形中，您可以檢視終端以及總計畫會議數，以及這些會議中有多少已發生且未顯示。

會議視訊測試呼叫

您可以在處於託管狀態的兩個影片終端之間建立點對點影片測試呼叫，以測試您的網路。您可以檢視事件和警報、會話統計資訊、終端統計資訊和網路拓撲。此呼叫僅支援CTS、C和EX系列編解碼器。

此外，這還可用於驗證會議診斷的所有功能是否正確。

必要條件

• E20編解碼器系列不支援此功能。
• 要使用此功能，必須為終端增加CLI憑證。
• 確保終端已註冊並為終端啟用JTAPI（如果終端已註冊到Unified CM）。
• 如果您已在MSP模式下部署了Cisco Prime Collaboration，則影片測試呼叫功能不可用。

步驟 1.導航到診斷>終端診斷。

步驟 2.根據前提條件選擇兩個適用的端點。

步驟 3.選擇Run Tests > Video Test Call。

步驟 4.您可以將視訊測試呼叫排定為立即執行或依照重新發生的排程執行。

步驟 5.然後，此影片測試呼叫將顯示在會議診斷螢幕中。

驗證

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

疑難排解

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

用於故障排除的要收集的日誌

步驟 1.導航到系統管理>日誌管理。

步驟 2.向下滾動到模組，選擇Session Monitoring，然後選擇Edit，如下圖所示。

步驟 3.將日誌級別更改為debug，然後按一下Save。

步驟 4.重現問題，然後返回Log Management螢幕。

步驟 5.重現問題後，選擇Session Monitoring並選擇Download Log。

步驟 6.下載後，解壓縮zip檔案。

步驟 7.打開zip檔案並導航到有用的日誌的位置：

/opt/emms/emsam/log/SessionMon/

• CUCMJTAPI.log 
• CUCMJTAPIDiag.log
• CSMTracker 
• CSMTrackerDiag.log
• CSMTrackerDataSource.log 
• PostInitSessionMon.log