المقدمة
يوضح هذا المستند كيفية ترقية Apache Tomcat يدويا على CCE.
المتطلبات الأساسية
المتطلبات
توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:
- Contact Center Enterprise (CCE)، الإصدار 12.6
- أباتشي تومكت
المكونات المستخدمة
تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:
- CCE، الإصدار 12.6
- أباتشي تومكات 9.x
تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.
الترقية
في معظم الحالات، يقوم تحديث TOMCAT باستخدام أداة Cisco Upgrade Tomcat المساعدة بحل مكامن الضعف. هناك أوقات عندما يفشل ترقية Tomcat، التشكيل فاسد، أو شخص جديد يقوم بتحديث Tomcat باستخدام الملفات التي يجدونها على الإنترنت.
تحذير: الرجاء أخذ لقطة للفيديو الشخصي قبل بدء هذا الإجراء. اتصل ب TAC للحصول على أي مساعدة.
قبل الترقية
-
تحميل مثبت Tomcat (Apache-tomcat-version.exe) من موقع Tomcat: http://archive.apache.org/dist/tomcat/tomcat-9/.
-
انسخ المثبت إلى الأجهزة الافتراضية الخاصة بمكون CCE الموحد. في هذه الترقية، أستخدمت الإصدار 9.0.89.

في هذا المختبر، تم إستخدام خادم AW لترقية Tomcat.
إزالة تثبيت Tomcat الحالي
الخطوة 1. إيقاف خدمة الموزع:

الخطوة 2. قم بإيقاف Tomcat، مسؤول IIS وخدمة الويب العالمية من Windows Services.msc.
Open Services.msc:




الخطوة 3. قم بإزالة تثبيت إصدار TOMCAT الموجود من إضافة/إزالة البرامج.
1. افتح لوحة التحكم > البرنامج والميزات > تحديد Tomcat:


2. انقر فوق إزالة التثبيت/التغيير:




تثبيت Tomcat
الخطوة 1. انسخ أداة تثبيت Apache Tomcat (ملف EXE) إلى c:\temp:

الخطوة 2. من CMD كمسؤول قم بتشغيل المثبت باستخدام هذا الأمر:
ملاحظة: يمكن أن يكون إصدارك مختلفا: C:\temp\apache-tomcat-9.0.89.exe /s /d=C:\icm\tomcat.

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

نسخ إحتياطي لمجلد Tomcat لحذف أدلة Tomcat
بمجرد اكتمال التثبيت، وقبل بدء العمل، يلزم نسخ مجلد Tomcat إحتياطيا في حالة الحاجة إلى البدء من جديد.
الخطوة 1. النسخ الاحتياطي لمجلد Tomcat الذي تم إنشاؤه:
c:\icm\tomcat
الخطوة 2. احذف الدليل، 'C:\icm\tomcat\webapps\docs'
الخطوة 3. احذف الدليل، 'C:\icm\tomcat\webapps\manager'
الخطوة 4. احذف الدليل،'C:\icm\tomcat\webapps\ROOT'
نسخ ملفات Tomcat
الخطوة 1. افتح CMD كمسؤول وقم بتشغيل هذه الاستعلامات الأربعة :
- نسخة /y C:\icm\bin\setup.war C:\icm\tomcat\webapps\setup.war
- نسخة /y C:\icm\install\unifiedconfig.war C:\icm\tomcat\webapps\unifiedconfig.war
- نسخة /y C:\icm\install\cceadmin.war C:\icm\tomcat\webapps\cceadmin.war
- نسخة /y C:\icm\install\ccbu-common-shindig-server.war C:\icm\tomcat\webapps\ROOT.war

الخطوة 2. من موجه الأوامر، قم بتنفيذ الخطوات التالية:
- "٪CCE_JAVA_HOME٪\bin\java" -cp C:\icm\bin unzip C:\icm\install\unifiedconfig-realm-assembly.zip C:\icm\tomcat\lib
- "٪CCE_JAVA_HOME٪\bin\java" -cp C:\icm\bin unzip C:\icm\install\shindig-cache-assembly.zip C:\icm\tomcat\lib

