Introduction
Ce document décrit plusieurs scénarios de dépannage pour Cisco Finesse Server ou tout autre produit basé sur Cisco Voice Operating System (VOS) avec l'utilisation de l'interface de ligne de commande (CLI) basée sur Java.
Remarque : The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
Dépannage du serveur Finesse basé sur Cisco VOS avec CLI
Présentation générique
L'interface de ligne de commande de Cisco VOS fournit un ensemble de commandes qui permet d'effectuer certaines tâches de dépannage de manière très efficace.
Nettoyer l'espace disque
Une tâche très courante pour tout serveur basé sur VOS est de nettoyer l'espace dans la partition commune. Cette commande peut être utilisée pour cela.
Tout d'abord, répertoriez les fichiers journaux et spécifiez un chemin d'accès et des clés facultatives.
admin:file list activelog /desktop/logs/webservices date detail
11 Aug,2016 20:26:23 1,927,946 Desktop-webservices.2016-08-11T15-53-39.646.startup.log.zip
11 Aug,2016 21:44:42 1,105,322 Error-Desktop-webservices.2016-08-11T15-53-40.166.startup.log.zip
12 Aug,2016 01:48:58 1,741,638 Desktop-webservices.2016-08-11T20-26-23.164.log.zip
12 Aug,2016 03:35:30 1,126,078 Error-Desktop-webservices.2016-08-11T21-44-42.664.log.zip
12 Aug,2016 07:11:33 1,753,064 Desktop-webservices.2016-08-12T01-48-58.164.log.zip
12 Aug,2016 09:26:17 1,125,984 Error-Desktop-webservices.2016-08-12T03-35-30.164.log.zip
12 Aug,2016 12:34:08 1,741,476 Desktop-webservices.2016-08-12T07-11-33.664.log.zip
12 Aug,2016 15:17:05 1,125,790 Error-Desktop-webservices.2016-08-12T09-26-17.664.log.zip
Supprimez ensuite les anciens fichiers journaux. Vous pouvez éventuellement spécifier noconfirm key pour éviter et ne pas appuyer sur yes comme confirmation.
admin:file delete activelog /desktop/logs/webservices/*webservices.2016-08-11* noconfirm
files: found = 4, deleted = 4
Commandes CLI d'audit saisies
Cette commande répertorie toutes les commandes CLI VOS entrées. Même les commandes ne se sont pas exécutées correctement.
D'après le résultat, vous pouvez voir que le système a été redémarré, que le certificat d'approbation Tomcat a été importé et que le service Tomcat a été redémarré après cela.
admin:file search activelog platform/log/cli* "running command" ignorecase recurs
Searching path: /var/log/active/platform/log/cli*
2016-11-03 09:59:12,558 INFO [main] sdMain.main - running command -> [utils system restart ]
2016-11-03 09:38:52,623 INFO [main] sdMain.main - running command -> [set cert import trust tomcat]
2016-11-03 09:39:30,978 INFO [main] sdMain.main - running command -> [utils service restart Cisco Tomcat]
2016-11-03 09:41:16,664 INFO [main] sdMain.main - running command -> [show cert own tomcat]
Search completed
Remarque : Sur certains serveurs VOS, la clé ignorecase n'est pas disponible.
Consulter les journaux en ligne
Rechercher un fichier journal approprié
Dans le cas d'un message d'erreur spécifique affiché dans le client Finesse, un cas d'option de recherche peut être utilisé pour déterminer l'horodatage exact et le fichier journal.
admin:file search activelog /desktop/logs/ "100011" recurs ignorecase
Searching path: /var/log/active//desktop/logs/
/var/log/active//desktop/logs/realm/realm.log:1289383032: Nov 18 2016 08:14:15.076 +0100:
[http-bio-8445-exec-10] INFO CCRealmConfig.finesseAuthenticate(): Unable to authenticate user: 100011
Search completed
Le résultat montre le fichier journal exact, l'horodatage avec une précision de msec et le message d'erreur généré "Impossible d'authentifier l'utilisateur : 100011".
Consulter le fichier en ligne
L'étape suivante après avoir trouvé le fichier journal approprié consiste à le consulter. Et utiliser l'option de vidage de fichier pour les gros fichiers journaux n'est pas très bénéfique. À la place, vous pouvez utiliser la vue fichier, de sorte que vous pouvez naviguer directement à la fin du fichier.
admin:file view activelog /desktop/logs/realm/realm.log
0: Aug 11 2016 15:52:14.423 +0200: [localhost-startStop-1] INFO
Loaded realm log config file at: /opt/cisco/desktop/conf/realm/log4j.xml
55577: Aug 11 2016 15:53:10.000 +0200: [Infrastructure Initialization, completed] INFO
Loaded realm log config file at: /opt/cisco/desktop/conf/realm/log4j.xml
options: q=quit, n=next, p=prev, b=begin, e=end (lines 1 - 20 of 374) :
956921239: Nov 14 2016 11:53:13.283 +0100: [http-bio-8445-exec-12] INFO
CCRealmConfig.finesseAuthenticate(): Unable to authenticate user: 1012
1206572479: Nov 17 2016 09:14:04.523 +0100: [http-bio-8082-exec-6] INFO
CCRealmConfig.finesseAuthenticate(): Unable to authenticate user: MEDIASENSE_API
1217996207: Nov 17 2016 12:24:28.251 +0100: [http-bio-8082-exec-10] INFO
CCRealmConfig.finesseAuthenticate(): Unable to authenticate user: MEDIASENSE_API
1289292089: Nov 18 2016 08:12:44.133 +0100: [http-bio-8445-exec-22] INFO
CCRealmConfig.finesseAuthenticate(): Unable to authenticate user: 5678
1289383032: Nov 18 2016 08:14:15.076 +0100: [http-bio-8445-exec-10] INFO
CCRealmConfig.finesseAuthenticate(): Unable to authenticate user: 100011
end of the file reached
options: q=quit, n=next, p=prev, b=begin, e=end (lines 361 - 374 of 374) :
Parcourir le répertoire dans VOS
Peut être utilisé pour plusieurs raisons. Parmi celles-ci figurent des vérifications que le fichier journal est généré pour prouver que le processus s'exécute, des vérifications de taille de journaux pour le nettoyage de disque ou l'auto-étude.
Cette commande fournit une liste des fichiers journaux filtrés par le nom fourni. Détails de l'option affiche la date et la taille. Une date clé supplémentaire trie la sortie en fonction de l'heure à laquelle les fichiers ont été générés.
admin:file list activelog /desktop/logs/webservices/*2016-08-12* det date
12 Aug,2016 07:11:33 1,753,064 Desktop-webservices.2016-08-12T01-48-58.164.log.zip
12 Aug,2016 09:26:17 1,125,984 Error-Desktop-webservices.2016-08-12T03-35-30.164.log.zip
12 Aug,2016 12:34:08 1,741,476 Desktop-webservices.2016-08-12T07-11-33.664.log.zip
12 Aug,2016 15:17:05 1,125,790 Error-Desktop-webservices.2016-08-12T09-26-17.664.log.zip
12 Aug,2016 17:56:43 1,741,988 Desktop-webservices.2016-08-12T12-34-08.664.log.zip
12 Aug,2016 21:07:52 1,125,050 Error-Desktop-webservices.2016-08-12T15-17-05.164.log.zip
12 Aug,2016 23:19:18 1,753,089 Desktop-webservices.2016-08-12T17-56-43.663.log.zip
13 Aug,2016 02:58:40 1,125,382 Error-Desktop-webservices.2016-08-12T21-07-52.664.log.zip
13 Aug,2016 04:41:53 1,742,441 Desktop-webservices.2016-08-12T23-19-18.664.log.zip
dir count = 0, file count = 9
Vérifier l'historique
Les informations de diagnostic de base sur les mises à niveau du serveur, les installations de fichiers Cisco Options Package (COP) et les redémarrages sont très utiles. Surtout pendant le processus de dépannage.
admin:file dump install system-history.log
=======================================
Product Name - Cisco Finesse
Product Version - 11.0.1.10000-24
Kernel Image - 2.6.32-431.20.3.el6.x86_64
=======================================
08/11/2016 12:46:19 | root: Install 11.0.1.10000-24 Start
08/11/2016 06:02:15 | root: Boot 11.0.1.10000-24 Start
08/11/2016 15:45:52 | root: Install 11.0.1.10000-24 Success
08/11/2016 15:45:53 | root: Boot 11.0.1.10000-24 Start
08/26/2016 12:50:14 | root: Cisco Option Install finesse-cce.1101.ES05.10000.cop Start
08/26/2016 13:25:51 | root: Cisco Option Install finesse-cce.1101.ES05.10000.cop Success
08/26/2016 13:51:14 | root: Restart 11.0.1.10000-24 Start
08/26/2016 13:51:40 | root: Boot 11.0.1.10000-24 Start
10/19/2016 17:16:48 | root: Shutdown 11.0.1.10000-24 Start
10/20/2016 12:17:10 | root: Boot 11.0.1.10000-24 Start
Journaux de téléchargement
Si vous devez extraire les journaux du système pour une analyse plus approfondie, vous pouvez utiliser cette commande. Il est irremplaçable lorsque le serveur Web Cisco Tomcat est en panne et que l'outil de surveillance en temps réel (RTMT) ne peut pas être utilisé.
Vous pouvez extraire les journaux en fonction du filtre d'heure. Dans cet exemple, pour les deux dernières heures.
admin:file get activelog /desktop/logs/webservices/ reltime hours 2 compress
This command can take significantly long time,
and can also affect the system wide IOWAIT on your system.
Would you like to proceed [y/n]?y
Please wait while the system is gathering files info ...done.
Sub-directories were not traversed.
Number of files affected: 1
Total size in Bytes: 3460015
Total size in Kbytes: 3378.921
Would you like to proceed [y/n]? y
SFTP server IP:
En outre, les journaux peuvent être extraits en fonction du filtre de nom. Dans cet exemple, seuls les fichiers portant l'extension de journal sont extraits du répertoire d'installation. Les fichiers ne sont pas compressés.
admin:file get install /*.log
Please wait while the system is gathering files info ...done.
Sub-directories were not traversed.
Number of files affected: 10
Total size in Bytes: 2640585
Total size in Kbytes: 2578.6963
Would you like to proceed [y/n]? n
Files transfer cancelled.
Un autre cas utile consiste à collecter les journaux pour une analyse de la cause première pour une plage de temps spécifique.
admin:file get activelog /desktop/logs/ abstime 09:00:11/13/16 09:00:11/14/16 recurs
Please wait while the system is gathering files info ...done.
Sub-directories were traversed.
Number of files affected: 2
Total size in Bytes: 7446444
Total size in Kbytes: 7271.918
Would you like to proceed [y/n]?
Remarque : Assurez-vous de vérifier la valeur de la taille totale et si elle est trop grande soit faire une plage de temps inférieure ou mettre un répertoire plus spécifique.