[KB7088] Desteklenen bir JDK (Windows) kullanarak ESET PROTECT On-Prem Web Konsolu için Apache Tomcat'i yapılandırma

Sorun

• ESET PROTECT On-Prem Web Konsolu için desteklenen JDK ve Apache Tomcat sürümleri
• ESET PROTECT Şirket İçi Web Konsolu için Apache Tomcat tarafından kullanılan JDK dağıtımını değiştirme
• Amazon Corretto JDK'yı yükleyin
• JDK 17 veya üstü ile "Veri yüklenemedi" hatasını düzeltme

Detaylar

Çözüm

ESET PROTECT On-Prem Web Konsolu için desteklenen JDK ve Apache Tomcat sürümleri

ESET PROTECT On-Prem Web Konsolu'nu çalıştırmak için Java Geliştirme Kiti (JDK) tarafından sağlanan bir Java çalışma zamanına ve uyumlu bir Apache Tomcat sürümüne ihtiyacınız vardır.

Yüklemenizi öneririz:

• Apache Tomcat 9.x. (en son kararlı sürüm)
• JDK 17 veya 21 (LTS)
  JDK sürümleri hakkında daha fazla bilgi için aşağıdaki Desteklenen JDK sürüm leri bölümüne bakın.

Desteklenen JDK sürümleri

Oracle JDK 'ya alternatifler (ücretsiz dağıtımlar):

• Amazon Corretto 17 veya 21 (LTS)

  Yükleme talimatları için Amazon Corretto JDK 'yı Yükleme bölümüne bakın.

• OpenJDK tabanlı dağıtımlar - örneğin, Eclipse Temurin 17 veya 21 (LTS)

  Windows'a bir OpenJDK dağıtımını bir .msi yükleyici kullanarak kurarken, Kurulum Sihirbazı'nda JAVA_HOME ortam değişkenini ayarlama veya geçersiz kılma seçeneğini belirleyin (genellikle Özel kurulum altında). Bu, Java yükleme yolunun Windows'ta kaydedilmesini sağlayarak Apache Tomcat'in JDK'yı bulmasına olanak tanır.

ESET PROTECT On-Prem Web Konsolu için Apache Tomcat tarafından kullanılan JDK dağıtımını değiştirme

