[KB7088] Configurar Apache Tomcat para la consola web de ESET PROTECT On-Prem utilizando un JDK compatible (Windows)

Problema

• Versiones compatibles de JDK y Apache Tomcat para la consola web de ESET PROTECT On-Prem
• Cambiar la distribución de JDK utilizada por Apache Tomcat para la consola web de ESET PROTECT On-Prem
• Instalar el JDK de Amazon Corretto
• Solucionar el error «No se han podido cargar los datos» con JDK 17 o posterior

Detalles

Solución

Versiones compatibles de JDK y Apache Tomcat para la consola web de ESET PROTECT On-Prem

Para ejecutar la consola web de ESET PROTECT On-Prem, se necesita un entorno de ejecución de Java proporcionado por un kit de desarrollo de Java (JDK) y una versión compatible de Apache Tomcat.

Recomendamos instalar:

• Apache Tomcat 9.x. (última versión estable)
• JDK 17 o 21 (LTS)
  Para obtener más información sobre las versiones de JDK, consulta la sección «Versiones de JDK compatibles» más abajo.

Versiones de JDK compatibles

Alternativas a Oracle JDK (distribuciones gratuitas):

• Amazon Corretto 17 o 21 (LTS)

  Para obtener instrucciones de instalación, consulta la sección «Instalar el JDK de Amazon Corretto ».

• Distribuciones basadas en OpenJDK; por ejemplo, Eclipse Temurin 17 o 21 (LTS)

  Al instalar una distribución de OpenJDK en Windows mediante un instalador .msi, seleccione la opción para configurar o anular la variable de entorno JAVA_HOME en el asistente de configuración (normalmente en «Configuración personalizada»). Esto garantiza que la ruta de instalación de Java quede registrada en Windows, lo que permite a Apache Tomcat localizar el JDK.

Cambiar la distribución del JDK utilizada por Apache Tomcat para la consola web de ESET PROTECT On-Prem

1. Acceda a la carpeta de Apache Tomcat (por ejemplo, C:\Archivos de programa\Apache Software Foundation\Tomcat 9.0). Abra la carpeta «bin» y localice el archivo tomcat9w.exe. Haga doble clic en el archivo para ejecutarlo. Se abrirá la ventana «Propiedades de Apache Tomcat».

2. Haga clic en la pestaña «General» y, a continuación, en «Detener» para detener el servicio de Apache Tomcat.

3. Desinstala tu JDK actual.

4. Instala un nuevo JDK.

5. Vuelve a las «Propiedades de Apache Tomcat» y haz clic en la pestaña «Java ».

6. En el campo «Máquina virtual Java», actualice la ruta para que apunte al archivo jvm.dll del JDK recién instalado (por ejemplo, para Amazon Corretto, C:\Archivos de programa\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Haz clic en la pestaña «General» y, a continuación, en «Iniciar» para iniciar el servicio Apache Tomcat.

8. Comprueba que puedes iniciar sesión en la consola web de ESET PROTECT On-Prem.

Instalar el JDK de Amazon Corretto

1. Descarga el archivo de instalación .msi para Windows de Amazon Corretto 17 o Amazon Corretto 21.

2. Haz doble clic en el archivo de instalación para iniciar la instalación.

3. Sigue los pasos de instalación.

   Tiene la opción de establecer una ruta de instalación personalizada. De forma predeterminada, Amazon Corretto 17 se instala en C:\Archivos de programa\Amazon Corretto\. Si establece una ruta personalizada, anótela para el siguiente paso.

4. Cuando finalice la instalación, configura las variables de entorno JAVA_HOME y PATH.

   • Establece JAVA_HOME en el directorio de instalación de Amazon Corretto.

     Ejemplos de rutas:

     • Amazon Corretto 17: C:\Archivos de programa\Amazon Corretto\jdk17.0.17_10
     • Amazon Corretto 21: C:\Archivos de programa\Amazon Corretto\jdk21.0.9_11
       
       

     Los números de compilación pueden variar

     Cada carpeta de una versión de Amazon Corretto (por ejemplo, jdk17.0.17_10) incluye un número de compilación que cambia con cada nuevo lanzamiento. Comprueba siempre el nombre real de la carpeta tras la instalación en C:\Archivos de programa\Amazon Corretto.

   • Añade %JAVA_HOME%\bin a la variable PATH.

5. Comprueba la instalación. En el Símbolo del sistema, ejecuta:

   java -version

   Deberías ver el siguiente resultado (los números de compilación pueden variar):

   • Amazon Corretto 17:

     openjdk version "17.0.17" 2025-10-21 LTS
     OpenJDK Runtime Environment Corretto-17.0.17.10.1 (compilación 17.0.17+10-LTS)
     OpenJDK 64-Bit Server VM Corretto-17.0.17.10.1 (compilación 17.0.17+10-LTS, modo mixto, compartido)
     

   • Amazon Corretto 21:

     versión de OpenJDK «21.0.9» 21/10/2025 LTS
     Entorno de ejecución de OpenJDK Corretto-21.0.9.11.1 (compilación 21.0.9+11-LTS)
     Máquina virtual de servidor OpenJDK de 64 bits Corretto-21.0.9.11.1 (compilación 21.0.9+11-LTS, modo mixto, compartido)

Solución del error «No se han podido cargar los datos» con JDK 17 o posterior

Este problema se produce cuando la consola web de ESET PROTECT On-Prem se ejecuta en Apache Tomcat con versiones más recientes de JDK (JDK 17 o posterior). A partir de Java 9, el sistema de módulos de la plataforma Java restringe el acceso reflexivo a determinadas API internas, que requieren algunas bibliotecas utilizadas por la consola web.

Para resolverlo, es necesario añadir opciones especiales --add-opens a la configuración de Java de Apache Tomcat, de modo que se mantenga el acceso a estos módulos. Las opciones se pueden añadir a través de la configuración del servicio Apache Tomcat (tomcat9w.exe), el archivo catalina.bat o el archivo service.bat.

Añade las opciones --add-opens a través de la configuración del servicio Apache Tomcat (tomcat9w.exe)

1. Accede a la carpeta de Apache Tomcat (por ejemplo, C:\Archivos de programa\Apache Software Foundation\Tomcat 9.0). Abre la carpeta «bin» y busca el archivo tomcat9w.exe. Haz doble clic en el archivo para ejecutarlo.

2. Haz clic en la pestaña «Java » y añade los siguientes valores al campo «Opciones de Java 9 »:

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

   

   El campo «Opciones de Java 9 » contiene ahora los siguientes valores:

   --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. Haz clic en Aceptar.

Añade las opciones --add-opens en el archivo catalina.bat

1. Accede a la carpeta de Apache Tomcat (por ejemplo, C:\Archivos de programa\Apache Software Foundation\Tomcat 9.0). Abre la carpeta bin y busca el archivo catalina.bat. Abre el archivo en un editor de texto.

2. Busca la sección «rem Configurar parámetros de inicio específicos de JAVA 9 » y añade los siguientes valores:
   

   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"

   La sección «Configurar los parámetros de inicio específicos de Java 9» contiene ahora los siguientes valores:

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

3. Guarda los cambios.

Añade las opciones --add-opens en el archivo service.bat

1. Accede a la carpeta de Apache Tomcat (por ejemplo, C:\Archivos de programa\Apache Software Foundation\Tomcat 9.0). Abre la carpeta bin y localiza el archivo service.bat. Abre el archivo en un editor de texto.

2. Busca la línea --JvmOptions9 y cámbiala por:

   --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. Guarda los cambios.