排除未在IM&P上啟動的服務故障

簡介

本檔案介紹思科即時訊息和線上狀態(IM&P)服務未能按預期啟動時應採取的步驟。

背景資訊

服務的狀態

IM&P服務具有以下狀態：

請記住，重新啟動IM&P節點後，將生成下一個警告，如果您導航到「通知」頁面，則可以在圖形使用者介面(GUI)上找到該警告，也可以通過命令列介面(CLI)找到該警告：

Cisco IM and Presence Data Monitor檢測到資料庫複製未完成，和/或來自Cisco Unified Communications Manager的Cisco Sync Agent同步未完成。在複製和思科同步代理同步成功完成之前，某些服務可以一直處於「正在啟動」狀態。

該消息不一定表示服務在生成警報後仍然處於Starting狀態。當IM&P Data Monitor在重新啟動或引導後立即開始監控服務時，預期會發生這種情況。Monitor服務檢測到的第一件事是，所有主要服務都處於Starting過程中，該過程將觸發消息。

為了確認服務的實際狀態，請運行utils service list命令。

附註：如果服務處於Started狀態，則可以隨意刪除警報以保持通知警報的清潔。

疑難排解

找出問題

對服務未啟動進行故障排除的第一步是瞭解哪些服務未啟動。

驗證出現在已停止服務右側的圖例非常重要，通常您可以確定：

• 服務未啟用:這意味著功能服務未啟用，需要先完成。

• 已停止服務:重新啟動伺服器後，如果HA未禁用或某些服務已重新啟動，並且此操作導致其他服務的手動停止，則會顯示此消息。在其他情況下，當網路管理員手動停止服務時，會顯示此消息。這裡的解決方案是從GUI或CLI手動啟動服務。

• NOTRUNNING：當服務發生錯誤且無法啟動時，會顯示此消息。有時，在嘗試手動啟動服務後會出現此消息。第一次嘗試是手動啟動服務，但是如果此操作不起作用，則需要執行後續故障排除步驟。使用本指南幫助您解決服務未啟動的問題。

服務仍處於啟動狀態

在重新啟動後，在IM&P訂閱伺服器上發現的最常見問題之一就是檢視幾乎所有處於STARTING狀態的服務，而IM&P發佈伺服器將所有服務顯示為STARTED。

此行為的常見原因是在高可用性(HA)尚未從狀態冗餘組禁用時重新啟動IM&P訂戶。

解決方案

步驟1.從線上狀態冗餘組禁用高可用性，導航到CUCM管理頁面>系統。

步驟2.在兩個IM&P節點上運行下一個命令：set replication-sync monitor disable。

步驟3.等待約5分鐘，然後再次運行下一個命令：utils service list，確認服務現在已啟動。

步驟4.驗證訂閱伺服器上所有服務都已啟動，然後在兩個IM&P節點上運行下一個命令：set replication-sync monitor enable。

步驟5.從線上狀態冗餘組重新啟用高可用性。

特定服務未啟動

網路服務

雖然不常見，但有時某些網路服務不會在IM&P發佈伺服器上啟動，這些情況包括：

• 思科使用者端設定檔代理
• 思科可擴充通訊平台(XCP)路由器
• Cisco XCP組態管理員
• 思科路由和狀態資料儲存庫

警告:XCP、線上狀態引擎和SIP代理服務無法啟動，因為這些服務取決於列出的網路服務。這會導致即時消息資料庫(IMDB)不複製，並且Jabber使用者無法登入。

解決方案

服務可以通過Web介面啟動(導航到IM and Presence Serviceability > Tools > Control Center - Network Services > Look for the IM and Presence Services)，也可以通過命令列介面(CLI)啟動，使用utils service start <name_of_the_service>命令。

步驟1.從線上狀態冗餘組禁用高可用性。

步驟2.嚴格按照以下順序手動啟動每項服務：

• 思科使用者端設定檔代理
• Cisco Route Datastore
• Cisco Presence Datastore
• Cisco XCP組態管理員
• Cisco XCP路由器

附註：要啟動Cisco Client Profile Agent，需要啟動Cisco Tomcat服務。

如果上述步驟不起作用，則需要開啟思科技術助理中心(TAC)案例，以進行進一步的疑難排解。請記住，需要和後續輸出和日誌。

1. CLI輸出：
• show network cluster
• 實用工具dbremote runtimestate
• utils ha狀態
• utils core active list
• utils service list
2. 日誌/跟蹤：
• 思科系統日誌代理
• 事件檢視器 — 應用程式日誌
• 事件檢視器 — 系統日誌
• 服務中任何仍然停止的跟蹤

