Inleiding
In dit document worden de stappen beschreven die moeten worden uitgevoerd wanneer een service van Cisco Instant Message and Presence (IM&P) niet start zoals verwacht.
Achtergrondinformatie
De staat van een dienst
De IM&P-services hebben de volgende staten:
begonnen
|
De service is actief en actief.
|
aanvang
|
De service bevindt zich in de overgang van Stop naar Started.
|
gestopt
|
De services worden niet gestart, dit kan zijn omdat deze handmatig wordt gestopt of omdat deze niet is geactiveerd.
|
stoppen
|
De service bevindt zich in de overgang van gestart naar gestopt.
|
Houd er rekening mee dat na het opnieuw opstarten van de IM & P-node de volgende waarschuwing wordt gegenereerd en kan worden gevonden op de grafische gebruikersinterface (GUI) als u naar de meldingspagina navigeert of via de opdrachtregelinterface (CLI):

De Cisco IM and Presence Data Monitor heeft vastgesteld dat de databasereplicatie niet is voltooid en/of dat de synchronisatie van de Cisco Sync Agent vanuit Cisco Unified Communications Manager niet is voltooid. Sommige services kunnen in de status "Starten" blijven totdat de replicatie en de synchronisatie met de Cisco Sync Agent zijn voltooid.
Het bericht betekent niet noodzakelijk dat de services in de starttoestand blijven staan omdat de waarschuwing is gegenereerd. Dit wordt verwacht als de IM&P Data Monitor beginnen met het bewaken van de diensten zodra de IM&P komt van een reboot of opstarten. Het eerste dat de monitorservice detecteert, is dat alle hoofdservices bezig zijn met starten, waardoor het bericht wordt geactiveerd.
Voer de opdracht Servicelijst van het hulpprogramma uit om de werkelijke status van de services te bevestigen.
Opmerking: als de services in de staat Gestart zijn, kunt u de waarschuwing verwijderen om de meldingsberichten schoon te houden.
Problemen oplossen
Identificeer het probleem
De eerste stap om problemen met de services op te lossen die niet worden gestart, is om te begrijpen welke services niet zijn gestart.
Het is belangrijk om de legenda te valideren die aan de rechterkant van de services wordt weergegeven die worden gestopt, meestal kunt u identificeren:
- Service niet geactiveerd: Dit betekent dat de service van de functie niet is geactiveerd en dat moet eerst worden gedaan.

- Opgegeven buiten dienst: Dit bericht wordt weergegeven na het opnieuw opstarten van de server en als HA niet is uitgeschakeld of als bepaalde services opnieuw zijn gestart en die actie de handmatige stopzetting van andere services heeft veroorzaakt. In andere scenario's wordt dit bericht weergegeven wanneer de netwerkbeheerder de service handmatig stopt. De oplossing hier is om de services handmatig te starten vanaf de GUI of CLI.

- NIET ACTIEF: Dit bericht wordt weergegeven wanneer er een fout is opgetreden bij de services en kan niet worden gestart. Soms wordt dit bericht weergegeven nadat de service handmatig is gestart. De eerste poging is om de service handmatig te starten, maar als deze actie niet werkt, moeten de volgende stappen voor probleemoplossing worden uitgevoerd. Gebruik deze handleiding om de services op te lossen die niet worden gestart.

