أستكشاف أخطاء الاتصال وإصلاحها بين خادم CVP OAMP وخادم CVP Call Server

المقدمة

يصف هذا المستند كيفية أستكشاف أخطاء الاتصال وإصلاحها بين خادم وحدة تحكم عملية (OAMP) ل Cisco Voice Portal (CVP) باستخدام خادم مكالمات CVP. 

فيما يلي قائمة بمشكلات الاتصال الشائعة بين هذين الخادمين:

1.  ماذا يحدث عند ضغط زر حفظ ونشر في صفحة CVP OAMP؟

2.  ما المكونات التي نحتاج إليها للتحقق مما إذا كان خادم OAMP لا يمكنه الوصول إلى خادم الاتصال ل CVP؟

3.  ما الملفات التي يتم تغييرها في عملية إعادة الصورة؟

تمت المساهمة بواسطة Mingze YAN، مهندس TAC من Cisco.

تحرير سحر موداريس، cisco TAC مهندس.

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• CVP

المكونات المستخدمة

• CVP Call Server 11.5
• CVP OAMP 11.5

ماذا يحدث عند ضغط زر حفظ ونشر في صفحة CVP OAMP؟

لفهم ما يحدث عند الضغط على الزر "حفظ ونشر"، يجب أن ترى ما يتم عرضه عند تثبيت خادم إستدعاء جديد. بعد تثبيت خادم اتصال CVP، لا يوجد نظام CVP الفرعي معرف ولا يقوم خادم OAMP بتخصيص أي ناقل رسائل.

للتحقق من التكوين، انتقل إلى \Cisco\CVP\conf\system.properties مبرد. لا يتضمن الملف معلومات النظام الفرعي.

CVPServlet.upgradeProperties = false /
#msg.sendType = NEW_CALL
#msg.sendTopic = CVP.ICM.CC.RESP.SYS_SIP1
#stub.ipaddress = localhost
#stub.sendport  = 6000
#stub.readport  = 7000
CVPServlet.upgradeProperties = false

ومن نفس المجلد، لا يوجد مكون إضافي معرف في الملف MessageAdapter.properties.

#MessageAdapter.MsgBus001.filter.stubFilter1 = CVP.SIP.CC.*
##--------------- STUB SS (SYS_STUB1) MESSAGE BUS SIDE PLUGIN -------------------
#MessageAdapter.MsgBus001.plugin.MSGBUS_STUB1.class = com.cisco.msg.msgbus.inprocess.InProcessPlugin
#MessageAdapter.MsgBus001.plugin.MSGBUS_STUB1.param.pluginType = IN_PROCESS
#MessageAdapter.MsgBus001.plugin.MSGBUS_STUB1.param.adapterName = MsgBus001
#MessageAdapter.MsgBus001.plugin.MSGBUS_STUB1.param.adapterType = MessageBus
#MessageAdapter.MsgBus001.plugin.MSGBUS_STUB1.param.mirrorPluginName = SYS_STUB1
#MessageAdapter.MsgBus001.plugin.MSGBUS_STUB1.filter.exclude.1 = filterAll
#MessageAdapter.MsgBus001.plugin.MSGBUS_STUB1.filter.include.1 = stubFilter1

 

##--------------- STUB SS (SYS_STUB1) PLUGIN -------------------
#MessageAdapter.STUB1.active = true
#MessageAdapter.STUB1.plugin.SYS_STUB1.class = com.cisco.msg.msgbus.inprocess.InProcessPlugin
#MessageAdapter.STUB1.plugin.SYS_STUB1.param.pluginType = IN_PROCESS
#MessageAdapter.STUB1.plugin.SYS_STUB1.param.adapterName = STUB1
#MessageAdapter.STUB1.plugin.SYS_STUB1.param.mirrorPluginName = MSGBUS_STUB1
#MessageAdapter.STUB1.plugin.SYS_STUB1.param.adapterType = STUB

من سجلات CVP، هذا هو ما تظهره عندما لا يوجد نظام فرعي معرف:

16: 10.66.75.101: Jul 07 2017 09:28:27.726 +1000: %CVP_11_5_Infrastructure-0-START:  No Subsystems have been started.  Have you configured your server yet? ; Make sure <CVP_HOME>\conf\propFileList.properties is loading "system" and that <CVP_HOME>\conf\system.properties lists at least one subsystem to load. [id:1033]

عند تكوين خادم CVP Call في صفحة واجهة المستخدم الرسومية (GUI) ل OAMP، تحدث هذه التغييرات:

1. يقوم خادم OAMP بدفع معلومات ناقل الرسائل إلى خادم مكالمات CVP، ويضيف أيضا النظام الفرعي والمكون الإضافي.

2. يتم تعديل هذه الملفات بعد تطبيق التغييرات:

3. من ملف system.properties، يتم تخصيص ناقل الرسائل بواسطة خادم OAMP، والذي يعتبر ذا أهمية عالمية. يستخدم كل خادم اتصال CVP ناقل رسائل مختلف للاتصال ب OAMP:

CVPServlet.upgradeProperties = false
MessagingLayer.adapterName = MsgBus003
CVPServlet.subsystem.0.Class = com.cisco.cvp.central.CVPController
CVPServlet.subsystem.0.ID = CVPCTL3
CVPServlet.subsystem.1.Class = com.cisco.cvp.icm.ICMSubsystem
CVPServlet.subsystem.1.ID = ICM3
CVPServlet.subsystem.2.Class = com.cisco.cvp.sip.SipSubsystem
CVPServlet.subsystem.2.ID = SIP3
CVPServlet.subsystem.3.Class = com.cisco.cvp.ivr.IVRSubSystem
CVPServlet.subsystem.3.ID = IVR3
cmdManager.timeout = 10000
cmdManager.commandPrefix = cmd /c
cmdManager.checkServiceCmd = net start
cmdManager.cmd_separator = &
cmdManager.expected = expected

4. من ملف ORM.Properties، تتم إضافة Control AdapterName:

#For http client
orm.org.apache.logLevel = ERROR
httpclient.logLevel = ERROR
orm.controller.adapterName = CVPCTL3

5. داخل ملف messageAdapter.properties، يتم إضافة الملحقات، ويتم تخصيص أرقام المنافذ لكل ملحق.

 

# --------------- ORM OUTPROCESS PLUGIN -------------------
MessageAdapter.ORM.active = true
MessageAdapter.ORM.plugin.SYS_ORM.class = com.cisco.msg.msgbus.outprocess.OutProcessClientPlugin
MessageAdapter.ORM.plugin.SYS_ORM.param.pluginType = OUT_PROCESS
MessageAdapter.ORM.plugin.SYS_ORM.param.adapterName = ORM
MessageAdapter.ORM.plugin.SYS_ORM.param.adapterType = OAMP
MessageAdapter.ORM.plugin.SYS_ORM.param.primaryServerHostname = 10.66.75.101
MessageAdapter.ORM.plugin.SYS_ORM.param.primaryServerPort = 23000
MessageAdapter.ORM.plugin.SYS_ORM.param.socketReadTimeout = 0
MessageAdapter.ORM.plugin.SYS_ORM.param.waitForApplication = 3
MessageAdapter.ORM.plugin.SYS_ORM.param.mirrorPluginName = MSGBUS_ORM3

6. في wrapper.conf، يضاف إعداد إضافة Java rmi.server:

# Java Additional Parameters
wrapper.java.additional.1= -Djavax.net.ssl.keyStore=C:/Cisco/CVP/conf/security/.ormKeystore
wrapper.java.additional.2= -Djavax.net.ssl.keyStorePassword=<NEED_TO_MODIFY>
wrapper.java.additional.3= -Djavax.net.ssl.keyStoreType=JCEKS
wrapper.java.additional.4= -Djavax.net.ssl.trustStore=C:/Cisco/CVP/conf/security/.keystore
wrapper.java.additional.5= -Djavax.net.ssl.trustStorePassword=<NEED_TO_MODIFY>
wrapper.java.additional.6= -Djavax.net.ssl.trustStoreType=JCEKS
wrapper.java.additional.7= -Dcom.sun.management.config.file=../conf/orm_jmx.properties
wrapper.java.additional.8= -Dccbu.logging.config.file=log4j_orm.xml
wrapper.java.additional.9= -Djava.rmi.server.hostname=10.66.75.101

 

ما المكونات التي نحتاج إليها للتحقق مما إذا كان خادم OAMP لا يمكنه الوصول إلى خادم الاتصال ل CVP؟

