Procedure di risoluzione dei problemi dell'agente TMS

Introduzione

Questo documento descrive i problemi comuni di Cisco TelePresence Management Suite (TMS) Agent, uno strumento legacy che consente di eseguire il provisioning di dispositivi e client software come Cisco Jabber Video per TelePresence, Cisco TelePresence Movi e Cisco Jabber per iPad quando registrato su un Cisco Video Communication Server (VCS).

Nota: Cisco consiglia di eseguire l'aggiornamento alla nuova soluzione di provisioning denominata TMS Provisioning Extension (TMSPE), ma la soluzione TMS dovrebbe essere funzionale prima della migrazione.

Prerequisiti

Requisiti

Cisco consiglia al sistema di:

• Esegue Cisco TMS
  
  
• Utilizza uno o più tasti Cisco TelePresence Movi Option (acquistati separatamente)
  
  
• Utilizza uno o più accessori Cisco VCS Control
  
  
• Utilizza la chiave Cisco VCS Device Provisioning Option (chiave gratuita ottenuta dal rappresentante Cisco)

Nota: Questo documento non descrive il clustering VCS. Se si utilizza un cluster VCS, Cisco consiglia di rendere operativo ciascun VCS del cluster, con la configurazione replicata correttamente, prima di abilitare la replica dell'agente TMS.

Componenti

Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:

• Cisco TMS versioni 12.6.X o 13.X
  
  
• Appliance Cisco VCS Control con software versioni X6 o X7

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.

Errori quando l'agente TMS è abilitato su un singolo VCS

In questa sezione vengono descritti i problemi che si verificano quando Cisco TMS Agent viene abilitato su una singola appliance VCS Control.

Impossibile connettersi all'agente TMS remoto

Se l'agente Cisco TMS è abilitato su una singola appliance VCS Control, è possibile che venga visualizzato questo messaggio di errore:

Se si verifica questo problema, verificare che nella scheda Connessione del software VCS sia specificato un nome host DNS (Domain Name System). Affinché il server TMS sia in grado di connettersi correttamente all'agente TMS remoto, è necessario configurare correttamente il DNS. Per ulteriori informazioni, fare riferimento alla sezione Elementi DNS da controllare di questo documento.

Verificare inoltre che la chiave di provisioning del dispositivo sia installata. Se è installato, provare a riavviare l'accessorio di controllo VCS.

Nota: Se si riceve il messaggio di errore Impossibile connettersi all'agente TMS su questo VCS su un accessorio VCS Expressway, il comportamento è normale in quanto VCS Expressway Appliance non deve avere la chiave di provisioning del dispositivo installata.

Impossibile abilitare la replica dei dati dell'agente TMS