思科資料庫(DB)

這是系統內的主要服務之一。

警告：如果此服務不啟動，伺服器將無法訪問伺服器網頁上的某些功能，Jabber使用者及其功能受到損害，資料庫複製被破壞。

原因：

發現此問題的最常見原因如下：

• 更改主機名、IP地址或域，但不執行Cisco准則流程。
• 在不正常關閉系統後損壞檔案。

解決方案：

遺憾的是，如果不啟動此服務，則沒有直接的解決步驟。建議如下：

步驟1.從線上狀態冗餘組禁用高可用性。

步驟2.重新啟動Cisco DB Replicator。

步驟3.重啟Cisco DB（如果它仍然處於STARTING狀態），請嘗試停止它，然後啟動它。

這裡的最佳方法是聯絡Cisco TAC進行進一步調查，並需要以下資訊：

1. CLI輸出：
• show tech network host
• show tech database dump
• show tech dbintegrity
• utils建立報告資料庫
• 利用網路連線IM&P_node 1500
• 顯示網路群集
• utils core active list
2. 日誌或跟蹤：
• 思科資料庫層監控器
• 思科資料庫庫跟蹤
• 思科資料庫通知服務
• Cisco Database Replicator跟蹤
• Cisco Informix Database Service
• 思科系統日誌代理
• 事件檢視器 — 應用程式日誌
• 事件檢視器 — 系統日誌

思科叢集間同步代理(ICSA)

警告：如果此服務未啟動，則無法跨IM&P節點和IM&P群集（群集間對等）同步IM&P資料庫。

解決方案：

1. 高可用性處於不良（或錯誤）狀態，它不允許服務啟動。

步驟1。您需要停用HA，啟動服務，然後重新啟用HA。

• 伺服器受以下兩個缺陷之一的影響：
  • 思科錯誤ID CSCvj09515
  • 思科錯誤ID CSCvq63308  

如果服務沒有啟動，則需要開啟TAC案例以進行進一步的故障排除。請記住，需要後續輸出和日誌。

1. CLI輸出
• show network cluster
• 實用工具dbremote runtimestate
• utils ha狀態
• utils core active list
• utils service list
2. 日誌/跟蹤
• 思科系統日誌代理
• 事件檢視器 — 應用程式日誌
• 事件檢視器 — 系統日誌
• 思科服務復原管理員
• 思科集群間同步代理服務

狀態引擎

對於Cisco Presence Engine服務，必須考慮多個變體，以便瞭解該服務為何不啟動以及如何啟動。

1. 開啟CLI並運行命令： utils service list驗證下一個服務是否處於running狀態，如果沒有，則需要先啟動這些服務：
• Cisco Presence Datastore
• Cisco SIP代理
• Cisco XCP路由器
• 思科同步代理

2.思科線上狀態引擎(PE)服務未在IM&P使用者中啟動的最常見原因是尚未將IM&P使用者新增到線上狀態冗餘組(PRG)中。

• 原因：PE服務與PRG關聯，需要新增才能啟動。
• 解決方案：將伺服器新增到PRG並等待約5分鐘，以檢視它是否啟動。
• 變體：在應用上述解決方案之後，PE可能在IM&P節點上停止，並且解決方案將執行以下步驟：

步驟1.將IM&P使用者保留在PRG中。

步驟2.從PRG禁用高可用性。

步驟3.後續步驟需要先在發佈伺服器上執行，然後再在訂閱伺服器上執行

步驟4.首先重新啟動Cisco SIP代理服務，等待其啟動。

步驟5.重新啟動Cisco PE服務，等待其啟動。

3.如果已將IM&P訂閱伺服器新增到PRG中，並且PE保持已停止或正在啟動狀態，這可能與兩個IM&P節點之間的資料庫複製不匹配有關，請運行下一個run sql select * from enterprisde node 命令。此查詢的輸出顯示了節點的id、節點的subclusterid（即PRG id）、name或IP地址以及其他值。您想要重點關注的就是，兩個IM&P節點共用相同的子集群id值。

• 原因：如果DB複製沒有正確執行，IM&P訂閱伺服器會將subclusterid顯示為NULL。
• 解決方案： 

步驟1。運行下一個命令：運行sql update enterprisenode set subclesterid=subclesterid_value_as_for_the_IM&P_Pub where id=IM&P_Sub_id

步驟2.重新運行下一命令從企業節點運行sql select * ，並確保subclusterid對於兩個IM&P節點都具有正確的值（相同）。服務必須在接下來的5分鐘內自行啟動，也可以嘗試手動啟動。

