Inleiding
Dit document beschrijft meerdere scenario's voor het opsporen en verhelpen van fouten voor Cisco Finse Server of een ander Cisco Voice Operating System (VOS) gebaseerd product met het gebruik van een java-gebaseerde opdrachtregel interface (CLI).
Opmerking: De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u de potentiële impact van elke opdracht begrijpen.
Probleemoplossing voor Cisco VOS-gebaseerde servers met CLI
Overzicht van generiek
Cisco VOS CLI biedt een verzameling opdrachten die het mogelijk maken bepaalde probleemoplossende taken op een zeer effectieve manier uit te voeren.
Schijfinhoud reinigen
Een veel voorkomende taak voor elke VOS-gebaseerde server is het schoonmaken van de ruimte in de gemeenschappelijke indeling. Deze opdracht kan daarvoor worden gebruikt.
Geef eerst een lijst op van de logbestanden en specificeer een pad en optionele toetsen.
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
Verwijder vervolgens de oude logbestanden. U kunt desgewenst geen bevestiging van sleutel specificeren om te vermijden en niet ja drukken als bevestiging.
admin:file delete activelog /desktop/logs/webservices/*webservices.2016-08-11* noconfirm
files: found = 4, deleted = 4
CLI-opdrachten voor audits invoeren
Deze opdracht maakt een lijst van alle VOS CLI-opdrachten die zijn ingevoerd. Zelfs de opdrachten werden zonder succes uitgevoerd.
Uit de output kan je zien dat het systeem opnieuw opgestart was, dat het kartelcertificaat geïmporteerd werd en dat de Tomcat-dienst daarna opnieuw opgestart werd.
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
Opmerking: Voor sommige op VOS gebaseerde servers is de neventoets niet beschikbaar.
Logbestanden online bekijken
Een relevant logbestand zoeken
In het geval van een specifiek foutbericht dat in Finse client wordt weergegeven, wordt een zoekoptie-geval gebruikt om de exacte tijdstempel en het logbestand te bepalen.
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
De output toont het exacte logbestand, de timestamp met msec precisie en het gegenereerde foutbericht "Kan gebruiker niet echt maken: 100011".
Bekijk het bestand online
De volgende stap nadat u het betreffende logbestand hebt gevonden, is het te bekijken. En gebruik van bestandstort optie voor grote logbestanden is niet erg nuttig. In plaats daarvan kunt u de bestandsweergave gebruiken, zodat u rechtstreeks naar het einde van het bestand kunt navigeren.
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) :
Bladeren map op VOS
Kan om meerdere redenen gebruikt worden. Een van deze controles is dat het logbestand gegenereerd wordt om te bewijzen dat het proces draait, de bestandsgrootte controleren op schijf schoonmaken of zelf-studie.
Deze opdracht geeft een lijst met logbestanden die zijn gefilterd door de opgegeven naam. De detailweergave van de optie geeft datum en grootte weer. Een extra belangrijke datum sorteert de uitvoer op basis van de tijdbestanden die zijn gegenereerd.
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
Historie van platform controleren
Basis diagnostische informatie over de serverupgrades, Cisco Opties Package (COP) aan bestandsinstallaties en herstart is zeer behulpzaam. Vooral tijdens het proces van probleemoplossing.
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
Downloadlijsten
Als u de logbestanden uit het systeem moet halen voor nadere analyse, kan deze opdracht worden gebruikt. Het is onvervangbaar wanneer Cisco Tomcat web server niet is en Real-Time Monitoring Tool (RTMT) niet kan worden gebruikt.
U kunt de logbestanden op basis van het tijdfilter slepen. In dit voorbeeld gedurende de laatste twee uur.
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:
Kan ook logbestanden worden getrokken op basis van het naamfilter. In dit voorbeeld worden alleen bestanden met de bestandsextensie uit de installatiemap gehaald. De bestanden zijn niet gecomprimeerd.
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.
Een ander nuttig geval is om de logbestanden te verzamelen voor een analyse van de worteloorzaak voor een specifiek tijdbereik.
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]?
Opmerking: Verzeker u ervan dat de totale grootte waarde wordt geverifieerd en of het te groot is maakt of minder tijdbereik of zet meer specifieke folder.