Ayuda sobre productos BOLD:
Instalación del portal
Requisitos
- Versión de Java 8: Azul Zulu 8 JDK (
zulu8.98.0.107-ca-jdk8.0.512-win_x64, fichero .zip)- Descarga: https://cdn.azul.com/zulu/bin/zulu8.98.0.107-ca-jdk8.0.512-win_x64.zip
- SHA256:
9284148D71BFF3B34D678A5159BB5688A062F5084EF14ABB3DAEA0A173BB0BF2 - No usar Oracle JDK (
jdk-8u241) ni ZuluFX en instalaciones nuevas.
- Versión de Tomcat 8.5.100
https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.100/bin/apache-tomcat-8.5.100-windows-x64.zip - La última versión del Portal Java de BOLD (fichero .war)
https://github.com/gps-plan/portal-java (en el caso de que no funcione, acceder aquí: https://www.gps-plan.com/setup/releases/portal_v2_4_62.war) - Si se va a usar protocolo HTTPS, el programa KeyStore-Explorer
https://keystore-explorer.org/downloads.html
Instalación de Java
Se usa Azul Zulu 8 JDK en formato .zip: no modifica el PATH ni el registro de Java de Windows, así que solo lo usará Tomcat. En una consola de PowerShell como administrador, con el .zip descargado en C:\Temp:
- Comprueba que el SHA256 coincide con el de los requisitos:
(Get-FileHash C:\Temp\zulu8.98.0.107-ca-jdk8.0.512-win_x64.zip -Algorithm SHA256).Hash - Descomprímelo en
C:\Program Files\Zulu:Expand-Archive C:\Temp\zulu8.98.0.107-ca-jdk8.0.512-win_x64.zip -DestinationPath 'C:\Program Files\Zulu' - Comprueba la versión (debe mostrar Zulu y 1.8.0_512):
& 'C:\Program Files\Zulu\zulu8.98.0.107-ca-jdk8.0.512-win_x64\bin\java.exe' -version - Quita del almacén de certificados las raíces de eMudhra (medida temporal por la vulnerabilidad CVE-2026-114820, hasta que Azul publique un Zulu 8 gratuito con la corrección).
$z = 'C:\Program Files\Zulu\zulu8.98.0.107-ca-jdk8.0.512-win_x64'
Copy-Item "$z\jre\lib\security\cacerts" "$z\jre\lib\security\cacerts.bak-emsign"
foreach ($a in 'emsignrootcag1 [jdk]', 'emsignrootcag2 [jdk]', 'emsigneccrootcag3 [jdk]') {
& "$z\bin\keytool.exe" -delete -alias $a -keystore "$z\jre\lib\security\cacerts" -storepass changeit
}
Después configura las siguientes variables de entorno a nivel de sistema:
- Ve a inicio y escribe «Variables de entorno» y haz clic en «Editar las variables de entorno del sistema».
- Clica en el botón «Variables de entorno…».
- En el cuadro de «Variables de sistema», pulsa «Nueva…».
- Crea estas dos variables:
- JAVA_HOME →
C:\Program Files\Zulu\zulu8.98.0.107-ca-jdk8.0.512-win_x64 - JRE_HOME →
C:\Program Files\Zulu\zulu8.98.0.107-ca-jdk8.0.512-win_x64\jre
- JAVA_HOME →
Importante: crea las variables antes de ejecutar service.bat install. Al instalar el servicio, Tomcat copia la ruta de Java de JRE_HOME a su propia configuración y no la vuelve a leer: cambiar las variables después no cambia la Java que usa Tomcat (ver «Cambiar la Java de un Tomcat ya instalado»).
Instalación y configuración de Tomcat
- Descarga Tomcat 8.5.100.
- Descomprime el
.zipenC:\. - Dentro de
C:\apache-tomcat-8.5.50\bin, abre una consola como administrador y ejecuta:
service.bat install
Configuración
Para que Tomcat funcione correctamente, deben revisarse los siguientes archivos:
☑ Archivo context.xml
Ubicación:C:\apache-tomcat-8.5.50\conf\context.xml
Debes descomentar la línea del Manager:
<!-- Uncomment this to disable session persistence across Tomcat restarts -->
<Manager pathname="" />
☑ Configuraciones en tomcat8w.exe
Ejecuta:
C:\apache-tomcat-8.5.50\bin\tomcat8w.exe
Realiza estos cambios (todos son importantes):
Pestaña General
- Startup type → Automatic
Pestaña Logging
- Borrar el campo Redirect Stdout (debe quedar vacío)
Pestaña Java
- Use default → desmarcado, y en Java Virtual Machine:
C:\Program Files\Zulu\zulu8.98.0.107-ca-jdk8.0.512-win_x64\jre\bin\server\jvm.dll
(si se crearon las variables antes deservice.bat install, ya aparece esta ruta) - En Java Options añadir:
-Dfile.encoding=UTF-8 - Initial Memory Pool → 1024
- Maximum Memory Pool → 1024
Al finalizar todo esto, arrancar el servicio (Start).
☑ Archivo web.xml
Ubicación:C:\apache-tomcat-8.5.50\conf\web.xml
Debes eliminar o comentar esta parte:
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
Y añadir dentro de <web-app> algo como esto:
<error-page>
<error-code>404</error-code>
<location>/main/error404.xhtml</location>
</error-page>
Instalación del Portal en Tomcat
Necesitas la última versión del Portal Java de BOLD.
- Renombra el archivo
.waraportal.war. - Muévelo a:
C:\apache-tomcat-8.5.50\webapps - En la raíz de Tomcat crea la estructura:
C:\apache-tomcat-8.5.50\portal\config
Dentro de config, deben estar estos archivos:
- BoldWebCfg.properties:
BoldWebcfg.xml=C:\\Program Files (x86)\\Global Planning Solutions\\Custom_Files\\Integration\\configuration\\workPlanner\\boldweb\\config\\BoldWebcfg.xml
- log.properties:
# To change this template, choose Tools | Templates
# and open the template in the editor.
# Logging
# Set root logger level to DEBUG and two appenders (console, FileLog).
log4j.rootLogger=INFO, console, FileLog
# console is set to be a ConsoleAppender.
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d{HH:mm:ss,SSS} %-4r [%t] %-5p %c %x - %m%n
#
# Standard FileLog configuration
#
log4j.appender.FileLog=org.apache.log4j.RollingFileAppender
log4j.appender.FileLog.File=portal/logs/portal.log
log4j.appender.FileLog.threshold=INFO
log4j.appender.FileLog.MaxFileSize=10000KB
log4j.appender.FileLog.MaxBackupIndex=3
log4j.appender.FileLog.layout=org.apache.log4j.PatternLayout
log4j.appender.FileLog.layout.ConversionPattern=[%d{dd/MM/yyyy HH:mm:ss,SSS}] %p %c - %m%n
# Specific class log level
log4j.logger.com.gps_plan.trans.Trans=ERROR
#log4j.logger.com.gps_plan.sysreports=DEBUG
# NOTE: to log SOAP calls detail it is better to enable syscomunication specific appender
#log4j.com.gps_plan.webcore.syscomunication=DEBUG
#
# Define specific logger for webservices package
# Generates a specific "for the web" kind of "zServerCalls"
#
log4j.appender.WSFileLog=org.apache.log4j.RollingFileAppender
log4j.appender.WSFileLog.File=portal/logs/wsportal.log
#log4j.appender.WSFileLog.threshold=ALL
#log4j.appender.WSFileLog.additive=false
log4j.appender.WSFileLog.MaxFileSize=10000KB
log4j.appender.WSFileLog.MaxBackupIndex=3
log4j.appender.WSFileLog.layout=org.apache.log4j.PatternLayout
log4j.appender.WSFileLog.layout.ConversionPattern=[%d{dd/MM/yyyy HH:mm:ss,SSS}] %p %c - %m%n
log4j.logger.com.gps_plan.webcore.syscomunication=DEBUG, WSFileLog
(ambos con rutas correctas)
- En Windows Server 2019 puede ser necesario añadir tomcat9w.exe como excepción del firewall.
Borrado automático de logs
Para evitar que los logs crezcan demasiado, se recomendaba crear una tarea programada que ejecute:
.\boldXML2\scripts\deleteLogsTomcat.ps1
Comando que debía llevar la tarea:
Powershell -executionpolicy bypass -File "RUTAGLOBLAPLANNING\boldXML2\scripts\deleteLogsTomcat.ps1"
Configurar HTTPS