• 建議：開啟思科TAC案例以執行此變更。

4.如果在執行之前的故障排除後啟動所有服務（PE除外）：

• 解決方案：

步驟1.運行命令：在IM&P節點上均設定replication-sync monitor disable 。

步驟2.等待約5分鐘，如果未啟動，則嘗試手動啟動服務，運行下一個命令：utils service start Cisco Presence Engine。

步驟3.運行set replication-sync monitor enable 命令。

5.如果PE服務尚未啟動，請驗證伺服器是否正在運行12.5版，如果是，則極有可能受到思科錯誤ID CSCvg94247的影響。

思科同步代理

警告：如果此服務未啟動，則未完成從CUCM到IM&P的資料庫表的同步，這主要影響整個群集中的終端使用者同步。

解決方案：檢視下一個核對表。

1. 驗證CUCM和IM & Presence節點是否處於同一版本中。如果伺服器在11.X或更高版本中，則伺服器需要在相同的SU版本上運行。
• 如果它們不是，請確保兩者運行相同的版本。
2. 驗證CUCM上的Cisco AXL Web服務是否處於運行狀態。
• 如果不是，請啟動Cisco AXL Web Service。
3. 驗證IM&P節點是否列在CUCM上的伺服器清單中。
• 否則，需要重建IM&P伺服器。如果伺服器被新增回伺服器清單條目不起任何作用，因為每個新增的條目都會生成一個特定的ID，因此IM&P仍使用舊的ID。
4. 驗證IM&P上CUCM Publisher頁面上的故障排除器測試是否通過。
5. 驗證下一個統一資源定位器(URL)是否可以通過URL訪問：https://CUCM_OR_IM&P_FQDN_OR_IP
6. 嘗試重新啟動CUCM發佈程式，然後重新啟動IM&P發佈程式。
• 請記住，重新啟動前需要禁用HA。
7. 在IM&P發佈伺服器上運行下一個CLI查詢：從epassyncagentcfg運行sql select * 。
8. 確認顯示的ccmpublisherip地址來自CUCM發佈伺服器。
9. 在CUCM上運行下一個查詢：

run sql select applicationuser.pkid, applicationuser.name , credential.credentials from applicationuser inner join credential on applicationuser.pkid=credential.fkapplicationuser where credential.tkcredential=3 and applicationuser.name='axluser_displayed_from_epassyncagentcfg'

10. 驗證下一個資訊：
• username（在CUCM上） = axluser（在IM&P上）
• pkid（在CUCM上） = cucm_axluser_pkid（在IM&P上）
• 憑證（在CUCM上） = axlpassword（在IM&P上）

10. 如果在CUCM使用者清單中找不到epassyncagentcfg中的axluser，則在CUCM端建立一個新的應用程式使用者，該使用者與使用先前密碼的舊axluser相同（如果已知）。

如果上述操作無助於解決問題，則需要聯絡Cisco TAC進行進一步的故障排除。請記住，需要後續輸出和日誌。

CLI輸出（來自CUCM Publisher和IM&P）：

• 顯示網路群集
• 實用程式複製運行時間狀態
• Utils ha狀態
• 使用核心活動清單
• Utils服務清單
• 從epassyncagentcfg運行sql select *（僅限於IM&P）
• 運行sql select applicationuser.pkid、applicationuser.name、credential.credentials來自applicationuser.pkid=credential.fkapplicationuser上的applicationuser內部聯接憑據，其中credential.tkcredential=3和applicationuser.name='axluser_displayed_from_epassyncagentcfg'（僅位於CUCM上）

日誌/跟蹤：

• 思科系統日誌代理。
• 事件檢視器 — 應用程式日誌。
• 事件檢視器系統日誌。
• 思科同步代理。
• Cisco AXL Web服務。

Cisco XCP組態管理員

Cisco XCP配置管理器是處理IM&P伺服器中的所有XCP元件的主要服務。即使大部分XCP服務（包括XCP路由器）處於運行狀態，該服務也可能處於STOPPED狀態，使得XCP連線管理器、XCP Web服務管理器再次停止或甚至無法與Expressway（用於MRA）等其他伺服器同步。

首先，驗證Informix資料庫複製是否處於正確的狀態：

實用程式複製狀態

實用工具dbremote runtimestate

如果一切正常，則禁用高可用性並嘗試重新啟動服務（如果失敗），禁用同步監視功能：

set replication-sync monitor disable

然後，再次嘗試啟動服務。通過即時監控工具(RTMT)或CLI獲取Cisco XCP配置管理器日誌：