Services blijven in begintoestand
Een van de meest voorkomende problemen die worden gevonden op de IM & P-abonnee na een herstart is om bijna alle diensten te zien in START-status, terwijl de IM & P-uitgever alle diensten toont als GESTART.
De gemeenschappelijke oorzaak van dit gedrag wordt gegeven door een herstart van de IM & P-abonnee wanneer de High Availability (HA) niet is uitgeschakeld in de Presence Redundancy Groups.
Oplossing
Stap 1. Schakel de High Availability uit vanuit de Presence Redundancy Groups en navigeer naar de CUCM-beheerpagina > Systeem.
Stap 2. Voer de volgende opdracht uit op beide IM&P-knooppunten: stel replicatie-synchronisatie monitor uitschakelen in.
Stap 3. Wacht ongeveer 5 minuten en voer de volgende opdracht uit: gebruik de servicelijst opnieuw om te bevestigen dat de services nu zijn gestart.
Stap 4. Controleer of alle services zijn GESTART op de abonnee en voer vervolgens de volgende opdracht uit op beide IM&P-knooppunten: stel replicatie-synchronisatiemonitor in.
Stap 5. Schakel de High Availability opnieuw in vanuit de Presence Redundancy Groups.
Specifieke services worden niet gestart
Netwerkservices
Hoewel ongewoon, zijn er scenario's geweest waarbij sommige netwerkservices niet starten op de IM & P-uitgever, dit zijn:
- Cisco Client Profile Agent
- XCP-router (Cisco Extensible Communications Platform)
- Cisco XCP Config Manager
- Cisco Route en Aanwezigheid Datastores
Waarschuwing: de XCP-, Presence Engine- en SIP Proxy-services kunnen niet worden gestart, omdat deze afhankelijk zijn van de vermelde netwerkservices. Hierdoor wordt de Instant Message Database (IMDB) niet gerepliceerd en kunnen de Jabber-gebruikers zich niet aanmelden.
Oplossing
De services kunnen worden gestart via de webinterface (Navigeer naar IM en Presence Serviceability > Tools > Control Center - Network Services > Zoeken naar de IM- en Presence Services) of via de Command Line Interface (CLI), gebruik de opdracht service start <name_of_the_service>.
Stap 1. Schakel de optie Hoge beschikbaarheid uit vanuit de groepen voor aanwezigheidsredundantie.
Stap 2. Start elke service strikt handmatig in de volgende volgorde:
- Cisco Client Profile Agent
- Cisco Route Datastore
- Cisco Presence Datastore
- Cisco XCP Config Manager
- Cisco XCP Router
Opmerking: Als u de Cisco Client Profile Agent wilt starten, moet de Cisco Tomcat-service worden gestart.
Als de vorige stappen niet hebben gewerkt, moet een geval van Cisco Technical Assistant Center (TAC) worden geopend voor verdere probleemoplossing. Houd er rekening mee dat de volgende uitgangen en logs vereist zijn en worden weergegeven.
- CLI-uitgangen:
- Netwerkcluster weergeven
- UTILS-duplicatie runtimestatus
- Utils HA-status
- actieve lijst van de Utils-kern
- utils service list
- Logboeken/sporen:
- Cisco Syslog Agent
- Logboeken – Toepassingslogboek
- Logboeken – Systeemlogboek
- Alle sporen van de diensten die nog steeds gestopt zijn
Cisco-database (DB)
Dit is een van de belangrijkste diensten binnen het systeem.
Waarschuwing: als deze service niet wordt gestart, kan de server geen toegang krijgen tot bepaalde functies op de webpagina van de server, worden Jabber-gebruikers en hun functies gecompromitteerd, wordt de DB-replicatie verbroken.
Oorzaken:
De meest voorkomende oorzaken van dit probleem zijn:
- Wijziging van de hostnaam, het IP-adres of het domein zonder het proces van Cisco-richtlijnen.
- Corruptie van de bestanden na een onsierlijke uitschakeling van het systeem.
Oplossing:
Helaas zijn er geen eenvoudige stappen als deze service niet wordt gestart. De suggesties zijn:
Stap 1. Schakel de optie Hoge beschikbaarheid uit vanuit de groepen voor aanwezigheidsredundantie.
Stap 2. Start een Cisco DB-replicator opnieuw op.
Stap 3. Start een Cisco DB opnieuw op als deze in de STATUS START blijft, probeer deze te stoppen en start deze vervolgens op.
De beste aanpak hier is om Cisco TAC in te schakelen voor verder onderzoek, en de volgende informatie is vereist:
- CLI-uitgangen:
- Toon technische netwerkhosts
- Tech Database-dump weergeven
- Toon technische integriteit
- Hulpprogramma's Rapportdatabase maken
- Netwerkconnectiviteit IM&P_node 1500
- Netwerkcluster weergeven
- actieve lijst van de Utils-kern
- Logboeken of sporen:
- Cisco Database Layer Monitor
- Cisco Database Library Trace
- Cisco Database Notification Service
- Cisco Database Replicator Trace
- Cisco Informix Database Service
- Cisco Syslog Agent
- Logboeken – Toepassingslogboek
- Logboeken – Systeemlogboek
Cisco Intercluster Sync Agent (ICSA)
Waarschuwing: als deze service niet wordt gestart, kan de IM&P-database niet worden gesynchroniseerd tussen de IM&P-knooppunten en IM&P-clusters (interclusterpeering).
Oplossing:
- De High Availability bevindt zich in een slechte (of verkeerde) staat en laat de service niet toe.
Stap 1. U moet de HA uitschakelen, de service starten en de HA opnieuw inschakelen.
- Server wordt beïnvloed door een van deze twee defecten:
Als de service niet beschikbaar is, moet een TAC-zaak worden geopend voor verdere probleemoplossing. Houd er rekening mee dat de volgende uitgangen en logs nodig zijn.
- CLI-uitgangen
- Netwerkcluster weergeven
- UTILS-duplicatie runtimestatus
- Utils HA-status
- actieve lijst van de Utils-kern
- utils service list
- Logboeken/sporen
- Cisco Syslog Agent
- Logboeken – Toepassingslogboek
- Logboeken – Systeemlogboek
- Cisco Service Recovery Manager
- Cisco Intercluster Sync Agent-service
aanwezigheidsengine
Voor de Cisco Presence Engine-service zijn er verschillende varianten waarmee rekening moet worden gehouden om te begrijpen waarom de service niet wordt gestart en hoe deze moet worden gestart.
- Open een CLI en voer de opdracht uit: hulpprogramma's in de servicelijst valideren dat de volgende services in de actieve staat zijn, als dat niet het geval is, moeten ze eerst worden gestart:
- Cisco Presence Datastore
- Cisco SIP-proxy
- Cisco XCP Router
- Cisco Sync Agent
2. De meest voorkomende reden waarom de Cisco Presence Engine (PE)-service niet start in de IM&P-abonnee, is omdat de IM&P-abonnee niet is toegevoegd aan de aanwezigheidsredundantiegroep (PRG).
- Reden: De PE-service is gekoppeld aan de PRG en moet worden toegevoegd om te starten.
- Oplossing: voeg de server toe aan de PRG en wacht ongeveer 5 minuten om te zien of deze wordt gestart.
- Varianten: Het is waarschijnlijk dat nadat de vorige oplossing is toegepast, de PE stopt op beide IM & P-knooppunten, en de oplossing is om de volgende stappen uit te voeren:
Stap 1. Bewaar de IM&P-abonnee in de PRG.
Stap 2. Schakel hoge beschikbaarheid uit vanaf de PRG.
Stap 3: de volgende stappen moeten eerst worden uitgevoerd op de uitgever en vervolgens op de abonnee
Stap 4. Start eerst de Cisco SIP Proxy Service opnieuw op en wacht tot deze is gestart.
Stap 5. Start de Cisco PE-service opnieuw op en wacht tot deze is gestart.
3. Als de IM&P-abonnee al is toegevoegd aan de PRG en de PE in de status STOPPED of START blijft, die gerelateerd kan zijn aan een mismatch in de databasereplicatie tussen de twee IM&P-knooppunten, voert u de volgende opdracht uit om SQL select * uit te voeren vanaf de enterprise node. De uitvoer van deze query geeft de id van de node, de subclusterid van de node (de PRG-id), de naam of het IP-adres en andere waarden weer. Waar u zich op wilt concentreren, is dat beide IM & P-knooppunten dezelfde subclusterid-waarde delen.
- Reden: Als de DB-replicatie niet correct is uitgevoerd, geeft de IM&P-abonnee de subclusterid weer als NULL.
- Oplossing:
Stap 1. Voer de volgende opdracht uit: voer SQL update enterpriseCode set subclesterid=subclesterid_value_as_for_the_IM&P_Pub uit waarbij id=IM&P_Sub_id
Stap 2. Voer de volgende opdracht SQL select * opnieuw uit vanaf de enterprise node en zorg ervoor dat de subclusterid de juiste waarde (hetzelfde) heeft voor beide IM&P-nodes. De service moet in de komende 5 minuten vanzelf beginnen, of u kunt proberen deze handmatig te starten.
- Aanbeveling: Open een Cisco TAC-case om deze wijziging uit te voeren.
4. Als na de vorige probleemoplossing alle services zijn gestart, met uitzondering van de PE:
Stap 1. Voer de opdracht uit: stel replicatie-synchronisatiecontrole in en schakel deze uit op beide IM&P-nodes.
Stap 2. Wacht ongeveer 5 minuten en als de service niet is gestart, probeert u de service handmatig te starten en voert u de volgende opdracht uit: service start Cisco Presence Engine.
Stap 3. Voer de optie Replicatie-synchronisatie-monitor van de opdrachtset in.
5. Als de PE-service nog niet kan worden gestart, moet u controleren of de server versie 12.5 uitvoert, als dat het geval is, is het zeer waarschijnlijk dat de Cisco-bug-ID CSCvg94247 van invloed is.
Cisco Sync Agent
Waarschuwing: als deze service niet wordt gestart, is de synchronisatie van DB-tabellen van CUCM naar IM&P niet voltooid, wat voornamelijk gevolgen heeft voor de synchronisatie van de eindgebruiker in het cluster.
Oplossing: bekijk de volgende checklist.
- Controleer of beide CUCM- en IM & Presence-knooppunten in dezelfde versie zijn. Als de servers zich in versie 11.X of hoger bevinden, moeten de servers op dezelfde SU-versie worden uitgevoerd.
- Als dat niet het geval is, zorg er dan voor dat beide dezelfde versie draaien.
- Controleer of de Cisco AXL Web Service op CUCM in de status RUNNING is.
- Als dit niet het geval is, start u de Cisco AXL Web Service.
- Controleer of de IM&P-node wordt vermeld in de serverlijst op CUCM.
- Als dit niet het geval is, moet de IM&P-server opnieuw worden gemaakt. Als de server wordt toegevoegd aan de serverlijst, heeft het item geen effect, omdat een specifieke ID wordt gegenereerd voor elk item dat wordt toegevoegd, dus de IM&P blijft met een oude id.
- Controleer of de tests voor probleemoplossers op de pagina CUCM Publisher op IM&P zijn geslaagd.
- Controleer of de volgende Uniform Resource Locator (URL) bereikbaar is met de URL: https://CUCM_OR_IM&P_FQDN_OR_IP
- Probeer de CUCM-uitgever en vervolgens de IM&P-uitgever opnieuw op te starten.
- Houd er rekening mee dat HA moet worden uitgeschakeld voordat opnieuw wordt opgestart.
- Voer de volgende CLI-query uit op de IM&P-uitgever: voer sql select * uit vanaf epassyncagentcfg .
- Bevestig dat het computeradres wordt weergegeven in de CUCM-uitgever.
- Voer de volgende query uit op de 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'
- De volgende informatie valideren:
- gebruikersnaam (op CUCM) = axluser (op IM&P)
- pkid (Op CUCM) = cucm_axluser_pkid (Op IM&P)
- inloggegevens (op CUCM) = axlpassword (op IM&P)
- Als de axluser in epassyncagentcfg niet kan worden gevonden in de gebruikerslijst van de CUCM, maakt u een nieuwe toepassingsgebruiker aan de CUCM-zijde op dezelfde manier als de oude axluser met het vorige wachtwoord, indien bekend.
Als de vorige acties niet helpen om het probleem op te lossen, moet u Cisco TAC inschakelen voor verdere probleemoplossing. Houd er rekening mee dat de volgende uitgangen en logs nodig zijn.
CLI-uitgangen (van CUCM Publisher en IM&P):
- Netwerkcluster weergeven
- Utils-duplicatie runtimestate
- Utils ha status
- Actieve lijst met hulpprogramma's
- utils service list
- Voer SQL select * uit vanaf epassyncagentcfg (alleen op de IM&P)
- Voer sql select applicationuser.pkid, applicationuser.name, credential.credentials uit applicationuser.inner join credential uit op applicationuser.pkid=credential.fkapplicationuser waarbij credential.tkcredential=3 en applicationuser.name='axluser_displayed_from_epassyncagentcfg' (Alleen op de CUCM)
Logboeken/sporen:
- Cisco Syslog Agent.
- Logboeken – Toepassingslogboek.
- Logboeken – Systeemlogboek.
- Cisco Sync Agent.
- Cisco AXL Web Service.
Cisco XCP Config Manager
De Cisco XCP Config Manager is een hoofdservice die alle XCP-componenten binnen de IM&P-server verwerkt. Hoewel de meeste XCP-services, waaronder de XCP-router, in de status RUNNING zijn, kan deze service in de status STOPGEZET worden, waardoor de XCP Connection Manager, XCP Web Service Manager wordt gestopt of zelfs niet kan worden gesynchroniseerd met andere servers zoals de Expressways (voor MRA).
Controleer eerst of de Replicatie van de Informix-database in de juiste staat is:
UTILS-duplicatiestatus
UTILS-duplicatie runtimestatus
Als alles in orde is, schakel dan de High Availability uit en probeer de service opnieuw op te starten, als dat mislukt, schakel de synchronisatiebewakingsfunctie uit:
Replicatie-synchronisatie-monitor instellen Uitschakelen
Probeer vervolgens opnieuw de service te starten. De logbestanden van Cisco XCP Config Manager ophalen via Real-Time Monitor Tool (RTMT) of CLI:
Bestand bekijken 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
Als dat het geval is, raakt u het defect Cisco bug ID CSCur25679
XCP Config Manager en XCP Services starten niet op IM&P en u moet contact opnemen met Cisco TAC om de tijdelijke oplossing toe te passen.
Functieservices worden niet gestart
De volgende services zijn standaard uitgeschakeld, tenzij u de functie van elke service gebruikt:
- Cisco XCP Directory Service
- Cisco XCP File Transfer Manager
- Cisco XCP Message Archives en Cisco XCP XMPP Federation
Hoewel uw IM&P deze services heeft geactiveerd, worden de services niet gestart, tenzij u elke functie voor elke service configureert.
Cisco XCP Directory Service
De Cisco XCP Directory Service ondersteunt de integratie van XMPP-clients (Extensible Messaging and Presence Protocol) met de LDAP-directory (Lightweight Directory Access Protocol), zodat gebruikers contactpersonen uit de LDAP-directory kunnen zoeken en toevoegen.
Om deze service te starten:
1. Navigeer naar Cisco Unified CM IM and Presence Administration > Toepassing > Externe clients.
2. Instellingen configureren voor XMPP-clients van derden.
U gebruikt de Cisco XCP Directory Service om gebruikers van een XMPP-client van een derde partij in staat te stellen contactpersonen uit de LDAP-directory te zoeken en toe te voegen.
Raadpleeg Cisco XCP Directory Service inschakelen voor aanvullende informatie over het configureren van de XMPP-directory van derden.
Cisco File Transfer Manager
Met deze service kunt u een oplossing voor bestandsoverdracht aan de serverzijde gebruiken, genaamd beheerde bestandsoverdracht.
Met Managed File Transfer (MFT) kan een IM- en Presence Service-client, zoals Cisco Jabber, bestanden overbrengen naar andere gebruikers, ad-hocgroepen, chats en permanente chat.
De service wordt niet gestart als de configuratie voor MFT niet aanwezig is.
Zie voor aanvullende informatie over het configureren van de XMPP-directory van derden Hoe kunt u beheerde bestandsoverdracht configureren in CUCM IM/Presence 10.5?
Cisco XCP Message Archiver
De Cisco XCP Message Archiver-service ondersteunt de functie IM Compliance. De functie IM Compliance registreert alle berichten die naar en van de IM- en aanwezigheidsserver worden verzonden, waaronder point-to-point-berichten en berichten van ad-hoc (tijdelijke) en permanente chatrooms voor de chatfunctie. Berichten worden vastgelegd in een externe database die door Cisco wordt ondersteund.
De service wordt niet gestart als de configuratie voor naleving niet aanwezig is.
Raadpleeg Instant Messaging Compliance voor de IM- en aanwezigheidsservice, versie 12.5(1) voor meer informatie over het configureren van het berichtenarchief.
Cisco XCP XMPP Federation Connection Manager
De Cisco XCP Federation Connection Manager ondersteunt interdomeinfederatie met externe bedrijven zoals International Business Machines (IBM) Lotus Sametime, Cisco Webex Meeting Center, GoogleTalk en een andere IM- en Presence-onderneming via het XMPP-protocol.
Deze service wordt pas gestart nadat de XMPP-federatie is geconfigureerd.
Voor meer informatie over het configureren van Berichtenarchief raadpleegt u de Interdomain Federation Guide voor de IM- en aanwezigheidsservice, versie 12.5(1).
Gerelateerde informatie