Manual de actualización de versiones - BRIDGE



REVISIONES
FechaVersiónDescripciónAutor

 

1.0Creación del documento
 Gustavo Javier Morales 

 

1.1Se agrega anexo de 7.4 a 7.5
Andrea Veronica Asato 



CONTENIDO


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