Manual de actualización de versiones - BRIDGE
Introducción
- Guía para la actualización de versiones Bridge.
- En este ejemplo se desea llevar Bridge 7.1 a la versión mas reciente de Bridge 7.5
- Pasos y validaciones para un troubleshooting de primer nivel que permita continuar la instalación de manera ágil.
Los scripts que se introducen en Bridge se realizan a través de API, ejecutando los "apiChangeLogs", por esto es que se necesita ir pasando de versión en versión al momento de realizar una actualización de versiones.
Es importante tener la ultima actualización estable de cada versión para luego poder pasar a la siguiente, al momento de ir realizando estos pasos no es necesario que los servicios de CORE y de BM estén levantados, esto quedará para lo último cuando se esté instalando la última versión de Bridge (actualmente 7.5).
Pasos
Actualización de API dentro de la misma versión
Bajar los servicios de API, CORE y BM
Actualizar al último release de API de la versión actual de Bridge 7.1
Ver: Bridge - Actualización de Bridge API
Levantar solamente los servicios de API.
Validaciones:
Validación principal:
Ingresar a la URL de API → Ejemplo: http://localhost:8081
De este modo al observar la imagen, nos refiere a que la actualización resultó satisfactoria y podremos observar la versión, fecha de compilación y numero de compilación para saber si se trata de la versión correcta.
Validación en caso de que obtengamos el resultado siguiente: No se puede acceder a este sitio
Para esto deberemos realizar los siguientes pasos:
1.Validar que la instalación se realizó de manera correcta.
2.Ingresar en la base de datos y validar que no haya ApiChangeLogs en error con la siguiente query → db.getCollection("ApiChangelog").find({status:"error"})
3.Revisar el log de API para mayor información
Nota:
En caso de que haya apiChangeLogs en error se deberán "eliminar" y reiniciar el servicio de API. Si vuelven a quedar en error se debe verificar el campo "notes" para capturar el mensaje de error y contactar al equipo de producto.
Actualización de API de las demas versiones:
Con los servicios bajos de BM y de CORE realizar la actualización de API a la versión 7.2 (la última liberada)
ver: Bridge - Actualización de Bridge API
Con los servicios bajos de BM y de CORE realizar la actualización de API a la versión 7.3 (la última liberada)
ver: Bridge - Actualización de Bridge API
Con los servicios bajos de BM y de CORE realizar la actualización de API a la versión 7.4 (la última liberada)
ver: Bridge - Actualización de Bridge API
Con los servicios bajos de BM y de CORE realizar la actualización de API a la versión 7.5 (la última liberada)
ver: Bridge - Actualización de Bridge API
ver: Anexo de versión 7.4 a 7.5 (debajo en este documento)
Una vez que se hayan implementado todas las versiones de API, se deberá llevar a cabo la actualización de los demás componentes a la versión 7.5
Actualización Bridge Manager: Bridge - Actualización de Bridge Manager
Actualización Bridge Core: Bridge - Actualización de Bridge Core
Luego iniciar todos los servicios.
Para validar que CORE/REST este funcionando, se deberá acceder a la URL de la instalación:
suponiendo que nuestro puerto de Bridge Manager es 8080, nuestro puerto de server rest será 8082, por lo tanto la URL se compondrá de la siguiente manera:
http://localhost:8082/bridge-server-rest
Entonces, siguiente el ejemplo y colocando una URL válida deberíamos obtener una respuesta similar:
Anexo de versión 7.4 a 7.5
Actualización de API
- Actualizar Node a v16, si es necesario
- Pisar carpetas dist, data, node_modules, soap y el archivo package.json
- Copiar los apichangelogs de versiones anteriores, de mayor a menor sobre la carpeta 7.5, sin sobreescribir los archivos repetidos
Actualización de Bcore
- Mover hibernate.cfg.xml dentro de la carpeta config
- Eliminar el archivo log4j.xml y reemplazarlo por log4j2.xml
- Reemplazar la carpeta WEB-INF/lib completa
- En start.bat: Cambiar -Dlog4j.configuration=WEB-INF/log4j.xml por -Dlog4j.configurationFile=config/log4j2.xml y agregar -Dvouchers.templates=ticket.vcl,ticketDuplicate.vcl,giftTickets.vcl, previo nombre de la main class