Se si riceve il messaggio Impossibile abilitare la replica dei dati dell'agente TMS dalla pagina di stato dell'attività (illustrata nell'immagine seguente) e non sono presenti errori che forniscono una causa dell'errore, completare i passaggi descritti nella sezione successiva. Se esiste una causa dell'errore, controllare gli altri errori comuni descritti in questo documento. 

 

Ricostruire il database dell'agente TMS su VCS

Per ricostruire il database dell'agente TMS sull'accessorio di controllo VCS, è necessario disabilitare la replica nel TMS e quindi reinstallare il database dell'agente TMS.

Avviso: I passaggi descritti in questa sezione causano un errore di accesso utente a Cisco TelePresence Movi o Cisco Jabber Video per TelePresence; gli utenti attualmente connessi rimangono connessi, ma i nuovi utenti non possono accedere fino al completamento della replica.

Disabilita replica in TMS

Completare questi passaggi per disabilitare la replica nel TMS:

1. Dalla pagina del Navigator di TMS Systems, fare clic su VCS.
   
   
2. Passare alla scheda Agente TMS e verificare che la casella di controllo Replica non sia selezionata per ogni VCS.
   
   
3. Attendere finché nella pagina Stato attività non viene segnalato Completo (il processo richiede alcuni minuti).

Reinstallare il database dell'agente TMS su VCS

Completare questa procedura per reinstallare il database dell'agente TMS sull'appliance VCS Control:

1. Secure Shell (SSH) in ciascun peer VCS con il login di root.
   
   
2. Immettere tmsagent_dies_and_purge_data per ciascun VCS.
   
   
3. Leggere le clausole di esclusione delle responsabilità e premere Y.
   
   
4. Ripetere questi passaggi fino al completamento del processo con OK.

Se i passaggi precedenti hanno esito negativo dopo tre tentativi, immettere i seguenti comandi (in ordine):

1. /etc/init.d/S77arresto del provisioning
   
   
2. /etc/init.d/S76opends stop
   
   
3. /etc/init.d/S76apre la disinstallazione
   
   
4. /etc/init.d/S76apre start
   
   
5. /etc/init.d/S77avvio provisioning

Se il processo non riesce dopo aver immesso i comandi precedenti, rimuovere la chiave di provisioning del dispositivo (accertarsi di documentare il valore della chiave) e attendere da due a cinque minuti. Riavviare VCS Control Appliance, aggiungere la chiave di provisioning del dispositivo e attendere altri due o cinque minuti. Immettere quindi il comando tmsagent_dies_and_purge_data per ricevere conferma visiva che il processo è stato completato con OK. È ora possibile abilitare la replica.

Il servizio directory non viene eseguito

Se sul software VCS è presente un allarme che indica se il servizio directory è in esecuzione, riavviare il software VCS. Se l'allarme persiste, completare il processo descritto nella sezione Ricostruire il database dell'agente TMS nel software VCS di questo documento.

VCS non è presente nell'elenco degli agenti di replica

Il software VCS non viene visualizzato nell'elenco degli agenti di replica fino a quando l'agente TMS non esegue correttamente la replica dei dati di provisioning. È possibile ricevere questo messaggio di errore nella scheda Agente TMS in Sistemi > Navigator:

Se viene visualizzato questo messaggio di errore, attenersi alla seguente procedura:

1. Attendere tra due e cinque minuti, quindi aggiornare.
   
   
2. Disabilitare e quindi abilitare la replica.
   
   
3. Se il problema persiste, verificare che il TMS sia in grado di comunicare con il VCS su queste porte:

 

La porta 8989 è la porta di replica utilizzata tra tutti i partner di replica. Ciò significa che la porta deve essere aperta tra ciascun TMS e VCS nella rete. Il traffico scambiato su questa porta è crittografato.  

Nota: Se tra il TMS e il VCS è presente un firewall, è necessario aprire le porte 80 (http) e 443 (https), oltre alle porte menzionate sopra.

Errori DNS: abilitazione replica

Se viene visualizzato il messaggio di errore Impossibile abilitare la replica per 'vcs', una ricerca DNS del nome host TMS nel VCS non corrisponde all'indirizzo IP del TMS. Se viene visualizzato il messaggio di errore Impossibile abilitare la replica dei dati dell'agente TMS per 'vcs', l'evento non è stato completato e l'installazione della replica dei dati dell'agente TMS non è riuscita per il VCS.

Verifica elementi DNS

Connettersi al TMS tramite desktop remoto, aprire un prompt dei comandi e immettere il comando nslookup per il nome di dominio completo (FQDN) corrispondente all'indirizzo di rete visualizzato nella parte inferiore della pagina Impostazioni agente TMS (ad esempio nslookup TANDBERG-MS.tandberg.com). Passare a Strumenti di amministrazione > Configurazione per accedere alla pagina Impostazioni.

Se TMS è in una configurazione ridondante, ogni TMS deve avere un record di inoltro risolvibile. I record non devono corrispondere al nome host fisico della casella di Microsoft Windows. Tuttavia, se a un nome host o a un indirizzo IP diverso sono assegnate più ricerche dirette o inverse, la ricerca DNS potrebbe non riuscire. Una volta creato il record di inoltro per il TMS, il problema non dovrebbe più verificarsi.

Nota: In alcuni casi più record inversi DNS causano problemi nelle versioni precedenti di TMS. Per eliminare questo problema, si consiglia un solo record inverso. Per verificare questa condizione, immettere il comando nslookup per l'indirizzo IP (ad esempio nslookup 10.10.0.1).

Ripristinare l'agente TMS locale dall'agente TMS remoto

Nota: Il processo descritto in questa sezione viene utilizzato se il database dell'agente TMS sul server TMS è danneggiato ma il database VCS è operativo o se non esiste un backup operativo noto del TMS.

Completare questi passaggi per ripristinare l'agente TMS locale dall'agente TMS remoto:

1. Completare i passaggi descritti nella sezione Ricostruire il database dell'agente TMS sul software VCS di questo documento per interrompere la replica dell'agente TMS per il software VCS.
   
   
2. Passare a Manutenzione > Backup, ripristinare la pagina VCS e fare clic sul pulsante Crea file di backup agente TMS. Il file viene salvato come file tar.gz.
   
   
3. Aprire il file tar.gz in 7-Zip e fare clic sulle cartelle fino a raggiungere questo percorso:
   
   
   
   
4. Estrarre i file in una posizione nota.
   
   
5. Selezionare i file, fare clic con il pulsante destro del mouse e scegliere Cartella compressa:
   
   
   
   
6. Una volta creata la cartella compressa, fare doppio clic su di essa per verificare che tutte le cartelle vengano visualizzate nel file.
   
   

   Nota: Se si fa doppio clic sulla cartella compressa ed è presente un'unica directory che è necessario aprire per visualizzare le cartelle e app.config, il processo non funziona.

   
   
7. Rinominare la cartella come TMSAgentBackup.<anno><mese><giorno><ora> (ad esempio, TMSAgentBackup.201011071300).
   
   

   Nota: La voce time utilizza il formato 24 ore. Ad esempio, l'ora 1.00 viene immessa come 1300.

   
   
8. Verificare che la replica su tutti i dispositivi sia disabilitata. inclusa la replica tra agenti TMS in un'installazione ridondante TMS.
   
   
9. Passare a Strumenti di amministrazione > Configurazione > Impostazioni agente TMS e cancellare l'elenco Agenti di replica.
   
   
10. Connettersi al TMS tramite desktop remoto e individuare la directory di backup nella pagina Impostazioni agente TMS.
    
    
11. Copiare la nuova cartella compressa (creata nei passaggi precedenti) nella directory di backup.
    
    
12. Aggiornare la pagina Impostazioni agente TMS per aggiungere il nuovo file al menu a discesa, come mostrato:
    
    
    
    
13. Fare clic sul pulsante Ripristina.
    
    
14. Una volta completato il ripristino dei dati dell'agente TMS, eseguire la diagnostica dell'agente TMS sull'agente TMS locale.
    
    
15. Passare alla directory Provisioning e verificare che la configurazione e gli utenti vengano visualizzati come previsto.
    
    
16. Abilitare la replica sul software VCS.

Ricostruisci manualmente gli indici per il database dell'agente TMS locale

Completare questi passaggi se si esegue TMS versione 13.1 o successiva e si ricevono errori di indice mentre si esegue la diagnostica dell'agente TMS locale dopo aver fatto clic sul pulsante Correggi:

1. Collegarsi al TMS tramite desktop remoto.
   
   
2. Selezionare Start > Esegui e immettere %OPENDS_HOME%\bat.
   
   
3. Aprire il file control-panel.bat e accedere con la password di configurazione LDAP (Lightweight Directory Access Protocol) (l'impostazione predefinita è TANDBERG). Dovrebbe essere simile alla seguente:
   
   
   
   
4. Fare clic su Verifica indici per visualizzare una schermata simile alla seguente:
   
   
   
   
5. Selezionare tutti gli indici disponibili e fare clic sul pulsante Aggiungi >.
   
   
6. Al termine, ripetere questi passaggi ma fare clic su Ricrea indici nella pagina OpenDS Control Panel (passaggio 4).  

Abilitare l'agente TMS in un ambiente ad alta latenza

Quando si abilita la replica sui VCS, 300 ms è la latenza di andata e ritorno massima consentita all'agente TMS per il corretto funzionamento/replica su tutti i peer replicati. I peer di replica sono qualsiasi dispositivo eseguito dall'agente TMS, ad esempio TMS e VCS. Se la latenza di andata e ritorno tra uno qualsiasi di questi peer in replica supera i 200 ms, l'infrastruttura potrebbe presentare problemi di replica.

Se si dispone di una rete ad alta latenza, è molto probabile che si verifichino problemi quando si abilita la replica. Il tentativo ha come risultato uno dei seguenti tre risultati:

• Replica completata.
  
  
• Vengono ricevuti errori prima dell'esecuzione del metodo Initialize TMS Agent.
  
  
• Gli errori vengono ricevuti dopo l'esecuzione del metodo Initialize TMS Agent.

Per risolvere i due errori, completare la procedura seguente:

1. Durante il processo di replica, fare clic sull'evento Abilita replica dati agente TMS per sistemi nella pagina Stato attività per tenere traccia dello stato di avanzamento.
   
   
2. Aggiorna la pagina al termine del processo.
   
   
3. Se si verificano errori prima della parte del processo Initialize TMS agent on VCS Name, è necessario ricreare il database OpenDS sul VCS.
   
   
4. Se si verificano errori dopo la parte del processo Inizializza agente TMS sul nome VCS, eseguire la diagnostica dell'agente TMS per il VCS nella pagina Diagnostica agente TMS.
   
   
5. Se si ricevono principalmente controlli verdi, provare i client Cisco Jabber/Movi per verificare se sono in grado di eseguire l'accesso.
   
   

   Nota: Tutti i controlli in rosso indicano che il processo di replica non è riuscito ed è necessario ricreare il database OpenDS nel software VCS.

Reimposta la password del database dell'agente TMS su TMS

Se si riceve l'errore sconosciuto quando si imposta la password dell'agente TMS nella pagina Impostazioni agente TMS, è possibile utilizzare questa procedura per ripristinare la password predefinita di TANDBERG per Directory Manager. Completare questo processo dopo aver disabilitato la replica su tutti i dispositivi, inclusa la replica tra gli agenti TMS in un'installazione ridondante TMS.  

1. Aprire un prompt dei comandi.
   
   
2. Passare alla directory OpenDS-2.0\bat: cd %OPENDS_HOME%\bat.
   
   
3. Immettere il comando encode-password.bat -s SSHA512 -c TANDBERG > C:\ENCPASSWORD.txt.
   
   
4. Arrestare il servizio Windows TMSAgents, arrestando anche il servizio Windows OpenDS.
   
   
5. Aprire il file %OPENDS_HOME%\config\config.ldif.
   
   
6. Individuare questa sezione:
   
   

   dn: cn=Directory Manager,cn=Root DNs,cn=config
   objectClass: person
   objectClass: organizationalPerson
   objectClass: inetOrgPerson
   objectClass: top
   objectClass: ds-cfg-root-dn-user
   userPassword: {SSHA512}KFfaERuBiOesVUg/mf7EB4xqq5eOOPFDuVBiZCPaBetrgN92rwbe
    JTPiPZ+I3ferqN8D4UgnA5jIBLRbrtUFT9Jld/vN85dg

   
   
7. Sostituire la stringa userPassword con la stringa specificata nel file ENCPASSWORD.TXT (senza virgolette).
   
   
8. Rimuovere o rinominare il file app.config che si trova in questa directory: TANDBERG\TMS\wwwTMS\Data\TMSAgent\app.config.
   
   
9. Avviare il servizio TMSAgent di Windows, attendere circa un minuto, quindi avviare anche il servizio OpenDS di Windows.
   
   
10. Nel portale TMS, selezionare Strumenti di amministrazione > Impostazioni agente TMS.
    
    
11. Modificare i campi della password in TANDBERG.
    
    
12. Al termine del processo, arrestare il servizio TMSAgent Windows che arresta anche il servizio OpenDS Windows.
    
    
13. Rimuovere o rinominare il file app.config che si trova in questa directory: TANDBERG\TMS\wwwTMS\Data\TMSAgent\app.config.
    
    
14. Riavviare il servizio TMSAgent di Windows, che riavvia anche il servizio OpenDS di Windows.

Un altro modo per verificare che i servizi Windows TMSAgent e OpenDS siano abilitati consiste nell'aprire Gestione attività Windows e selezionare la scheda Processi per verificare che siano in esecuzione due processi java.exe. Il primo processo ha inizio rapidamente; l'avvio della seconda istanza potrebbe richiedere da uno a due minuti. Ciò significa che i servizi vengono eseguiti, ma non garantisce che vengano eseguiti correttamente.  

 

Controllare lo stato della replica

La verifica dello stato di replica di un software VCS consente di identificare i problemi di replica. Per verificare questa condizione, selezionare Systems > Navigator in TMS (Sistemi > Navigator in TMS) e selezionare il software VCS. Fare clic sulla scheda Agente TMS e sul pulsante Mostra stato replica:

  

Suggerimento: Se sono presenti errori nella casella visualizzata nell'immagine precedente, possono aiutare a determinare i passaggi successivi da eseguire per risolvere il problema di replica e possono anche indicare se una porta è bloccata.

Informazioni correlate

• Guida alla distribuzione di TMS Provisioning
• Guida alla risoluzione dei problemi di provisioning TMS
• Guida alla distribuzione dei dispositivi di autenticazione VCS X7.1
• Guida alla distribuzione dei dispositivi di autenticazione VCS X7.0
• Guida alla distribuzione dei dispositivi di autenticazione VCS X6.1
• Perché effettuare l'aggiornamento a Cisco TMSPE?
• Documentazione e supporto tecnico – Cisco Systems