Ayuda sobre productos BOLD:
Instalación del portal
Requisitos
- Versión de Java 8
- https://wingetgui.com/apps/Azul-ZuluFX-8-JDK#google_vignette (probada en Diciembre 2025 por Guayasén)
- o bien esta otra si la anterior da problemas: https://www.gps-plan.com/setup/releases/tomcat/jdk-8u241-windows-x64.exe
- 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
En esta documentación se explica cómo configurarlo utilizando la versión de Java 8 (jdk-8u241-windows-x64). Si se ha instalado con otra distribución, es diferente, pero la clave es disponer de la variable JAVA_HOME correctamente establecida.
Una vez instalado, debes configurar 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\Java\jdk1.8.0_241 - JRE_HOME →
C:\Program Files\Java\jdk1.8.0_241\jre
- JAVA_HOME →
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 installConfiguració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
- 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
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