CLI로 Cisco VOS 기반 Finesse 서버 문제 해결

소개

이 문서에서는 Cisco Finesse Server 또는 Java 기반 CLI(Command Line Interface)를 사용하는 기타 Cisco VOS(Voice Operating System) 기반 제품의 여러 문제 해결 시나리오에 대해 설명합니다.

참고: 이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우, 모든 명령어의 잠재적인 영향을 미리 숙지하시기 바랍니다.

CLI로 Cisco VOS 기반 Finesse 서버 문제 해결

일반 개요

Cisco VOS CLI는 특정 문제 해결 작업을 매우 효율적인 방법으로 수행 할 수 있는 명령 집합을 제공 합니다.

디스크 공간 정리

모든 VOS 기반 서버에 대한 매우 일반적인 작업은 공통 파티션의 공간을 청소하는 것입니다. 이 명령을 사용할 수 있습니다.

먼저 로그 파일을 나열하고 경로와 선택적 키를 지정합니다.

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

그런 다음 이전 로그 파일을 제거합니다. 선택적으로 no confirm 키를 지정하여 확인으로 yes를 누르지 않을 수 있습니다.

admin:file delete activelog /desktop/logs/webservices/*webservices.2016-08-11* noconfirm

files: found = 4, deleted = 4

입력한 감사 CLI 명령

이 명령은 입력한 모든 VOS CLI 명령을 나열합니다. 명령도 실행되지 않았습니다.

출력에서 시스템이 다시 시작되고, tomcat-trust 인증서가 가져오기되었으며, 그 이후에 Tomcat 서비스가 다시 시작되었음을 알 수 있습니다.

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

참고: 일부 VOS 기반 서버에서는 무시 키를 사용할 수 없습니다.

온라인 로그 검토

관련 로그 파일 찾기

Finesse 클라이언트에 표시된 특정 오류 메시지의 경우 정확한 타임스탬프와 로그 파일을 확인하는 데 검색 옵션 사례를 사용합니다.

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

출력에는 정확한 로그 파일, msec 정밀도의 타임스탬프 및 생성된 오류 메시지가 표시됩니다. "사용자를 인증할 수 없음: 100011.

온라인 파일 검토

관련 로그 파일을 찾은 다음 단계는 해당 로그 파일을 검토하는 것입니다. 그리고 큰 로그 파일에 대한 파일 덤프 옵션을 사용하는 것은 매우 유익하지 않습니다. 대신 파일 보기를 사용할 수 있으므로 파일의 끝으로 바로 이동할 수 있습니다.

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) :

VOS에서 디렉터리 찾아보기

여러 가지 이유로 사용할 수 있습니다. 그 중에는 프로세스가 실행됨을 증명하기 위해 로그 파일이 생성되었는지 확인하는 검사, 디스크 정리 또는 자체 검토에 대한 로그 크기를 확인하는 검사 등이 있습니다.

이 명령은 제공된 이름으로 필터링된 로그 파일 목록을 제공합니다. 옵션 세부사항에는 날짜와 크기가 표시됩니다. 추가 키 날짜는 파일이 생성된 시간을 기준으로 출력을 정렬합니다.

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

플랫폼 기록 확인

서버 업그레이드, Cisco Options Package(COP) 파일 설치 및 재부팅에 대한 기본 진단 정보가 매우 유용합니다. 특히 트러블슈팅 프로세스 중에

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 

로그 다운로드

추가 분석을 위해 시스템에서 로그를 풀어야 하는 경우 이 명령을 사용할 수 있습니다. Cisco Tomcat 웹 서버가 다운되어 RTMT(Real-Time Monitoring Tool)를 사용할 수 없는 경우 교체할 수 없습니다.

시간 필터를 기반으로 로그를 풀 수 있습니다. 이 예에서는 지난 2시간 동안의 작업을 보여 줍니다.

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:

또한 이름 필터에 따라 로그를 가져올 수 있습니다. 이 예에서는 로그 확장명을 가진 파일만 설치 디렉토리에서 가져옵니다. 파일이 압축되지 않았습니다.

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.

또 다른 유용한 사례는 특정 시간 범위의 근본 원인 분석을 위해 로그를 수집하는 것입니다.

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]? 

참고: 총 크기 값을 확인하고 너무 큰 경우 시간 범위를 줄이거나 보다 구체적인 디렉터리를 지정해야 합니다.