1. Apache Tomcat klasörüne gidin (örneğin, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Bin klasörünü açın ve tomcat9w.exe dosyasını bulun. Çalıştırmak için dosyaya çift tıklayın. Apache Tomcat Özellikleri açılacaktır.

2. Genel sekmesine tıklayın ve Apache Tomcat hizmetini durdurmak için Durdur 'a tıklayın.

3. Mevcut JDK'nızı kaldırın.

4. Yeni bir JDK yükleyin.

5. Apache Tomcat Özellikleri'ne geri dönün ve Java sekmesine tıklayın.

6. Java Sanal Makinesi alanında, yeni yüklenen JDK'nın jvm.dll dosyasına işaret edecek şekilde yolu güncelleyin (örneğin, Amazon Corretto için, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Genel sekmesine tıklayın ve Apache Tomcat hizmetini başlatmak için Başlat 'a tıklayın.

8. ESET PROTECT On-Prem Web Konsolunuzda oturum açabildiğinizi doğrulayın.

Amazon Corretto JDK'yı yükleme

1. Amazon Corretto 17 veya Amazon Corretto 21 için Windows .msi kurulum dosyasını indirin.

2. Kurulumu başlatmak için kurulum dosyasına çift tıklayın.

3. Kurulum adımları boyunca ilerleyin.

   Özel bir kurulum yolu belirleme seçeneğiniz vardır. Varsayılan olarak, Amazon Corretto 17 C:\Program Files\Amazon Corretto\ konumuna yüklenir. Özel bir yol ayarlarsanız, bir sonraki adım için yolu not edin.

4. Kurulum tamamlandığında, JAVA_HOME ve PATH ortam değişkenlerini ayarlayın.

   • JAVA_HOME 'u Amazon Corretto kurulum dizinine ayarlayın.

     Örnek yollar:

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

     Yapı numaraları değişiklik gösterebilir

     Her Amazon Corretto sürüm klasörü (örneğin, jdk17.0.17_10) yeni sürümlerle değişen bir yapı numarası içerir. Kurulumdan sonra her zaman C:\Program Files\Amazon Corretto'daki gerçek klasör adını doğrulayın.

   • PATH'e %JAVA_HOME%\bin ekleyin.

5. Kurulumu doğrulayın. Komut İstemi'nde çalıştırın:

   java -version

   Aşağıdaki çıktıyı görmelisiniz (derleme numaraları değişebilir):

   • Amazon Corretto 17:

     openjdk sürümü "17.0.17" 2025-10-21 LTS OpenJDK Runtime Environment Corretto-17.0.17.10.1 (yapı 17.0.17+10-LTS) OpenJDK 64-Bit Server VM Corretto-17.0.17.10.1 (yapı 17.0.17+10-LTS, karma mod, paylaşım)

   • Amazon Corretto 21:

     openjdk sürümü "21.0.9" 2025-10-21 LTS OpenJDK Runtime Environment Corretto-21.0.9.11.1 (yapı 21.0.9+11-LTS) OpenJDK 64-Bit Server VM Corretto-21.0.9.11.1 (yapı 21.0.9+11-LTS, karma mod, paylaşım)

JDK 17 veya üstü ile "Veri yüklenemedi" hatasını düzeltme

Bu sorun, ESET PROTECT On-Prem Web Konsolu daha yeni JDK sürümleriyle (JDK 17 veya üstü) Apache Tomcat üzerinde çalıştığında ortaya çıkar. Java 9'dan başlayarak, Java Platform Modülü Sistemi, Web Konsolu tarafından kullanılan bazı kitaplıkların gerektirdiği belirli dahili API'lere yansıtıcı erişimi kısıtlar.

Bunu çözmek için, Apache Tomcat'in Java yapılandırmasına özel --add-opens seçenekleri eklemeniz gerekir, böylece bu modüller erişilebilir kalır. Seçenekleri Apache Tomcat hizmet yapılandırması (tomcat9w.exe), catalina.bat veya service.bat dosyası aracılığıyla ekleyebilirsiniz.

Apache Tomcat hizmet yapılandırması (tomcat9w.exe) aracılığıyla --add-opens seçeneklerini ekleyin

1. Apache Tomcat klasörüne gidin (örneğin, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Bin klasörünü açın ve tomcat9w.exe dosyasını bulun. Çalıştırmak için dosyaya çift tıklayın.

2. Java sekmesine tıklayın ve Java 9 Seçenekleri alanına aşağıdaki değerleri ekleyin:

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

   

   Java 9 Seçenekleri alanı artık aşağıdaki değerleri içermektedir:

   --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. Tamam'a tıklayın.

Catalina.bat dosyasına --add-opens seçeneklerini ekleyin

1. Apache Tomcat klasörüne gidin (örneğin, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Bin klasörünü açın ve catalina.bat dosyasını bulun. Dosyayı bir metin düzenleyicide açın.

2. Rem Configure JAVA 9 specific start-up parameters bölümünü bulun ve aşağıdaki değerleri ekleyin:
   

   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'a özgü başlangıç parametrelerini yeniden yapılandır bölümü artık aşağıdaki değerleri içermektedir:

   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. Değişiklikleri kaydedin.

Service.bat dosyasına --add-opens seçeneklerini ekleyin

1. Apache Tomcat klasörüne gidin (örneğin, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Bin klasörünü açın ve service.bat dosyasını bulun. Dosyayı bir metin düzenleyicide açın.

2. JvmOptions9 satırına gidin ve şu şekilde değiştirin:

   --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. Değişiklikleri kaydedin.