[KB7088] Apache Tomcatin määrittäminen ESET PROTECT On-Prem -verkkokonsolia varten käyttämällä tuettua JDK:ta (Windows)

HUOM:

Tämä sivu on käännetty tietokoneella. Klikkaa englantia tämän sivun Kielet-kohdassa näyttääksesi alkuperäisen tekstin. Jos jokin on epäselvää, ota yhteyttä paikalliseen tukeen.

 

Kysymys

Yksityiskohdat


Laajenna klikkaamalla

ESET PROTECT On-Prem -verkkokonsoli toimii Apache Tomcatissa, joka on Java-sovellusten verkkopalvelin ja servlet-säiliö. Apache Tomcat ei sisällä Java-ajoaikaa; se luottaa Java Development Kitin (JDK) tarjoamaan Java-ajoaikaan. Aikaisemmin Oracle JDK 8 (Java SE 8) oli Apache Tomcatin yleisimmin käytetty versio, joten monet käyttöönotot perustuivat siihen.

Tammikuusta 2019 alkaen Oracle muutti Java SE 8:n lisensointia. Yritys-, kaupalliseen tai tuotantokäyttöön tarkoitetut julkiset päivitykset edellyttävät nyt maksullista tilausta.

Jos käytät Oracle JDK 8:aa (Java SE 8) eikä sinulla ole Oraclen tilausta, voit siirtyä ilmaiseen, tuettuun vaihtoehtoon (kuten Amazon Corretto).

Tämä artikkeli kattaa Windows-asennukset. Linuxin osalta katso asiaan liittyvät oppaat JDK:n asentamisesta SUSE Linux Enterprise Server tai Debian.


Ratkaisu

Tuetut JDK- ja Apache Tomcat -versiot ESET PROTECT On-Prem -verkkokonsolille

ESET PROTECT On-Prem -verkkokonsolin käyttämiseen tarvitaan Java Development Kitin (JDK) tarjoama Java-runtime ja yhteensopiva Apache Tomcat -versio.

Suosittelemme asentamista:

  • Apache Tomcat 9.x. (viimeisin vakaa versio)
  • JDK 17 tai 21 (LTS)
    Lisätietoja JDK-versioista on jäljempänä kohdassa Tuetut JDK-versiot.
Yhteensopivuussuositukset
  • Poista aiemmat JDK-versiot: Jos useita JDK-versioita on asennettu, poista aiemmat versiot ja säilytä vain uusin tuettu JDK.
  • Sovita bittisyys: varmista, että JDK, Apache Tomcat ja ESET PROTECT On-Prem käyttävät samaa arkkitehtuuria (suositellaan 64-bittistä).
Tuetut JDK-versiot
Tuetut versiot

Vain pitkäaikaistuen (LTS) JDK-versiot ovat tuettuja.

Tuettu JDK-versio ESET PROTECT On-Prem -versio
17
10.x - 13.x
21
11.x - 13.x

Vaihtoehdot Oracle JDK: lle (ilmaiset jakelut):

  • Amazon Corretto 17 tai 21 (LTS)

    Asennusohjeet ovat kohdassa Amazon Corretto JDK:n asentaminen.

  • OpenJDK-pohjaiset jakelut - esimerkiksi Eclipse Temurin 17 tai 21 (LTS)

    Kun asennat OpenJDK-jakelua Windowsissa .msi-asennusohjelmalla, valitse ohjatussa asennuksessa (yleensä kohdassa Mukautettu asennus) vaihtoehto, jolla asetetaan tai ohitetaan JAVA_HOME-ympäristömuuttuja. Näin varmistetaan, että Javan asennuspolku rekisteröidään Windowsissa, jolloin Apache Tomcat voi etsiä JDK:n.

Vianmääritys "Failed to load data" -virheestä

Jos kohtaat "Failed to load data" -virheen käyttäessäsi JDK 17:ää tai uudempaa versiota, saat ohjeita kohdasta Korjaa "Failed to load data" -virhe JDK 17:llä tai uudemmalla versiolla.