Cambiar la Java de un Tomcat ya instalado (Oracle JDK 8u241 → Azul Zulu 8)
En instalaciones existentes con Oracle JDK 8u241 se cambia la Java del servicio de Tomcat sin reinstalar el servicio (reinstalarlo borra los ajustes de tomcat8w.exe: arranque automático, Redirect Stdout, -Dfile.encoding=UTF-8, memoria). Está automatizado con los scripts de la carpeta apache-management del repositorio onprem-deployments:
- Lanzar en GitHub el workflow «Apache Management – Entregar scripts Java/Tomcat» con el label y el token del runner de la máquina. Deja los scripts y el .zip de Zulu verificado en
C:\Program Files (x86)\Global Planning Solutions\apache-management. No cambia nada todavía. - En la máquina, en PowerShell como administrador, ejecutar:
cd 'C:\Program Files (x86)\Global Planning Solutions\apache-management'
powershell -ExecutionPolicy Bypass -File .\Ejecutar-Migracion.ps1
El script hace un diagnóstico, copias de seguridad y tres fases. Al terminar cada una pide probar el portal en el navegador y confirmar (S/N):
- Fase 1 — el portal debe funcionar con la Java actual (referencia).
- Fase 2 — renombra la carpeta de Oracle JDK a
…\jdk1.8.0_241.bak: el portal no debe responder (Tomcat queda parado hasta la fase 3). - Fase 3 — instala Zulu, quita las raíces de eMudhra, apunta el servicio a Zulu y lo arranca: el portal debe funcionar igual que en la fase 1.
Si algo falla, o se responde «N» en la fase 2 o 3, se vuelve automáticamente a la Java anterior. También se puede volver a mano en cualquier momento con .\Rollback.ps1. Las copias de seguridad y los logs quedan en C:\ProgramData\GPS\apache-management.
Sin runner: copiar la carpeta apache-management (y el .zip de Zulu si la máquina no tiene salida a cdn.azul.com) a la máquina, ejecutar Get-ChildItem <carpeta> | Unblock-File y seguir con el paso 2.
Actualizar Tomcat
- Descargar la versión más reciente de Apache Tomcat de https://tomcat.apache.org/download-80.cgi. De las versiones posibles elegiremos el archivo zip para windows 64bits, ya que contiene el archivo Tomcat.exe y Tomcatw.exe
- En la carpeta correspondiente parar Tomcat si está en marcha.
- Descomprimir el archivo descargado en la unidad C:\, quedará algo del estilo c:\apache-tomcat-8.5.50\
- Copiar ficheros de configuración:
- Carpeta Conf – keystore.jks y keystore_.jks
- Carpeta Webapps – boldseb.war
- Carpeta Boldweb completa
- Modificar los ficheros de configuración como se explica en la instalación del portal.
- Desinstalar el servicio Tomcat antiguo desde la ventana de comandos c:\apache-tomcat-8.5.50\bin service.bat remove
- Instalar el servicio Tomcat nuevo desde la ventana de comandos c:\apache-tomcat-8.5.50\bin service.bat install
- Revisar las rutas de la ventana de Tomcatw.exe y modificar todos los parámetros que apunten a la versión anterior