檔案檢視activelog /epas/trace/xcpconfigmgr/log4j/xcpconfigmgr.log

And this is the most common scenario:

2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - java.io.FileNotFoundException: /usr/local/platform/.security/CCMEncryption/keys/oldkeys.txt (No such file or directory)
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : decryptPassword - recovery mechanism failed
2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - javax.crypto.BadPaddingException: Error finalising cipher data: pad block corrupted
2024-12-11 14:20:52,195 INFO  [XCPConfigMgr] security.Log4jEncLogger - Entering decryptPassword
2024-12-11 14:20:52,196 INFO  [XCPConfigMgr] security.Log4jEncLogger - Use Dkey to decrypt data
2024-12-11 14:20:52,213 INFO  [Thread-12] dbl.Log4j - Name of appId:dbcli
2024-12-11 14:20:52,216 INFO  [Thread-12] dbl.Log4j - Name of appId:dbxcpconfig
2024-12-11 14:20:52,219 INFO  [Thread-12] dbl.Log4j - Name of appId:dbcli
2024-12-11 14:20:52,221 INFO  [Thread-12] dbl.Log4j - Name of appId:dbxcpconfig
2024-12-11 14:20:52,649 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : Dkey decryption failed. Use recovery mechanism to decrypt data.
2024-12-11 14:20:52,649 INFO  [XCPConfigMgr] security.Log4jEncLogger - Using static key to decrypt data
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - Exiting decryptPassword.fail
2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - Decryption with static key failed as well. Fatal error javax.crypto.BadPaddingException: Error finalising cipher data: pad block corrupted
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : static key decryption failed. Use old keys to decrypt data
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - Exiting DecryptPassword.fail. failed to read oldkey file

 如果是這種情況，您遇到了缺陷Cisco bug ID CSCur25679 XCP配置管理器和XCP服務不從IM&P啟動，您需要聯絡Cisco TAC以應用解決方法。

功能服務未啟動

除非您使用每個服務的功能，否則預設情況下會禁用下一個服務：

• Cisco XCP目錄服務
• Cisco XCP檔案傳輸管理員
• Cisco XCP消息存檔和Cisco XCP XMPP聯合

即使您的IM&P已啟用這些服務，除非為每個服務配置每個功能，否則服務不會啟動。

Cisco XCP目錄服務

Cisco XCP目錄服務支援將可擴展消息傳送和線上狀態協定(XMPP)客戶端與輕量級目錄訪問協定(LDAP)目錄整合，允許使用者從LDAP目錄搜尋和新增聯絡人。

要啟動此服務，請執行以下操作：

1.導航至Cisco Unified CM IM and Presence Administration > Application > Third-Party Clients。

2.配置第三方XMPP客戶端的設定。

您可以使用Cisco XCP目錄服務允許第三方XMPP客戶端的使用者從LDAP目錄搜尋和新增聯絡人。

有關配置第三方XMPP目錄的其他資訊，請參閱開啟Cisco XCP目錄服務。

思科檔案傳輸管理員

該服務允許您使用稱為管理檔案傳輸的伺服器端檔案傳輸解決方案。

託管檔案傳輸(MFT)允許IM and Presence Service客戶端（如Cisco Jabber）將檔案傳輸給其他使用者、臨時組、聊天和持續聊天。

如果MFT的配置未到位，則服務不會啟動。

有關配置第三方XMPP目錄的其他資訊，請參閱如何在CUCM IM/Presence 10.5中配置託管檔案傳輸？

Cisco XCP訊息存檔器

Cisco XCP Message Archiver服務支援IM Compliance功能。IM合規性功能會記錄傳送至IM and Presence Server和從IM and Presence Server傳送的所有消息，包括點對點消息，以及來自「聊天」功能的特定（臨時）和永久聊天室的消息。消息會記錄到思科支援的外部資料庫。

如果合規性配置未就位，則服務不會啟動。

有關如何配置消息歸檔的其他資訊，請參閱即時消息和線上狀態服務版本12.5(1)的即時消息合規性。

Cisco XCP XMPP聯盟連線管理員

Cisco XCP XMPP Federation Connection Manager支援通過XMPP協定與第三方企業(如國際商用機器(IBM)Lotus Sametime、Cisco Webex Meeting Center、GoogleTalk和另一個IM and Presence企業)進行域間聯合。

在配置XMPP聯合之前，此服務不會啟動。

有關如何配置消息歸檔的其他資訊，請參閱IM and Presence服務版本12.5(1)的Interdomain Federation Guide。

相關資訊

• 思科技術支援與下載