[KB7088] Konfigurasikan Apache Tomcat untuk Konsol Web On-Prem ESET PROTECT menggunakan JDK (Windows) yang didukung

CATATAN:

Halaman ini telah diterjemahkan oleh komputer. Klik Bahasa Inggris di bawah Bahasa pada halaman ini untuk menampilkan teks aslinya. Jika Anda menemukan sesuatu yang kurang jelas, silakan hubungi dukungan lokal Anda.

Masalah

Detail

Klik untuk memperluas

Konsol Web On-Prem ESET PROTECT berjalan di atas Apache Tomcat, sebuah server web dan wadah servlet untuk aplikasi Java. Apache Tomcat tidak menyertakan runtime Java; ia bergantung pada runtime Java yang disediakan oleh Java Development Kit (JDK). Secara historis, Oracle JDK 8 (Java SE 8) adalah versi yang paling banyak digunakan untuk Apache Tomcat, sehingga banyak penerapan yang bergantung padanya.

Mulai Januari 2019, Oracle mengubah lisensi untuk Java SE 8. Pembaruan publik untuk penggunaan bisnis, komersial, atau produksi sekarang memerlukan langganan berbayar.

Jika Anda menggunakan Oracle JDK 8 (Java SE 8) dan tidak memiliki langganan Oracle, Anda dapat beralih ke alternatif gratis yang didukung (seperti Amazon Corretto).

Artikel ini mencakup instalasi Windows. Untuk Linux, lihat panduan terkait tentang menginstal JDK untuk SUSE Linux Enterprise Server atau Debian.

Solusi

Versi JDK dan Apache Tomcat yang didukung untuk Konsol Web On-Prem ESET PROTECT

Untuk menjalankan Konsol Web On-Prem ESET PROTECT, Anda memerlukan runtime Java yang disediakan oleh Java Development Kit (JDK) dan versi Apache Tomcat yang kompatibel.

Kami sarankan untuk menginstal:

  • Apache Tomcat 9.x. (rilis stabil terbaru)
  • JDK 17 atau 21 (LTS)
    Untuk informasi lebih lanjut tentang versi JDK, lihat bagian Versi JDK yang didukung di bawah ini.
Rekomendasi kompatibilitas
  • Hapus versi JDK yang lebih lama: jika ada beberapa versi JDK yang terinstal, hapus instalan versi yang lebih lama dan simpan hanya JDK terbaru yang didukung.
  • Sesuaikan bitness: pastikan bahwa JDK, Apache Tomcat, dan ESET PROTECT On-Prem menggunakan arsitektur yang sama (disarankan 64-bit).
Versi JDK yang didukung
Rilis yang didukung

Hanya rilis JDK dukungan jangka panjang (LTS) yang didukung.

Versi JDK yang didukung Versi ESET PROTECT On-Prem
17
10.x - 13.x
21
11.x - 13.x

Alternatif untuk Oracle JDK (distribusi tanpa biaya):

  • Amazon Corretto 17 atau 21 (LTS)

    Untuk petunjuk instalasi, lihat bagian Menginstal Amazon Corretto JDK.

  • Distribusi berbasis OpenJDK-misalnya, Eclipse Temurin 17 atau 21 (LTS)

    Ketika menginstal distribusi OpenJDK pada Windows menggunakan pemasang .msi, pilih opsi untuk mengatur atau mengganti variabel lingkungan JAVA_HOME pada Setup Wizard (biasanya pada Custom setup). Hal ini memastikan jalur instalasi Java terdaftar pada Windows, sehingga memungkinkan Apache Tomcat menemukan JDK.

Memecahkan masalah kesalahan "Gagal memuat data"

Jika Anda mengalami kesalahan "Gagal memuat data" saat menggunakan JDK 17 atau yang lebih baru, lihat bagian Memperbaiki kesalahan "Gagal memuat data" dengan JDK 17 atau yang lebih baru untuk panduan.