عند حفظ تكوين CVP من OAMP، يمكن عرض رسالة الخطأ هذه:

"تعذر الوصول إلى الجهاز بسبب انتهاء مهلة الاتصال"

من أجل توصيل OAMP بخادم المكالمات CVP، يحتاج OAMP إلى الاتصال بمنفذين في خادم المكالمات CVP، وهما 2099 (منفذ ثابت) ومنفذ RMI عشوائي (1024-65535).

أستخدم وحدة التحكم JCONSOLE لاختبار الاتصال (C:\Cisco\CVP\jre\bin\jconsole.exe):

إذا فشل الاختبار مع رسالة الخطأ هذه فشل الاتصال:إعادة المحاولة؟ فيجب التحقق من هذين المنفذين:

1. رقم المنفذ 2099
2. منفذ RMI العشوائي. (الذي قام نظام التشغيل بتخصيص المنفذ رقم 1042 في سرير الاختبار الخاص بنا).

هنا الخطأ رسالة عندما يمنع ميناء 1042:

فيما يلي التقاط الحزمة عندما يعمل إختبار وحدة التحكم بشكل صحيح:

بسبب هذا المنفذ العشوائي، لا يمكن نشر خادم وحدة تحكم عملية CVP خارج جدار حماية بينما توجد جميع مكونات CVP الموحدة الأخرى داخل جدار الحماية.

http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/customer_voice_portal/srnd/11_0/CCVP_BK_11366AC9_00_1101-design-guide/CCVP_BK_11366AC9_00_1101-design-guide_chapter_01100.html

وقد وصف هذا السلوك في هذا الخلل:

CSCve32007 - جدار الحماية بين خادم وحدة تحكم العمليات ومكونات CVP

للعثور على رقم RMI العشوائي، أستخدم الخطوات التالية:

الخطوة 1. أستخدم 2099 للعثور على رقم معرف العملية.

الخطوة 2. استعملت ال PID رقم أن يجد all the ميناء أن يكون استعملت.

مثال:

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

ما الملفات التي يتم تغييرها في عملية إعادة الصورة؟

بعد عملية إعادة الصورة، يتم تغيير أربعة ملفات:

• messageAdapter.properties
• بروبيتس
• orm.xml
• الأنظمة.الإصدارات

فيما يلي التغييرات لهذه الملفات الأربعة:

• في messageAdapter.properties، الملحقات التي تمت إضافتها في القسم السابق يتم حذفها
• في orm.propeties، تتم إزالة orm.controller.adapterName = CVPCTL3
• في orm.xml، يتم حذف جميع الأنظمة الفرعية التي تمت إضافتها في القسم السابق
• في system.propeties، تمت إضافة النظام الفرعي في القسم السابق
  

إذا قمت بالنقر فوق "حفظ ونشر" من صفحة OAMP، فلن يتم تحديث خادم مكالمات CVP، نظرا لأن OAMP لا يزال قيد الاستخدام مع معرف ناقل الرسائل يتصل بخادم الاتصال، ولكن خادم الاتصال لا يحتوي على معلومات ناقل الرسائل هذه.

بعد حذف خادم إستدعاء CVP من OAMP، يتم تغيير ثلاثة ملفات:

• مهايئ رسائل
• أورم 
• النظام

• ملف MessageAdaptor فارغ
  
• ORM يضيف هذا السطر orm.controller.adapterName = 
  
• ملف النظام يضيف سطر MessagingLayer.AdapterName =

عند إعادة إضافة خادم المكالمات CVP في OAMP، يتم تحديث التكوين في خادم المكالمات CVP.

 تكاد الملفات المحدثة تماثل عملية النشر من المرة الأولى، ماعدا الملف orm_jmx.

javax.net.debug = all
com.sun.management.jmxremote.ssl.need.client.auth = false
com.sun.management.jmxremote.authenticate = false
com.sun.management.jmxremote.port = 2099
com.sun.management.jmxremote.ssl = false

لذلك، يحذف ReImage معلومات ناقل الرسائل، مما يؤدي إلى عدم قدرة OAMP على تحديث خادم إستدعاءات CVP. لذلك، يجب حذف خادم Call للسماح لخادم Call بقبول تخصيص ناقل رسائل جديد. 

ملفات التكوين المرفقة والتقاط الحزم للرجوع إليها.