[KB7088] Διαμόρφωση του Apache Tomcat για την ESET PROTECT On-Prem Web Console χρησιμοποιώντας ένα υποστηριζόμενο JDK (Windows)

Τεύχος

• Υποστηριζόμενες εκδόσεις JDK και Apache Tomcat για την ESET PROTECT On-Prem Web Console
• Εναλλαγή της διανομής JDK που χρησιμοποιείται από τον Apache Tomcat για την ESET PROTECT On-Prem Web Console
• Εγκαταστήστε το Amazon Corretto JDK
• Διορθώστε το σφάλμα "Αποτυχία φόρτωσης δεδομένων" με JDK 17 ή νεότερη έκδοση

Λεπτομέρειες

Λύση

Υποστηριζόμενες εκδόσεις JDK και Apache Tomcat για την κονσόλα Web ESET PROTECT On-Prem

Για να εκτελέσετε την ESET PROTECT On-Prem Web Console, χρειάζεστε ένα Java runtime που παρέχεται από ένα Java Development Kit (JDK) και μια συμβατή έκδοση του Apache Tomcat.

Συνιστούμε να εγκαταστήσετε:

• Apache Tomcat 9.x. (τελευταία σταθερή έκδοση)
• JDK 17 ή 21 (LTS)
  Για περισσότερες πληροφορίες σχετικά με τις εκδόσεις JDK, ανατρέξτε στην ενότητα Υποστηριζόμενες εκδόσεις JDK παρακάτω.

Υποστηριζόμενες εκδόσεις JDK

Εναλλακτικές λύσεις για το Oracle JDK (διανομές χωρίς κόστος):

• (LTS): Amazon Corretto 17 ή 21 (LTS)

  Για οδηγίες εγκατάστασης, ανατρέξτε στην ενότητα Εγκατάσταση του Amazon Corretto JDK.

• Διανομές που βασίζονται στο OpenJDK - για παράδειγμα, Eclipse Temurin 17 ή 21 (LTS)

  Όταν εγκαθιστάτε μια διανομή OpenJDK στα Windows χρησιμοποιώντας ένα πρόγραμμα εγκατάστασης .msi, επιλέξτε την επιλογή για τον ορισμό ή την παράκαμψη της μεταβλητής περιβάλλοντος JAVA_HOME στον Οδηγό εγκατάστασης (συνήθως στην ενότητα Προσαρμοσμένη εγκατάσταση). Αυτό διασφαλίζει ότι η διαδρομή εγκατάστασης της Java είναι καταχωρημένη στα Windows, επιτρέποντας στον Apache Tomcat να εντοπίσει το JDK.

Αλλαγή της διανομής JDK που χρησιμοποιείται από τον Apache Tomcat για την ESET PROTECT On-Prem Web Console