Ganti distribusi JDK yang digunakan oleh Apache Tomcat untuk Konsol Web On-Prem ESET PROTECT

  1. Buka folder Apache Tomcat (misalnya, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Buka folder bin dan cari tomcat9w.exe. Klik dua kali pada berkas tersebut untuk menjalankannya. Apache Tomcat Properties akan terbuka.

  2. Klik tab General dan klik Stop untuk menghentikan layanan Apache Tomcat.

  3. Copot pemasangan JDK Anda saat ini.

  4. Instal JDK yang baru.

  5. Kembali ke Apache Tomcat Properties dan klik tab Java.

  6. Pada bidang Java Virtual Machine, perbarui path untuk mengarahkan ke file jvm.dll dari JDK yang baru terinstal (contohnya, untuk Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

  7. Klik tab General dan klik Start untuk memulai layanan Apache Tomcat.

  8. Verifikasi bahwa Anda bisa masuk ke Konsol Web On-Prem ESET PROTECT.

Instal Amazon Corretto JDK

  1. Unduh file instalasi Windows .msi untuk Amazon Corretto 17 atau Amazon Corretto 21.

  2. Klik dua kali file instalasi untuk memulai penginstalan.

  3. Lanjutkan melalui langkah-langkah instalasi.

    Anda memiliki opsi untuk mengatur jalur instalasi khusus. Secara default, Amazon Corretto 17 diinstal di C:\Program Files\Amazon Corretto\. Jika Anda menetapkan jalur khusus, catat jalur tersebut untuk langkah selanjutnya.

  4. Setelah penginstalan selesai, atur variabel lingkungan JAVA_HOME dan PATH.

    • Atur JAVA_HOME ke direktori instalasi Amazon Corretto.

      Contoh jalur:

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

      Nomor build dapat bervariasi

      Setiap folder versi Amazon Corretto (misalnya, jdk17.0.17_10) menyertakan nomor versi yang berubah seiring dengan rilis baru. Selalu verifikasi nama folder yang sebenarnya setelah instalasi di C:\Program Files\Amazon Corretto.

    • Tambahkan %JAVA_HOME%\bin ke PATH.

  5. Verifikasi penginstalan. Pada Command Prompt, jalankan:

    java -version

    Anda akan melihat keluaran berikut (nomor build mungkin berbeda):

    • Amazon Corretto 17:

      openjdk versi "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, mode campuran, berbagi)

    • Amazon Corretto 21:

      openjdk versi "21.0.9" 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, mode campuran, berbagi)

Memperbaiki kesalahan "Gagal memuat data" dengan JDK 17 atau yang lebih baru

Masalah ini terjadi ketika Konsol Web On-Prem ESET PROTECT berjalan di Apache Tomcat dengan versi JDK yang lebih baru (JDK 17 atau yang lebih baru). Dimulai dengan Java 9, Sistem Modul Platform Java membatasi akses reflektif ke API internal tertentu, yang dibutuhkan oleh beberapa pustaka yang digunakan oleh Konsol Web.

Untuk mengatasi hal ini, Anda perlu menambahkan opsi --add-opens khusus pada konfigurasi Java Apache Tomcat agar modul-modul ini tetap dapat diakses. Anda dapat menambahkan opsi tersebut melalui konfigurasi layanan Apache Tomcat (tomcat9w.exe), file catalina.bat atau service.bat.

Mulai ulang layanan Apache Tomcat setelah setiap perubahan

Anda perlu memulai ulang layanan Apache setelah setiap perubahan pada file .exe atau .bat. Untuk memulai ulang layanan, ikuti langkah-langkah berikut:

  1. Tekan tombol Windows, ketik Service dan buka aplikasi Services.

  2. Klik kanan Apache Tomcat pada daftar di sisi kanan.

  3. Klik Restart.

Menambahkan opsi --tambah-membuka melalui konfigurasi layanan Apache Tomcat (tomcat9w.exe)

  1. Buka folder Apache Tomcat (misalnya, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Buka folder bin dan cari tomcat9w.exe. Klik dua kali file tersebut untuk menjalankannya.

  2. Klik tab Java dan tambahkan nilai berikut pada kolom Java 9 Options:

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

    Bidang Opsi Java 9 sekarang berisi nilai-nilai berikut ini:

    --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. Klik OK.
Menambahkan opsi --add-opens pada catalina.bat

  1. Arahkan ke folder Apache Tomcat (misalnya, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Buka folder bin dan cari file catalina.bat. Buka file tersebut pada editor teks.

  2. Cari bagian Configure JAVA 9 specific start-up parameters dan tambahkan nilai berikut:

    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"

    Bagian Konfigurasi ulang parameter start-up spesifik JAVA 9 sekarang berisi nilai berikut:

    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. Simpan perubahan.

Tambahkan opsi --add-options di service.bat

  1. Arahkan ke folder Apache Tomcat (misalnya, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Buka folder bin dan cari berkas service.bat. Buka berkas tersebut pada sebuah editor teks.

  2. Arahkan ke baris --JvmOptions9 dan ubahlah menjadi:

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

  3. Simpan perubahan.

Terakhir diperbarui: 7 Jan 2026

Sumber daya tambahan

Panduan Pengguna

Forum ESET

Video YouTube
ESET Status Portal ESET Technical Support

Pelanggan yang sudah ada?