المحتويات

المقدمة

أستكشاف أخطاء خادم Finesse المستند إلى Cisco VOS وإصلاحها مع CLI

نظرة عامة عامة

تنظيف مساحة القرص

تدقيق أوامر CLI التي تم إدخالها

مراجعة السجلات عبر الإنترنت

البحث عن ملف سجل ذو صلة

مراجعة الملف عبر الإنترنت

إستعراض الدليل في VOS

فحص محفوظات النظام الأساسي

سجلات التنزيل

المقدمة

يصف هذا المستند سيناريوهات متعددة لاستكشاف الأخطاء وإصلاحها لخادم Cisco Finesse أو أي منتج آخر قائم على نظام التشغيل الصوتي (VOS) من Cisco باستخدام واجهة سطر الأوامر (CLI) المستندة إلى Java.

ملاحظة: تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك مباشرة، فتأكد من فهمك للتأثير المحتمل لأي أمر.

أستكشاف أخطاء خادم Finesse المستند إلى Cisco VOS وإصلاحها مع CLI

نظرة عامة عامة

توفر واجهة سطر الأوامر (CLI) الخاصة بالصوت Cisco VOS مجموعة من الأوامر التي تسمح بأداء مهام معينة لاستكشاف الأخطاء وإصلاحها بطريقة فعالة للغاية.

تنظيف مساحة القرص

من المهام الشائعة جدا لأي خادم يستند إلى 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

ثم قم بإزالة ملفات التدوين القديمة. إختياريا، يمكنك تحديد مفتاح noconfirm لتجنبه وعدم الضغط على نعم كتأكيد.

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

files: found = 4, deleted = 4

تدقيق أوامر CLI التي تم إدخالها

يسرد هذا الأمر جميع أوامر واجهة سطر الأوامر (CLI) التي تم إدخالها. حتى الأوامر التي تم تنفيذها دون نجاح.

من الإخراج، يمكنك أن ترى أنه قد تم إعادة تشغيل النظام، وتم إستيراد شهادة الثقة التامة، وتمت إعادة تشغيل خدمة 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 (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).

يمكنك سحب السجلات استنادا إلى عامل تصفية الوقت. في هذا المثال على الساعتين الأخيرتين.

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

ملاحظة: تأكد من التحقق من قيمة الحجم الإجمالي وإذا كانت كبيرة جدا، فتحقق من نطاق زمني أقل أو ضع دليل أكثر تحديدا.