1. Πλοηγηθείτε στο φάκελο Apache Tomcat (για παράδειγμα, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ανοίξτε το φάκελο bin και εντοπίστε το tomcat9w.exe. Κάντε διπλό κλικ στο αρχείο για να το εκτελέσετε. Θα ανοίξουν οι ιδιότητες του Apache Tomcat.

2. Κάντε κλικ στην καρτέλα General (Γενικά ) και κάντε κλικ στην επιλογή Stop (Διακοπή ) για να σταματήσετε την υπηρεσία Apache Tomcat.

3. Απεγκαταστήστε το τρέχον JDK.

4. Εγκαταστήστε ένα νέο JDK.

5. Επιστρέψτε στις Ιδιότητες του Apache Tomcat και κάντε κλικ στην καρτέλα Java.

6. Στο πεδίο Java Virtual Machine, ενημερώστε τη διαδρομή ώστε να δείχνει στο αρχείο jvm.dll του πρόσφατα εγκατεστημένου JDK (για παράδειγμα, για το Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Κάντε κλικ στην καρτέλα General (Γενικά ) και κάντε κλικ στην επιλογή Start (Έναρξη ) για να εκκινήσετε την υπηρεσία Apache Tomcat.

8. Βεβαιωθείτε ότι μπορείτε να συνδεθείτε στη διαδικτυακή κονσόλα ESET PROTECT On-Prem.

Εγκαταστήστε το Amazon Corretto JDK

1. Πραγματοποιήστε λήψη του αρχείου εγκατάστασης Windows .msi για το Amazon Corretto 17 ή το Amazon Corretto 21.

2. Κάντε διπλό κλικ στο αρχείο εγκατάστασης για να ξεκινήσει η εγκατάσταση.

3. Προχωρήστε στα βήματα της εγκατάστασης.

   Έχετε τη δυνατότητα να ορίσετε μια προσαρμοσμένη διαδρομή εγκατάστασης. Από προεπιλογή, το Amazon Corretto 17 εγκαθίσταται στη διεύθυνση C:\Program Files\Amazon Corretto\. Εάν ορίσετε μια προσαρμοσμένη διαδρομή, σημειώστε τη διαδρομή για το επόμενο βήμα.

4. Όταν ολοκληρωθεί η εγκατάσταση, ορίστε τις μεταβλητές περιβάλλοντος JAVA_HOME και PATH.

   • Ορίστε το JAVA_HOME στον κατάλογο εγκατάστασης του Amazon Corretto.

     Παράδειγμα μονοπατιών:

     • Αρχεία προγραμμάτων\Amazon Corretto\jdk17.0.17_10
     • Amazon Corretto 21: C:\Program Files\Amazon Corretto\jdk21.0.9_11
       
       

     Οι αριθμοί κατασκευής ενδέχεται να διαφέρουν

     Κάθε φάκελος έκδοσης του Amazon Corretto (για παράδειγμα, jdk17.0.17_10) περιλαμβάνει έναν αριθμό κατασκευής που αλλάζει με τις νέες εκδόσεις. Ελέγχετε πάντα το πραγματικό όνομα του φακέλου μετά την εγκατάσταση στο C:\Program Files\Amazon Corretto.

   • Προσθέστε το %JAVA_HOME%\bin στο PATH.

5. Επαληθεύστε την εγκατάσταση. Στην γραμμή εντολών, εκτελέστε:

   java -version

   Θα πρέπει να δείτε την ακόλουθη έξοδο (οι αριθμοί κατασκευής ενδέχεται να διαφέρουν):

   • Amazon Corretto 17:

     openJDK Runtime Environment Corretto-17.0.17.10.1 (build 17.0.17+10-LTS) OpenJDK 64-Bit Server VM Corretto-17.0.17.10.1 (build 17.0.17+10-LTS, mixed mode, sharing)

   • Amazon Corretto 21:

     2025-10-21 LTS OpenJDK Runtime Environment Corretto-21.0.9.11.1 (build 21.0.9+11-LTS) OpenJDK 64-Bit Server VM Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, mixed mode, sharing)

Διόρθωση του σφάλματος "Failed to load data" με JDK 17 ή νεότερη έκδοση

Αυτό το πρόβλημα εμφανίζεται όταν η Κονσόλα Web του ESET PROTECT On-Prem εκτελείται σε Apache Tomcat με νεότερες εκδόσεις JDK (JDK 17 ή νεότερη). Ξεκινώντας από τη Java 9, το Java Platform Module System περιορίζει την ανακλαστική πρόσβαση σε ορισμένα εσωτερικά API, τα οποία απαιτούν ορισμένες βιβλιοθήκες που χρησιμοποιούνται από την Κονσόλα Web.

Για να επιλύσετε αυτό το πρόβλημα, πρέπει να προσθέσετε ειδικές επιλογές --add-opens στη ρύθμιση παραμέτρων Java του Apache Tomcat, ώστε αυτές οι ενότητες να παραμείνουν προσβάσιμες. Μπορείτε να προσθέσετε τις επιλογές μέσω της διαμόρφωσης της υπηρεσίας Apache Tomcat (tomcat9w.exe), του αρχείου catalina.bat ή του αρχείου service.bat.

Προσθήκη επιλογών --add-opens μέσω των ρυθμίσεων της υπηρεσίας Apache Tomcat (tomcat9w.exe)

1. Πλοηγηθείτε στο φάκελο Apache Tomcat (για παράδειγμα, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ανοίξτε το φάκελο bin και εντοπίστε το tomcat9w.exe. Κάντε διπλό κλικ στο αρχείο για να το εκτελέσετε.

2. Κάντε κλικ στην καρτέλα Java και προσθέστε τις ακόλουθες τιμές στο πεδίο Java 9 Options:

   ---add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/java.util.concurrent=ALL-UNNAMED

   

   Το πεδίο Java 9 Options (Επιλογές Java 9 ) περιέχει τώρα τις ακόλουθες τιμές:

   ---add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/java.io=ALL-UNNAMED --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/java.util.concurrent=ALL-UNNAMED --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED

3. Κάντε κλικ στο OK.

Προσθέστε τις επιλογές --add-opens στο catalina.bat

1. Πλοηγηθείτε στο φάκελο Apache Tomcat (για παράδειγμα, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ανοίξτε το φάκελο bin και εντοπίστε το αρχείο catalina.bat. Ανοίξτε το αρχείο σε έναν επεξεργαστή κειμένου.

2. Εντοπίστε την ενότητα rem Configure JAVA 9 specific start-up parameters και προσθέστε τις ακόλουθες τιμές:
   

   set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util=ALL-UNNAMED" set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED"

   Η ενότητα rem Configure JAVA 9 specific start-up parameters περιέχει τώρα τις ακόλουθες τιμές:

   set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.lang=ALL-UNNAMED" set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.io=ALL-UNNAMED" set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util=ALL-UNNAMED" set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED" set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED"

3. Αποθηκεύστε τις αλλαγές.

Προσθέστε τις επιλογές --add-opens στο αρχείο service.bat

1. Πλοηγηθείτε στο φάκελο Apache Tomcat (για παράδειγμα, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ανοίξτε το φάκελο bin και εντοπίστε το αρχείο service.bat. Ανοίξτε το αρχείο σε έναν επεξεργαστή κειμένου.

2. Πλοηγηθείτε στη γραμμή --JvmOptions9 και αλλάξτε την σε:

   --JvmOptions9 "--add-opens=java.base/java.lang=ALL-UNNAMED#--add-opens=java.base/java.io=ALL-UNNAMED#--add-opens=java.base/java.util=ALL-UNNAMED#--add-opens=java.base/java.util.concurrent=ALL-UNNAMED#--add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED" ^

3. Αποθηκεύστε τις αλλαγές.