Actualizar versión del portal (tomcat)
- Como siempre, guardaremos una copia del nuevo war a instalar en la carpeta Global Planning Solutions\setups de forma que podamos tenerlo guardado para reinstalarlo cuando haga falta.
Hay que tener en cuenta, que este war tendrá que nombrarse tal y como esté nombrado el que haya anteriormente en la carpeta del cliente, ya que sino en lugar de actualizar el portal existente, estarás instalando otro portal con otro nombre diferente. - Detener Tomcat por completo. Abrimos aplicación primero:


- Copiar el fichero .war, portal.war en c:\apache-tomcat-8.5.50\webapps. (como ya se ha mencionado antes, el nuevo fichero .war debe tener el mismo nombre que tenía antes).
- Después eliminaremos la carpeta portal (o también llamada boldweb como en la captura) que está dentro de webapps:

- Volveremos a Encender en Tomcat:

- Al cabo de unos instantes, veremos como la carpeta, con el mismo nombre que el war colocado, se refresca con el nuevo contenido.
Desinstalación de GlassFish (en desuso)
Tras asegurarnos de que Tomcat está funcionando a la perfección (realizando las pruebas que sean convenientes) el siguiente paso es desinstalar GlassFish.
Es casi seguro que por razones de incompatibilidad con las versiones Java, GlassFish no pueda ser desinstalado. Para lograr nuestro objetivo, deberemos seguir estos pasos:
- Detén y deshabilita el servicio de GlassFish
- Navega hacia la ubicación de GlassFish ( C:\glassfish3 )
- Abre una consola de comando como administrador
- Ejecuta el siguiente código
uninstall.exe -j "C:\Program Files\Java\jdk1.6.0_25\jre"
El texto en rojo indica la versión de Java que se usará para realizar la desinstalación, en este caso usaremos la versión compatible con nuestra versión de GlassFish.
Errores frecuentes en la instalación del portal
Contadores empotrados no se muestran correctamente en Workplanner
Ve a Internet Explorer, presiona sobre el engranaje (parte superior derecha), «Opciones de Internet» > «Seguridad» > «Sitios de confianza» > «Sitios» y añade la URL de la máquina.

Reinicio programado del servicio tomcat
En algunas tareas programadas como la de limpieza, o la del reinicio nocturno se incluye un reset del servicio tomcat. La manera mas adecuada de hacerlo según hemos visto hasta el momento es la siguiente:
rem paramos el servicio de forma normativa
call net stop Tomcat8
rem nos cargamos el ejecutable a lo bestia por si no ha muerto aun
taskkill /F /IM tomcat8.exe
rem arrancamos el servicio
call net start Tomcat8
rem esperamos un poco por si acaso no ha funcionado el detener servicio ejecutado anteriormente y volvemos a arrancar.
call timeout 30 >nul
call net start Tomcat8
call timeout 30 >nul
call net start Tomcat8
