ترقية Apache Tomcat يدوياً (Windows)

يعد Apache Tomcat أحد المكونات اللازمة المطلوبة لتشغيل وحدة التحكم على شبكة الإنترنت ESET PROTECT. قم بترقية Apache Tomcat يدوياً في حال قمت بإجراء تثبيت Apache Tomcat الحالي يدوياً أو ليس لديك أحدث برنامج تثبيت شامل لـ ESET PROTECT.

قبل الترقية

• Apache Tomcat تتطلب 64-bit Java/OpenJDK. إذا كان لديك العديد من إصدارات Java مثبتة على النظام لديك، فنوصيك بإزالة تثبيت الإصدارات الأقدم من Java والاحتفاظ فقط بالإصدار الأحدث من Java المدعوم.

• افحص للتحقق من إصدار Apache Tomcat المستخدم حالياً.

1. انتقل إلى مجلد تثبيت Apache Tomcat:
   C:\Program Files\Apache Software Foundation\[ Tomcatمجلد ]\
2. افتح الملف RELEASE-NOTES في محرر نصي وتحقق من رقم الإصدار (على سبيل المثال 9.0.34).
3. إذا توفر إصدار مدعوم أكثر حداثة، فقم بإجراء الترقية.

إجراءات الترقية

1. أوقف خدمة Apache Tomcat: انتقل إلى بدء > الخدمات > وانقر بزر الماوس الأيمن فوق خدمة Apache Tomcat وحدد إيقاف.

قم بإغلاق Tomcat7w.exe إذا كان قيد التشغيل في منطقة إعلامات Windows لديك.

2. قم بنسخ الملفات التالية احتياطياً:

C:\Program Files\Apache Software Foundation\[ Tomcatمجلد ]\.keystore
C:\Program Files\Apache Software Foundation\[ Tomcatمجلد ]\conf\server.xml
C:\Program Files\Apache Software Foundation\[ Tomcatمجلد ]\webapps\era\WEB-INF\classes\sk\eset\era\g2webconsole\server\modules\config\EraWebServerConfig.properties

إذا كنت تستخدم مخزن شهادات SSL مخصص في مجلد Tomcat، فقم بنسخ هذه الشهادة احتياطياً أيضاً.

3. قم بإزالة تثبيت الإصدار الحالي من ‎Apache Tomcat.
4. احذف المجلد التالي إذا كان لا يزال موجوداً على النظام لديك:

C:\Program Files\Apache Software Foundation\[ Tomcatمجلد ]\

5. قم بتنزيل أحدث إصدار مدعوم من ملف برنامج تثبيت ‎‏Apache Tomcat (32-bit/64-bit Windows Service Installer) apache-tomcat-[الإصدار].exe من https://tomcat.apache.org.

6. ثبِّت الإصدار الأحدث من ‎Apache Tomcat الذي قمت بتنزيله.:

• إذا تم تثبيت المزيد من إصدارات Java، فحدد المسار إلى أحدث Java أثناء عملية التثبيت.
• عند اكتمال التثبيت، قم بإلغاء تحديد مربع الاختيار الموجود بجانب تشغيل Apache Tomcat.

7. قم باستعادة .keystore وserver.xml ، والشهادات المخصصة لموقعها الأصلي.
8. افتح الملف server.xml وتحقق من صحة المسار keystoreFile (قم بتحديث المسار إذا قمت بالترقية إلى إصدار رئيسي أعلى من Apache Tomcat):

keystoreFile="C:\Program Files\Apache Software Foundation\[ Tomcatمجلد ]\.keystore"

9. تأكد من تكوين اتصال HTTPS لـ Apache Tomcat لوحدة التحكم على شبكة الإنترنت ESET PROTECT بشكل صحيح.
10. انشر وحدة التحكم على شبكة الإنترنت ESET PROTECT (تثبيت وحدة التحكم على شبكة الإنترنت - Windows).
11. أعد ‎EraWebServerConfig.properties إلى مكانه الأصلي.
12. قم بتشغيل ‎Apache Tomcat واضبط Java VM صحيح:

1. انتقل إلى المجلد C:\Program Files\Apache Software Foundation\[ Tomcatمجلد ]\bin وقم بتشغيل Tomcat9w.exe.
2. في علامة التبويب عام قم بتعيين نوع الإعداد إلى تلقائي واضغط على بدء التشغيل.
3. انقر فوق علامة التبويب Java، إلغاء تحديد استخدام الافتراضي، وتأكد من أن الجهاز الظاهري من Java على مسار إلى ملف jvm.dll (راجع تعليمات قاعدة المعارف الموضحة) ثم انقر فوق موافق.

13. اتصل بوحدة التحكم على شبكة الإنترنت ESET PROTECT وتأكد من تحميل وحدة التحكم على شبكة الإنترنت بشكل صحيح.

استكشاف الأخطاء وإصلاحها

• إذا لم تنجح في إعداد اتصال HTTPS لـ Apache Tomcat، فيمكنك تخطي هذه الخطوة واستخدام اتصال HTTP مؤقتاً.
• إذا فشلت ترقية ‎Apache Tomcat، فثبِّت الإصدار الأصلي وطبّق التكوين من الخطوة رقم 2.
• تعمل وحدة تحكم الويب وترقية Apache Tomcat على مسح ملفات التعليمات دون اتصال. إذا استخدمت المساعدة دون اتصال باستخدام إصدار سابق من ESET PROTECT On-Prem، فأعد إنشائه لـ ESET PROTECT On-Prem 11.1 بعد الترقية لضمان حصولك على أحدث مساعدة دون اتصال تتوافق مع إصدار ESET PROTECT On-Prem لديك.