In questo documento viene descritto come procedere quando si verifica uno di questi problemi con gli agenti di un ambiente Cisco IP Contact Center (IPCC) Express:
Gli agenti Cisco Agent Desktop (CAD) che sono connessi ed elaborano le chiamate probabilmente non vengono visualizzati in Cisco Supervisor Desktop (CSD).
Gli agenti CAD vengono visualizzati in CSD ma scompaiono rapidamente.
Gli agenti CAD non sono in grado di comunicare con gli utenti CSD.
I messaggi vengono visualizzati nei registri del Visualizzatore eventi sul server UCCX. Questo è un esempio:
Event Type: Warning Event Source: FCCServer Event Category: None Event ID: 3 Date: 1/21/2010 Time: 2:01:52 PM User: N/A Computer: TACUCCX1 Description: FCCS3008 Network communication error <COMM_FAILURE> sending message to application <Agent1>. The application will be logged out.
Questo documento è utile per conoscere i seguenti argomenti:
Soluzioni Cisco Customer Response (CRS)
Cisco Agent Desktop
Cisco Supervisor Desktop
Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:
Cisco CRS versione 3.x e successive
Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.
Per ulteriori informazioni sulle convenzioni usate, consultare il documento Cisco sulle convenzioni nei suggerimenti tecnici.
Gli agenti Cisco Agent Desktop (CAD) che sono connessi ed elaborano le chiamate probabilmente non vengono visualizzati in Cisco Supervisor Desktop (CSD).
Gli agenti CAD vengono visualizzati in CSD ma scompaiono rapidamente.
Gli agenti CAD non sono in grado di comunicare con gli utenti CSD.
I messaggi vengono visualizzati nei registri del Visualizzatore eventi sul server UCCX:
Event Type: Warning Event Source: FCCServer Event Category: None Event ID: 3 Date: 1/21/2010 Time: 2:01:52 PM User: N/A Computer: TACUCCX1 Description: FCCS3008 Network communication error <COMM_FAILURE> sending message to application <Agent1>. The application will be logged out.
CAD e CSD utilizzano un protocollo di chat proprietario per comunicare gli stati degli agenti e i messaggi di chat in un'architettura client-server. Questi messaggi vengono inviati e ricevuti dal servizio Cisco Desktop Chat sul server UCCX e distribuiti agli utenti CAD e CSD secondo necessità. Se il servizio Cisco Desktop Chat non è in grado di stabilire una connessione con le applicazioni CAD e/o CSD sulle porte utilizzate da questo protocollo, i sintomi precedenti sono i risultati.
Affinché il protocollo Chat funzioni correttamente, è necessario che queste porte siano aperte durante il percorso di transito:
UCCX Server - TCP 5900
CAD - TCP 59020
CSD - TCP 59021
CAD (59020) — (59000) UCCX Server (59000) — (59021) CSD
Per risolvere il problema, completare i seguenti passaggi:
Se CAD è installato in un ambiente Citrix o Microsoft Terminal Services, verificare che l'utilità PostInstall.exe sia configurata per questo tipo di distribuzione. Attenersi alla seguente procedura:
Sul server Citrix o MTS, aprire Programmi > Cisco > Desktop > bin > PostInstall.exe.
Confermare che gli indirizzi IP visualizzati siano quelli dei server UCCX.
Nel pannello sinistro, scegliete Ambiente thin client.
Scegliete Sì nel pannello a destra.
Fare clic su Apply (Applica).
Riavviate tutte le varianti CAD e CSD.
Se la versione UCCX è 7.0(1), verificare che nell'applicazione CAD non sia presente l'ID bug Cisco CSCtd75811 (solo utenti registrati).
In presenza di questi sintomi, aprire Task Manager di Windows sul PC desktop di Cisco Agent.
Fare clic sulla scheda Processi.
Selezionare la casella Mostra processi di tutti gli utenti.
Ordina l'elenco dei processi per Nome immagine.
Se sono presenti più istanze di agent.exe, aggiornare UCCX a una versione contenente la correzione all'ID bug Cisco CSCtd75811 (solo utenti registrati).
Se la versione di UCCX è 7.0(1), verificare che il percorso di sistema includa WebAdminLib.dll. A tale scopo, scegliere Web CDA > Configurazione servizi > Dati organizzazione > Campi. Se viene restituito questo errore, completare la soluzione indicata nella Guida alla risoluzione dei problemi CAD:
CDAUI1000 Error while trying to load data. Ensure that the system path includes the location of the WebAdminLib.dll.
Verificare che l'agente sia assegnato al team corretto in Web CDA > Personale > Agenti. Gli agenti possono apparire assegnati a team diversi in Web CDA rispetto ad AppAdmin perché i servizi directory non sono sincronizzati. Sincronizzare manualmente i servizi directory da CDA Web > Configurazione servizi o riavviare il servizio di sincronizzazione di Cisco Desktop da AppAdmin Control Center.
Verificare che tutti i servizi Desktop siano in esecuzione in AppAdmin Control Center. Se uno di questi servizi viene visualizzato in stato Arrestato, Servizio parziale o Non valido, contattare il Technical Assistance Center (TAC) di Cisco per assistenza. Elenco dei servizi che devono essere in esecuzione:
Servizio Cisco Desktop Call/Chat
Cisco Desktop Enterprise Service
Servizio di monitoraggio LDAP di Cisco Desktop
Servizio Cisco Desktop License and Resource Manager
Servizio Cisco Browser and IP Phone Agent - se si utilizza CAD-BE o IPPA
Servizio di registrazione e statistica desktop Cisco
Cisco Desktop Sync Service
Verificare la connettività tra il server UCCX e CAD e il server UCCX e CSD sulle porte indicate in precedenza.
Sul server UCCX, aprire una finestra del prompt dei comandi.
Avviare l'applicazione CAD o CSD sul PC client.
Utilizzare i seguenti comandi e sostituire gli indirizzi IP corretti:
Telnet <CSD IP Address> 59021 Telnet <CAD IP Address> 59020
Nota: un messaggio di errore viene visualizzato nella finestra del prompt dei comandi.
Connecting to 192.168.xxx.xxx Could not open a connection to host on port 59000:Connect failed
Se non viene ricevuto alcun messaggio di errore, verificare la connettività dal CSD e dai PC CAD al server UCCX.
Nel PC CAD o CSD aprire una finestra del prompt dei comandi.
Utilizzare questo comando e sostituire l'indirizzo IP corretto del server UCCX master:
Telnet <UCCX IP Address> 59000
Se non viene ricevuto alcun messaggio di errore, monitorare la connessione Telnet aperta quando vengono visualizzati questi sintomi.
Se viene visualizzato un messaggio di errore immediatamente o durante il monitoraggio della connessione Telnet aperta, esaminare quanto segue:
Se sul PC CAD o CSD è in esecuzione un software antivirus, disattivarlo includendo la scansione in tempo reale, se applicabile.
Se Windows Firewall è attivato, disattivarlo nella sezione Windows Firewall del Pannello di controllo.
Verificare che le porte indicate non siano bloccate tramite Criteri di gruppo.
Verificare che tutti i firewall di rete nel percorso di transito consentano il traffico sulle porte menzionate in precedenza.
Se CAD e CSD sono raggiungibili solo su VPN, verificare che l'headend VPN e tutti gli altri dispositivi di sicurezza consentano il traffico sulle porte menzionate.
Verificare che Cisco Security Agent (CSA) non blocchi le porte menzionate in precedenza, se è installato.
Verificare che le porte di rete nel percorso di transito non contengano errori.
Se il PC CAD o CSD dispone di più NIC e indirizzi IP, disattivare la NIC inutilizzata.
Verificare che nessuna applicazione di terze parti sul PC CAD o CSD sia in conflitto con il software UCCX e impedire la comunicazione sulle porte menzionate in precedenza. Attenersi alla procedura seguente:
A tale scopo, creare un PC di prova con la versione di base del sistema operativo installata, ad esempio Windows Vista, XP e così via. Evitare l'utilizzo di un'immagine aziendale preconfezionata.
Installare solo CAD o CSD nel PC di prova.
Verificare l'esistenza dei sintomi precedentemente indicati.
In caso contrario, aggiungere ogni applicazione del PC di produzione al PC di prova in modo incrementale e verificare la funzionalità CAD e CSD tra ogni installazione.
A intermittenza l'agente inizia a scomparire e a comparire sul desktop del Supervisor nel rapporto sullo stato di Team Agent.
Questo problema si verifica quando più thread non vengono chiusi correttamente in Agent Desktop PC. Quando la comunicazione CHAT sulle porte TCP 5900 e 59020 tra il client e il server è stata persa a causa di interruzione/interruzione della rete. CAD non è in grado di eseguire il ripristino e crea più istanze di Agent.exe.
Uscire dall'applicazione Cisco Agent Desktop interessata e avviare nuovamente CAD.
Nel log PIM è presente un messaggio PERERR_CM_REDIRECT_CALL_UNKNOWN_DESTINATION. Questo si verifica quando l'agente non riceve la chiamata e la chiamata torna in coda, l'agente diventa non pronto e viene visualizzato il messaggio di errore Operazione richiesta non riuscita.
Per risolvere il problema, completare i seguenti passaggi:
Impostare FilterOutRecoveryOnTimerExpiry su 1 e riavviare i servizi sul server PG in questo percorso:
HKLM\SOFTWARE\Cisco Systems, Inc.\icm\<instance name>\PG1A\PG\CurrentVersion\JGWS\jgw1\JGWData\Dynamic
Impostare il timeout cvp con questo parametro: setRnaTimeOut *:15
Durante lo spostamento tra le diverse pagine di Cisco Desktop Administrator, viene visualizzato uno dei seguenti errori:
CDAUI1000 Error while trying to load data. Ensure that the system path includes the location of the WebAdminLib.dll
O
The requested resource () is not available.
Per risolvere il problema, completare i seguenti passaggi:
Nel Pannello di controllo, avviare l'utilità di sistema.
Nella scheda Avanzate fare clic su Variabili di ambiente.
Dall'elenco delle variabili di sistema, scegliere Percorso, quindi fare clic su Modifica.
Nel campo del valore della variabile, individuare la stringa C:\Program Files\Cisco\Desktop\bin. Tagliare e incollare per spostarlo all'inizio della stringa del valore della variabile. In questo modo si otterrà la DLL a cui si accede dalla posizione corretta.
Fare clic su OK e chiudere Utilità di sistema.
Arrestare Cisco Unified Node Manager.
Sul server Unified CCX, eliminare la cartella teamadmin dai seguenti percorsi:
C:\Program Files\wfavvid\tomcat_appadmin\webapps
C:\Program Files\wfavvid\tomcat_appadmin\work\catalina\localhost
Riavviare Unified Node Manager e attendere due minuti.
Nota: dopo aver completato questi passaggi, dovrebbe essere possibile accedere a Cisco Desktop Administrator e passare alle diverse pagine.
Non è possibile visualizzare tutti gli agenti nella schermata di monitoraggio e nel registro viene visualizzato questo messaggio di errore:
2010-09-24 07:37:44.404 DEBUG [0xeec] FCCClientAPI::corbaInit: This client is not running in Citrix/MTS mode. A static port number will be used. 2010-09-24 07:37:44.388 DEBUG [0xeec] FCCClientAPI::corbaInit: Unable to open registry:HKEY_LOCAL_MACHINE\SOFTWARE\Spanlink\CAD\Chat Server API\Setup.Looking in LDAP.
Questo problema è documentato nell'ID bug Cisco CSCsa1971 (solo utenti registrati).
Completare questa procedura per impostare la chiave del Registro di sistema sul server Citrix e risolvere questo errore:
Scegliere Start > Esegui e digitare regedit.
Creare la chiave del Registro di sistema: HKEY_LOCAL_MACHINE\SOFTWARE\Spanlink\Chat Server API\Setup.
In tale chiave, creare un valore DWORD denominato OmniOrbUsePort.
Impostare il valore su 0.
Riavviare il server Citrix.
Gli agenti che si trovano in CSD dipendono dalla comunicazione del software. Il software CAD comunica a CSD il proprio stato tramite UCCX. Se la comunicazione si interrompe in un punto qualsiasi del percorso di comunicazione, completare i seguenti passaggi per risolvere il problema:
Nota: questo problema può verificarsi perché la sincronizzazione viene interrotta perché il CSD non visualizza alcun servizio dopo aver scelto il team.
Arrestare Gestione nodi.
Riavviare la gestione CTI in tutto Cisco CallManager nel cluster.
Avviare Node Manager sull'IPCCX master e attendere che venga visualizzato.
Avviare lo strumento Node Manager nell'IPCCX secondario.
Ciò può verificarsi se viene creato un DSN ODBC senza password. Quando si esegue il test del DSN ODBC, è necessario immettere la password e quindi verificare la connessione. In questo esempio, il server CTIOS ha tentato di eseguire l'accesso senza una password e la connessione ODBC non è riuscita. Poiché la connessione ODBC non è riuscita, le query SQL nel Registro di sistema di CTIOS non sono state eseguite. .
Per risolvere il problema, verificare innanzitutto che la connessione ODBC sia configurata e funzioni correttamente, quindi riavviare il server CTIOS.
Cisco Supervisor Desktop mostra sei agenti collegati nella sezione Real Time Displays della finestra dell'applicazione, ma solo quattro dei sei agenti collegati vengono visualizzati nella finestra Agents.
Due agenti sono stati disconnessi dal servizio chat di Cisco perché le porte della workstation erano bloccate sul server UCCX. Per risolvere il problema, è necessario verificare che le porte non siano bloccate.
Gli agenti scompaiono e riappaiono dal CSD. CAD perde la connettività al servizio di chiamata/chat e non viene ripristinato correttamente. Più istanze di agent.exe vengono visualizzate nell'elenco dei processi del PC dell'agente in Gestione attività. Netstat sul PC dell'agente mostra più connessioni al server.
La soluzione consiste nell'applicare una versione fissa del file Splkstd.dll a ciascuno dei desktop CAD per risolvere il problema. Esistono due soluzioni per questo problema:
Terminare i processi agent.exe in Task Manager e aprire nuovamente CAD nel computer desktop dell'agente. Poi si vedono gli agenti sul Supervisor Desktop. Si tratta di una soluzione rapida, ma non permanente.
Sulla workstation dell'agente, scegliere C: > Programmi > Cisco > Desktop > directory bin. Eseguire quindi i seguenti passaggi:
Rinominare il file SplkStd.dll esistente, ad esempio SplkStd.old.
Estrarre il file SplkStd.dll al percorso rinominato.
Riavviare la workstation dell'agente.
Nota: per ulteriori informazioni, consultare l'ID bug Cisco CSCtd75811 (solo utenti registrati)
Gli agenti non vengono affatto visualizzati nel CSD.
Per risolvere il problema, completare i seguenti passaggi:
Per passare a CDA, scegliere Start > Programmi > Cisco > Desktop > Amministrazione.
Fare clic su Call Center 1 e dal menu scegliere Amministratore desktop > Lato A.
Nella finestra successiva, se non è stata ancora configurata una password, fare clic su login (nessuna password richiesta).
Scegliere Configurazione servizi > Sincronizza servizio directory e fare clic sul pulsante Sincronizza.
Riavviare il servizio Cisco Desktop.
La visualizzazione in tempo reale in Cisco Supervisor Desktop non viene aggiornata nell'area del gruppo di competenze radice per alcun gruppo. È possibile visualizzare i dettagli dell'agente se si esegue il drill-down in un gruppo specifico.
Impostare la soglia di debug su FCCserver e FCRasSvr nella cartella 'C:/Program Files/Cisco/Desktop/config' su entrambi i PG. Accertarsi che la soglia di debug sia impostata anche per il supervisor PC.
Una volta rilevato il problema di accesso dell'agente e del Supervisor e di visualizzazione statistica, raccogliere il registro FCCserver, Rascalserver e Supervisor ed eseguire il debug.
Per assicurarsi di poter completare la sincronizzazione, riavviare il servizio di sincronizzazione Cisco dai servizi Windows su entrambi i PG.
Dopo aver riavviato il servizio di sincronizzazione Cisco, controllare i log:
Line 6781: 2012-06-25 09:42:37:111 INFO DESK1039 Error getting skill stats from enterprise server: <-20>. Line 6785: 2012-06-25 09:47:08:863 ERROR DESK3038 ChatAPI DropPresenceUser failed. Line 6889: 2012-06-25 09:47:15:570 ERROR LRMS2001 The LRM client failed to connect to any service. 2012-06-25 09:49:34:164 WARN FCCS3008 Network communication error <TRANSIENT> sending message to application <AGENT_DESKTOP_012918>. The application will be logged out.
Nota: immettere il comando netstat -p tcp -b -n sul lato server CAD per visualizzare il file exe che utilizza queste porte.
Dai log è stato determinato che i servizi CHAT ed Enterprise in UCCE utilizzano porte diverse da quelle indicate quando sono connessi ai client CAD:
Chat TCP 5900 per connettersi all'agente TCP 37350 per connettersi al Supervisor.
Enterprise TCP 59004 per la connessione al client dell'agente.
Per risolvere il problema, riavviare Cisco Enterprise Service. Se il problema persiste, riavviare i server PG.
Quando sono state assegnate più di 10 abilità a un agente, la sincronizzazione ha sostituito i dati con quelli ricevuti nell'ultimo aggiornamento da CTI. Il Supervisor mostrerebbe solo ciò che aveva ricevuto nell'aggiornamento più recente dalla sincronizzazione. Quindi, in CSD uccidere Gruppi - il rapporto di visualizzazione delle statistiche dell'agente di abilità non mostra gli agenti corretti per le abilità selezionate a sinistra della panoramica. A tale scopo, fare riferimento all'ID bug Cisco CSCsm81553 (solo utenti registrati).
Quando si sceglie un team o una competenza che non contiene record, un supervisore mostrerà tutti i membri del team. I report funzionano correttamente dopo l'installazione della patch di sincronizzazione, quando viene selezionato un team o una competenza valida. A tale scopo, fare riferimento all'ID bug Cisco CSCsm81587 (solo utenti registrati).