الخطوة 3. من موجه الأوامر، قم بتنفيذ هذه الخطوات لنسخ ملفات Jar من ICM إلى دليل TOMCAT:
- نسخة /y C:\icm\bin\catalina.properties C:\icm\tomcat\conf\catalina.properties
- نسخة /y C:\icm\bin\icm-websetup-shared.jar C:\icm\tomcat\lib\icm-websetup-shared.jar
- نسخة /y C:\icm\bin\registry.jar C:\icm\tomcat\lib\registry.jar
- نسخة /y C:\icm\bin\jntservices.jar C:\icm\tomcat\lib\jntservices.jar
- MD C:\icm\tomcat\bin\i386 (إنشاء الدليل)
- نسخة /y C:\icm\bin\isapi_redirect.dll C:\icm\tomcat\bin\i386\isapi_redirect.dll
- نسخة /y C:\icm\bin\web.xml C:\icm\tomcat\conf\web.xml
- نسخة /y C:\icm\bin\catalina-jmx-remote.jar C:\icm\tomcat\lib\catalina-jmx-remote.jar
- نسخة /y C:\icm\install\web.config C:\icm\tomcat\bin\i386\web.config
- نسخة /y C:\icm\bin\server.xml.IIS.custom C:\icm\tomcat\conf\server.xml

إضافة الملفات المفقودة
الخطوة 1. في الخطوة التالية، انقل فوق ملفين: uriWorkMap.properties and workers.properties من خادم يعمل، حيث يعمل تثبيت Tomcat بشكل صحيح.
1. لاحظ أن الملفين مفقودان.
2. انسخ الملفات المفقودة من خادم عامل.

الخطوة 2. أضف معلومات السجل المفقودة للخيارات في مفتاح تسجيل Apache tomcat.
هذه المعلومات خاصة ب ICM ولا تتم إضافتها بشكل افتراضي:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Processor 2.0\Tomcat9\Parameters\Java
المعلومات المضافة إلى الخيارات "المفتاح" التالية للسطر الأخير في "الخيارات". يجب إضافة السلسلة التالية بما في ذلك الواصلات الموجودة:
-dicm_root=C:\icm
-dcom.sun.management.jmxremote.ssl.need.client.auth=false
-dcom.sun.management.jmxremote.authenticate=false
-dcom.sun.management.jmxremote.port=1299
-dcom.sun.management.jmxremote.ssl=false
-xx:MaxPermSize=128m
-dfile.encoding=utf8
-dclient.encoding.override=utf-8

تمكين التوريث وبدء خدمة Tomcat
الخطوة 1. تتمثل الخطوة الأخيرة قبل بدء تشغيل خدمة FromCat و IIS في التحقق من صحة التوريث للمجلد. إذا فاتك هذه الخطوة، يتم إرجاع خطأ خادم داخلي 500 عند محاولة IIS إستخدام ملف isapi.dll المعاد توجيهه.
بما أن IIS لم يعد لديه أذونات لمجلد Tomcat:
- انتقل إلى c:\icm\
- ابحث عن المجلد Tomcat.
- انقر بزر الماوس الأيمن وحدد خصائص.
- أختر التأمين > المتقدم.
- انقر على تمكين التوريث.
- انقر فوق تطبيق.
حقوق المستخدم الموروثة من c:\icm.


الخطوة 2. تحقق من تثبيت الإصدار المحدث من خلال تشغيل الأمر version:

الخطوة 3. بدء تشغيل خدمة الموزع.

الخطوة 4. ابدأ تشغيل Apache Tomcat و IIS وخدمة الويب العالمية من services.msc:



التحقق من الصحة
التحقق من صحة ما إذا كانت صفحة cAdmin تقوم بالتحميل دون مشاكل ويمكن تسجيل الدخول:
