Instalación del portal

Instalación del portal utilizando TOMCAT

Requisitos

• Versión de Java 8 o Java 11
• Versión de Tomcat 8 (¡OJO! En esta documentación puede que se estén usando rutas de una versión diferente a la que descargues)
• La última versión del Portal Java de BOLD (fichero .war)
• Si se va a usar protocolo HTTPS, el programa KeyStore-Explorer

Instalación de Java

En esta documentación se explicará cómo configurarlo utilizando la versión de Java 8 (en concreto jdk-8u241-windows-x64).
Una vez instalado deberás de configurar las siguientes variables de entorno a nivel de sistema:

• Ve a inicio y escribe “Variables de entorno” y clica sobre “Editar las variables de entorno del sistema“
• Clica al botón inferior llamado “Variables de entorno…“
• En el recuadro de “Variables de sistema” (generalmente, recuadro inferior) pulsa sobre “Nueva…“
• Crea las dos siguientes variables:
  • Nombre: JAVA_HOME Valor: C:\Program Files\Java\jdk1.8.0_241
  • Nombre: JRE_HOME Valor: C:\Program Files\Java\jdk1.8.0_241\jre

Instalación y configuración de Tomcat

• Descarga la versión de Tomcat 8
• Descomprime el contenido de ese .zip en la carpeta C:\
• Dentro C:\apache-tomcat-8.5.50\bin abrimos una consola de comandos como administrador y ejecutamos el siguiente comando: service.bat install

Configuración

Para un correcto funcionamiento del Tomcat, se requiere tocar los siguientes ficheros de configuración (muy importante hacer un check en cada punto)

☐ En el fichero C:\apache-tomcat-8.5.50\conf\context.xml se debe descomentar la línea Manager pathname de manera que quede así:

<!-- Uncomment this to disable session persistence across Tomcat restarts -->
<Manager pathname="" />

☐ En la ruta C:\apache-tomcat-8.5.50\bin ejecuta el programa tomcat8w.exe y realiza los siguientes pasos (todos son muy importantes)

• Pestaña: General → Cambia Startup type a Automatic
• Pestaña: Logging → Borra el campo de Redirect Stdout (debe estar vacío)
• Pestaña: Java → en Java Options añade la línea:  -Dfile.encoding=UTF-8
• Pestaña: Java → Initial Memory Pool y Maximum Memory Pool a 1024 o más

☐ En el fichero C:\apache-tomcat-8.5.50\conf\web.xml se debe eliminar o comentar las siguientes líneas:

<welcome-file-list>
   <welcome-file>index.html</welcome-file>
   <welcome-file>index.htm</welcome-file>
   <welcome-file>index.jsp</welcome-file>
</welcome-file-list>

En el mismo fichero, debe añadirse las siguientes líneas entre las etiquetas <web-app>

<web-app>
   ..
   ..
  <error-page>
  <error-code>404</error-code>
  <location>/main/error404.xhtml</location>
  </error-page>
</web-app>

Instalación del Portal en Tomcat

Vas a necesitar la última versión del Portal Java de BOLD, una vez la tengas, sigue los siguientes pasos:

• Renombra el archivo .war a portal.war y muévelo a C:\apache-tomcat-8.5.50\webapps
• En la raíz de Tomcat crea la siguiente estructura de carpetas C:\apache-tomcat-8.5.50\portal\config y dentro de la carpeta config debería haber los siguientes archivos:
  • BoldWebCfg.properties (cuya ruta interior debe ser correcta)
  • log.properties
• En Windows Server 2019 es posible que se deba añadir tomcat8w.exe como excepción al firewall.

Configuración protocolo HTTPS con certificado

Necesitarás el certificado en formato .pfx y la contraseña del mismo. Además, haremos uso de la herramienta KeyStore Explorer para crear un archivo .jks.

☐ Abre el KeyStore Explorer, clica sobre el ejecutable y dale a File → New → JKS luego haz clic derecho y presiona sobre Import Key Pair → PKCS#12 y selecciona el certificado (añadiendo su contraseña). Cuando acabes, te pedirá asignar una nueva contraseña, pon: changeit

Una vez finalizado, guarda el archivo bajo el nombre keystore.jks y colócalo en la carpeta C:\apache-tomcat-8.5.50\conf\

☐  Edita el fichero C:\apache-tomcat-8.5.50\conf\server.xml pulsa CTRL+F y escribe “.jks” descomenta la línea y renombra la parte que dice localhost-rsa.jks por keystore.jks también puedes editar el puerto en caso de que esté ocupado.

Borrado de logs (importante)

Para evitar un crecimiento excesivo de los logs es conveniente activar como tarea programada nocturna el script .\boldXML2\scripts\deleteLogsTomcat.ps1
La tarea programada , en el apartado donde se especifica lo que se debe ejecutar debe estar configurada así:

Powershell -executionpolicy bypass -File "RUTAGLOBLAPLANNING\boldXML2\scripts\deleteLogsTomcat.ps1"

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\apache-tomcat-8.5.97
• 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.x\bin service.bat remove
• Instalar el servicio Tomcat nuevo desde la ventana de comandos c:\apache-tomcat-8.5.x\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, por ejemplo portal.war o BOLDWeb.war en c:\apache-tomcat-8.5.50\webapps.
• Después eliminaremos la carpeta boldweb 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