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

Sorun

• ESET PROTECT On-Prem Web Konsolu için desteklenen JDK ve Apache Tomcat sürümleri
• ESET PROTECT On-Prem 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 sonraki sürümlerde “Veriler yüklenemedi” hatasını düzeltme

Ayrıntılar

Çö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, bir Java Geliştirme Kiti (JDK) tarafından sağlanan bir Java çalışma ortamı ve uyumlu bir Apache Tomcat sürümüne ihtiyacınız vardır.

Aşağıdakileri 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ümleri 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)

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

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

  Windows'ta bir .msi yükleyicisi kullanarak bir OpenJDK dağıtımını yüklerken, Kurulum Sihirbazı'nda (genellikle Özel kurulum altında) JAVA_HOME ortam değişkenini ayarlama veya geçersiz kılma seçeneğini seçin. Bu, Java yükleme yolunun Windows'ta kaydedilmesini sağlar ve Apache Tomcat'ın 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. Dosyayı çift tıklayarak çalıştırın. Apache Tomcat Özellikleri penceresi 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, yolu yeni yüklenen JDK'nın jvm.dll dosyasına işaret edecek şekilde 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 Konsolu'na giriş yapabildiğinizi doğrulayın.

Amazon Corretto JDK'yı yükleyin

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

2. Yüklemeyi başlatmak için yükleme dosyasına çift tıklayın.

3. Yükleme adımlarını izleyin.

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

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

   • JAVA_HOME değişkenini 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
       
       

     Derleme numaraları değişebilir

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

   • PATH'e %JAVA_HOME%\bin ekleyin.

5. Kurulumu doğrulayın. Komut İstemi'nde şunu ç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 Çalışma Ortamı Corretto-17.0.17.10.1 (derleme 17.0.17+10-LTS)
     OpenJDK 64-Bit Sunucu VM Corretto-17.0.17.10.1 (derleme 17.0.17+10-LTS, karışık mod, paylaşımlı)
     

   • Amazon Corretto 21:

     openjdk sürümü "21.0.9" 2025-10-21 LTS
     OpenJDK Çalışma Zamanı Ortamı Corretto-21.0.9.11.1 (derleme 21.0.9+11-LTS)
     OpenJDK 64-Bit Sunucu VM Corretto-21.0.9.11.1 (derleme 21.0.9+11-LTS, karışık mod, paylaşımlı)

JDK 17 veya sonraki sürümlerde “Veriler yüklenemedi” hatasını düzeltme

Bu sorun, ESET PROTECT On-Prem Web Konsolu’nun Apache Tomcat üzerinde daha yeni JDK sürümleriyle (JDK 17 veya üstü) çalıştırılması durumunda ortaya çıkar. Java 9’dan itibaren, Java Platform Modül Sistemi, Web Konsolu tarafından kullanılan bazı kütüphanelerin gerektirdiği belirli dahili API’lere yansıtmalı erişimi kısıtlamaktadır.

Bu sorunu çözmek için, bu modüllere erişimin devam edebilmesi amacıyla Apache Tomcat’ın Java yapılandırmasına özel --add-opens seçeneklerini eklemeniz gerekir. Bu 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. Dosyayı çift tıklayarak çalıştırı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çeriyor:

   --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'ı 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 JAVA 9'a özgü başlangıç parametrelerini yapılandır " 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 yapılandırma " 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"
   "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED" ayarını yapın

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.