[KB7088] Configurar Apache Tomcat para ESET PROTECT On-Prem Web Console utilizando un JDK compatible (Windows)

NOTA:

Esta página ha sido traducida por un ordenador. Haga clic en Inglés bajo Idiomas en esta página para mostrar el texto original. Si encuentra algo que no está claro, por favor, póngase en contacto con su soporte local.

Problema

Detalles


Haga clic para ampliar

ESET PROTECT On-Prem Web Console se ejecuta en Apache Tomcat, un servidor web y contenedor de servlets para aplicaciones Java. Apache Tomcat no incluye un tiempo de ejecución de Java; depende del tiempo de ejecución de Java proporcionado por un kit de desarrollo de Java (JDK). Históricamente, Oracle JDK 8 (Java SE 8) era la versión más utilizada para Apache Tomcat, por lo que muchas implementaciones dependían de ella.

A partir de enero de 2019, Oracle cambió sus licencias para Java SE 8. Las actualizaciones públicas para uso empresarial, comercial o de producción ahora requieren una suscripción de pago.

Si utiliza Oracle JDK 8 (Java SE 8) y no tiene una suscripción de Oracle, puede cambiar a una alternativa gratuita y compatible (como Amazon Corretto).

Este artículo trata de las instalaciones en Windows. Para Linux, consulte las guías relacionadas sobre la instalación de un JDK para SUSE Linux Enterprise Server o Debian.


Solución

Versiones compatibles de JDK y Apache Tomcat para ESET PROTECT On-Prem Web Console

Para ejecutar ESET PROTECT On-Prem Web Console, necesita un Java runtime proporcionado por un Java Development Kit (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, consulte la sección Versiones de JDK compatibles a continuación.
Recomendaciones de compatibilidad
  • Elimine las versiones JDK anteriores: si hay varias versiones JDK instaladas, desinstale las versiones anteriores y conserve sólo la última versión JDK compatible.
  • Coincidencia de bits: asegúrese de que el JDK, Apache Tomcat y ESET PROTECT On-Prem utilizan la misma arquitectura (se recomienda 64 bits).
Versiones JDK compatibles
Versiones compatibles

Sólo se admiten versiones JDK de soporte a largo plazo (LTS).

Versión de JDK admitida Versión de ESET PROTECT On-Prem
17
10.x - 13.x
21
11.x - 13.x

Alternativas a Oracle JDK (distribuciones sin coste):

  • Amazon Corretto 17 o 21 (LTS)

    Para obtener instrucciones de instalación, consulte 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 OpenJDK en Windows mediante un instalador .msi, seleccione la opción para establecer o anular la variable de entorno JAVA_HOME en el Asistente de instalación (normalmente en Configuración personalizada). Esto asegura que la ruta de instalación de Java está registrada en Windows, permitiendo a Apache Tomcat localizar el JDK.

Solución del error "Error al cargar datos

Si se encuentra con el error "Error al cargar datos" al utilizar JDK 17 o posterior, consulte la sección Solución del error "Error al cargar datos" con JDK 17 o posterior.


Cambiar la distribución de JDK utilizada por Apache Tomcat para ESET PROTECT On-Prem Web Console

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

  2. Haga clic en la pestaña General y en Detener para detener el servicio Apache Tomcat.

  3. Desinstale su JDK actual.

  4. Instale un nuevo JDK.

  5. Vuelva a Propiedades de Apache Tomcat y haga 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. Haga clic en la pestaña General y haga clic en Iniciar para iniciar el servicio Apache Tomcat.

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


Instale el JDK de Amazon Corretto

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

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

  3. Siga los pasos de instalación.

    Tienes la opción de establecer una ruta de instalación personalizada. Por defecto, Amazon Corretto 17 se instala en C:Archivos de programa Amazon Corretto. Si establece una ruta personalizada, tome nota de la ruta para el siguiente paso.

  4. Una vez finalizada la instalación, defina las variables de entorno JAVA_HOME y PATH.

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

      Ejemplo 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 versión de Amazon Corretto (por ejemplo, jdk17.0.17_10) incluye un número de compilación que cambia con las nuevas versiones. Comprueba siempre el nombre real de la carpeta tras la instalación en C:Archivos de programa de Amazon Corretto.

    • Añada %JAVA_HOME%\bin al PATH.

  5. Verifique la instalación. En el símbolo del sistema, ejecute

    java -version

    Deberías ver la siguiente salida (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 (build 17.0.17+10-LTS) OpenJDK 64-Bit Server VM Corretto-17.0.17.10.1 (build 17.0.17+10-LTS, mixed mode, sharing)
    • Amazon Corretto 21:

      openjdk version "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, mixed mode, sharing)

Corrección del error "Failed to load data" con JDK 17 o posterior

Este problema se produce cuando ESET PROTECT On-Prem Web Console se ejecuta en Apache Tomcat con versiones JDK más recientes (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 resolver esto, es necesario añadir opciones especiales --add-opens a la configuración Java de Apache Tomcat para que estos módulos sigan siendo accesibles. Puede añadir las opciones a través de la configuración del servicio Apache Tomcat (tomcat9w.exe), el archivo catalina.bat o service.bat.

Reiniciar el servicio Apache Tomcat después de cada cambio

Es necesario reiniciar el servicio Apache después de cada cambio en los archivos .exe o .bat. Para reiniciar el servicio, siga estos pasos:

  1. Pulse la tecla de Windows, escriba Servicio y abra la aplicación Servicios.

  2. Haga clic con el botón derecho en Apache Tomcat en la lista de la derecha.

  3. Haga clic en Reiniciar.

Añadir opciones --add-opens mediante la configuración del servicio Apache Tomcat (tomcat9w.exe)
  1. Navegue hasta la carpeta de Apache Tomcat (por ejemplo, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Abra la carpeta bin y localice tomcat9w.exe. Haga doble clic en el archivo para ejecutarlo.

  2. Haga clic en la pestaña Java y añada 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
    Figura 1-1

    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. Haga clic en Aceptar.
Añadir opciones --add-opens en catalina.bat
  1. Vaya a la carpeta de Apache Tomcat (por ejemplo, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Abra la carpeta bin y localice el archivo catalina.bat. Abra el archivo en un editor de texto.

  2. Localice la sección rem Configurar parámetros de arranque específicos de JAVA 9 y añada 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 rem Configurar parámetros de arranque 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" 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. Guarde los cambios.

Añada las opciones --add-opens en service.bat
  1. Navegue hasta la carpeta Apache Tomcat (por ejemplo, C:\Archivos de Programa\Apache Software Foundation\Tomcat 9.0). Abra la carpeta bin y localice el archivo service.bat. Abra el archivo en un editor de texto.

  2. Vaya a la línea --JvmOptions9 y cámbiela 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. Guarde los cambios.