[KB7088] Konfiguracja serwera Apache Tomcat dla konsoli internetowej ESET PROTECT On-Prem przy użyciu obsługiwanej wersji JDK (Windows)

Problem

• Obsługiwane wersje JDK i Apache Tomcat dla konsoli internetowej ESET PROTECT On-Prem
• Zmiana dystrybucji JDK używanej przez Apache Tomcat dla konsoli internetowej ESET PROTECT On-Prem
• Zainstaluj JDK Amazon Corretto
• Napraw błąd „Nie udało się załadować danych” w przypadku JDK 17 lub nowszym

Szczegóły

Rozwiązanie

Obsługiwane wersje JDK i Apache Tomcat dla konsoli internetowej ESET PROTECT On-Prem

Aby uruchomić konsolę internetową ESET PROTECT On-Prem, potrzebne jest środowisko uruchomieniowe Java zapewniane przez zestaw Java Development Kit (JDK) oraz zgodna wersja serwera Apache Tomcat.

Zalecamy zainstalowanie:

• Apache Tomcat 9.x. (najnowsza stabilna wersja)
• JDK 17 lub 21 (LTS)
  Więcej informacji na temat wersji JDK można znaleźć w sekcji „Obsługiwane wersje JDK ” poniżej.

Obsługiwane wersje JDK

Alternatywy dla Oracle JDK (bezpłatne dystrybucje):

• Amazon Corretto 17 lub 21 (LTS)

  Instrukcje instalacji znajdują się w sekcji Instalacja Amazon Corretto JDK.

• Dystrybucje oparte na OpenJDK — na przykład Eclipse Temurin 17 lub 21 (LTS)

  Podczas instalacji dystrybucji OpenJDK w systemie Windows za pomocą instalatora .msi należy w kreatorze instalacji (zazwyczaj w sekcji „Konfiguracja niestandardowa”) wybrać opcję ustawienia lub nadpisania zmiennej środowiskowej JAVA_HOME. Zapewni to zarejestrowanie ścieżki instalacji Javy w systemie Windows, co pozwoli serwerowi Apache Tomcat na zlokalizowanie środowiska JDK.

Zmiana dystrybucji JDK używanej przez Apache Tomcat dla konsoli internetowej ESET PROTECT On-Prem

