[KB7088] Ρύθμιση παραμέτρων του Apache Tomcat για την κονσόλα ιστού του ESET PROTECT On-Prem χρησιμοποιώντας ένα υποστηριζόμενο JDK (Windows)

Θέμα

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

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

Λύση

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

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

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

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

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

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

• 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. Κάντε κλικ στην καρτέλα «Γενικά» και, στη συνέχεια, κάντε κλικ στο κουμπί «Διακοπή» για να διακόψετε τη λειτουργία της υπηρεσίας 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.

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

1. Κατεβάστε το αρχείο εγκατάστασης .msi για Windows για το 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 17: C:\Program Files\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 version "17.0.17" 2025-10-21 LTS
     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, μικτή λειτουργία, κοινή χρήση)
     

   • Amazon Corretto 21:

     έκδοση openjdk "21.0.9" 21/10/2025 LTS
     Περιβάλλον εκτέλεσης OpenJDK Corretto-21.0.9.11.1 (έκδοση 21.0.9+11-LTS)
     OpenJDK 64-Bit Server VM Corretto-21.0.9.11.1 (έκδοση 21.0.9+11-LTS, μικτή λειτουργία, κοινή χρήση)

Διόρθωση του σφάλματος «Αποτυχία φόρτωσης δεδομένων» με JDK 17 ή νεότερη έκδοση

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

Για να το επιλύσετε, πρέπει να προσθέσετε ειδικές επιλογές --add-opens στη διαμόρφωση Java του Apache Tomcat, ώστε αυτά τα modules να παραμείνουν προσβάσιμα. Μπορείτε να προσθέσετε τις επιλογές μέσω της διαμόρφωσης της υπηρεσίας 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 »:

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

   

   Το πεδίο «Επιλογές 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"

   Η ενότητα «Ρύθμιση παραμέτρων εκκίνησης ειδικά για το JAVA 9» περιέχει πλέον τις ακόλουθες τιμές:

   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"
   ορίστε "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. Αποθηκεύστε τις αλλαγές.