Vaihda Apache Tomcatin käyttämää JDK-jakelua ESET PROTECT On-Prem -verkkokonsolissa

  1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi tomcat9w.exe. Suorita tiedosto kaksoisnapsauttamalla sitä. Apache Tomcat Properties avautuu.

  2. Napsauta Yleiset-välilehteä ja pysäytä Apache Tomcat -palvelu valitsemalla Pysäytä.

  3. Poista nykyinen JDK.

  4. Asenna uusi JDK.

  5. Palaa Apache Tomcatin ominaisuuksiin ja napsauta Java-välilehteä.

  6. Päivitä Java Virtual Machine -kentässä polku osoittamaan juuri asennetun JDK:n jvm.dll-tiedostoa (esimerkiksi Amazon Corretton tapauksessa C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

  7. Napsauta Yleiset-välilehteä ja käynnistä Apache Tomcat -palvelu napsauttamalla Käynnistä.

  8. Tarkista, että voit kirjautua ESET PROTECT On-Prem -verkkokonsoliin.


Asenna Amazon Corretto JDK

  1. Lataa Amazon Corretto 17:n tai Amazon Corretto 21:n Windows .msi -asennustiedosto.

  2. Aloita asennus kaksoisnapsauttamalla asennustiedostoa.

  3. Käy läpi asennusvaiheet.

    Sinulla on mahdollisuus asettaa mukautettu asennuspolku. Oletusarvoisesti Amazon Corretto 17 asennetaan osoitteeseen C:\Program Files\Amazon Corretto\. Jos asetat mukautetun polun, merkitse polku muistiin seuraavaa vaihetta varten.

  4. Kun asennus on valmis, aseta JAVA_HOME- ja PATH-ympäristömuuttujat.

    • Aseta JAVA_HOME Amazon Corretton asennushakemistoon.

      Esimerkkipolut:

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

      Rakennusnumerot voivat vaihdella

      Jokaisessa Amazon Corretton versiokansiossa (esimerkiksi jdk17.0.17_10) on build-numero, joka muuttuu uusien versioiden myötä. Tarkista aina todellinen kansion nimi asennuksen jälkeen osoitteesta C:\Program Files\Amazon Corretto.

    • Lisää %JAVA_HOME%\bin PATH:iin.

  5. Tarkista asennus. Suorita komentorivillä:

    java -version

    Sinun pitäisi nähdä seuraava tuloste (build-numerot voivat vaihdella):

    • Amazon Corretto 17:

      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, sekatila, jakaminen)
    • Amazon Corretto 21:

      openjdk versio "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, sekatila, jakaminen)

Korjaa "Failed to load data" -virhe JDK 17:n tai uudemman kanssa

Tämä ongelma ilmenee, kun ESET PROTECT On-Prem -verkkokonsolia käytetään Apache Tomcatissa uudemmilla JDK-versioilla (JDK 17 tai uudempi). Java 9:stä alkaen Java Platform Module System rajoittaa harkinnanvaraista pääsyä tiettyihin sisäisiin API-rajapintoihin, joita jotkin web-konsolin käyttämät kirjastot edellyttävät.

Tämän ratkaisemiseksi sinun on lisättävä Apache Tomcatin Java-konfiguraatioon erityisiä --add-opens-asetuksia, jotta näihin moduuleihin pääsee edelleen käsiksi. Voit lisätä vaihtoehdot Apache Tomcat -palvelun konfiguraation (tomcat9w.exe), catalina.bat- tai service.bat-tiedoston kautta.

Käynnistä Apache Tomcat -palvelu uudelleen jokaisen muutoksen jälkeen

Apache-palvelu on käynnistettävä uudelleen jokaisen .exe- tai .bat-tiedoston muutoksen jälkeen. Käynnistä palvelu uudelleen noudattamalla seuraavia ohjeita:

  1. Paina Windows-näppäintä, kirjoita Service ja avaa Services-sovellus.

  2. Napsauta Apache Tomcat -palvelua hiiren kakkospainikkeella oikeanpuoleisessa luettelossa.

  3. Valitse Restart (Käynnistä uudelleen).

Lisää --add-opens-vaihtoehdot Apache Tomcat -palvelun määrityksen kautta (tomcat9w.exe)
  1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi tomcat9w.exe. Suorita tiedosto kaksoisnapsauttamalla sitä.

  2. Napsauta Java-välilehteä ja lisää seuraavat arvot Java 9 Options -kenttään:

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

    Java 9 Options -kenttä sisältää nyt seuraavat arvot:

    --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. Napsauta OK.
Lisää --add-opens -vaihtoehdot catalina.bat-tiedostoon
  1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi catalina.bat-tiedosto. Avaa tiedosto tekstieditorilla.

  2. Etsi osio rem Configure JAVA 9 specific start-up parameters ja lisää seuraavat arvot:

    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"

    Rem Configure JAVA 9 specific start-up parameters -osio sisältää nyt seuraavat arvot:

    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. Tallenna muutokset.

Lisää --add-opens -vaihtoehdot service.bat-tiedostoon
  1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi service.bat-tiedosto. Avaa tiedosto tekstieditorilla.

  2. Siirry riville --JvmOptions9 ja muuta se seuraavasti:

    --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. Tallenna muutokset.