1. Przejdź do folderu Apache Tomcat (na przykład C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otwórz folder bin i znajdź plik tomcat9w.exe. Kliknij dwukrotnie ten plik, aby go uruchomić. Otworzy się okno właściwości serwera Apache Tomcat.

2. Kliknij kartę Ogólne, a następnie kliknij przycisk Zatrzymaj, aby zatrzymać usługę Apache Tomcat.

3. Odinstaluj aktualną wersję JDK.

4. Zainstaluj nowe środowisko JDK.

5. Wróć do okna „Właściwości Apache Tomcat” i kliknij kartę „Java ”.

6. W polu „Java Virtual Machine” zaktualizuj ścieżkę, aby wskazywała plik jvm.dll nowo zainstalowanego pakietu JDK (na przykład dla Amazon Corretto: C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Przejdź do zakładki „Ogólne” i kliknij przycisk „Uruchom”, aby uruchomić usługę Apache Tomcat.

8. Sprawdź, czy możesz zalogować się do konsoli internetowej ESET PROTECT On-Prem.

Zainstaluj środowisko JDK Amazon Corretto

1. Pobierz plik instalacyjny .msi dla systemu Windows dla Amazon Corretto 17 lub Amazon Corretto 21.

2. Kliknij dwukrotnie plik instalacyjny, aby rozpocząć instalację.

3. Postępuj zgodnie z instrukcjami instalacji.

   Możesz ustawić własną ścieżkę instalacji. Domyślnie Amazon Corretto 17 jest instalowany w katalogu C:\Program Files\Amazon Corretto\. Jeśli ustawisz własną ścieżkę, zapisz ją na potrzeby kolejnego kroku.

4. Po zakończeniu instalacji ustaw zmienne środowiskowe JAVA_HOME i PATH.

   • Ustaw zmienną JAVA_HOME na katalog instalacyjny Amazon Corretto.

     Przykładowe ścieżki:

     • Amazon Corretto 17: C:\Program Files\Amazon Corretto\jdk17.0.17_10
     • Amazon Corretto 21: C:\Program Files\Amazon Corretto\jdk21.0.9_11
       
       

     Numery kompilacji mogą się różnić

     Każdy folder wersji Amazon Corretto (na przykład jdk17.0.17_10) zawiera numer kompilacji, który zmienia się wraz z nowymi wydaniami. Po instalacji zawsze sprawdź rzeczywistą nazwę folderu w lokalizacji C:\Program Files\Amazon Corretto.

   • Dodaj %JAVA_HOME%\bin do zmiennej PATH.

5. Sprawdź instalację. W wierszu poleceń uruchom:

   java -version

   Powinieneś zobaczyć następujący wynik (numery kompilacji mogą się różnić):

   • Amazon Corretto 17:

     openjdk version "17.0.17" 2025-10-21 LTS
     OpenJDK Runtime Environment Corretto-17.0.17.10.1 (kompilacja 17.0.17+10-LTS)
     OpenJDK 64-Bit Server VM Corretto-17.0.17.10.1 (kompilacja 17.0.17+10-LTS, tryb mieszany, współdzielenie)
     

   • Amazon Corretto 21:

     wersja OpenJDK „21.0.9” 2025-10-21 LTS
     Środowisko uruchomieniowe OpenJDK Corretto-21.0.9.11.1 (kompilacja 21.0.9+11-LTS)
     64-bitowa maszyna wirtualna serwera OpenJDK Corretto-21.0.9.11.1 (kompilacja 21.0.9+11-LTS, tryb mieszany, współdzielenie)

Naprawiono błąd „Nie udało się załadować danych” w przypadku JDK 17 lub nowszych

Problem ten występuje, gdy konsola internetowa ESET PROTECT On-Prem działa na serwerze Apache Tomcat z nowszymi wersjami JDK (JDK 17 lub nowsze). Począwszy od Javy 9, system modułów platformy Java (Java Platform Module System) ogranicza dostęp refleksyjny do niektórych wewnętrznych interfejsów API, których wymagają niektóre biblioteki używane przez konsolę internetową.

Aby rozwiązać ten problem, należy dodać specjalne opcje --add-opens do konfiguracji Java serwera Apache Tomcat, tak aby moduły te pozostały dostępne. Opcje te można dodać poprzez konfigurację usługi Apache Tomcat (tomcat9w.exe) oraz pliki catalina.bat lub service.bat.

Dodaj opcje --add-opens poprzez konfigurację usługi Apache Tomcat (tomcat9w.exe)

1. Przejdź do folderu Apache Tomcat (na przykład C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otwórz folder „bin” i znajdź plik tomcat9w.exe. Kliknij dwukrotnie ten plik, aby go uruchomić.

2. Kliknij kartę „Java ” i dodaj następujące wartości w polu „Opcje Java 9 ”:

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

   

   Pole „Java 9 Options ” zawiera teraz następujące wartości:

   --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. Kliknij OK.

Dodaj opcje --add-opens w pliku catalina.bat

1. Przejdź do folderu Apache Tomcat (na przykład C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otwórz folder bin i znajdź plik catalina.bat. Otwórz plik w edytorze tekstowym.

2. Znajdź sekcję „rem Configure JAVA 9 specific start-up parameters ” i dodaj następujące wartości:
   

   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"

   Sekcja „Konfiguracja parametrów uruchamiania specyficznych dla JAVA 9 ” zawiera teraz następujące wartości:

   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"
   ustaw „JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED”
   ustaw „JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED”

3. Zapisz zmiany.

Dodaj opcje --add-opens w pliku service.bat

1. Przejdź do folderu Apache Tomcat (na przykład C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otwórz folder bin i znajdź plik service.bat. Otwórz plik w edytorze tekstowym.

2. Przejdź do wiersza --JvmOptions9 i zmień go na:

   --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. Zapisz zmiany.