Actualización

Actualización y migración

Los componentes de Riversoft® STCP Gemini se distribuyen como paquetes RPM en el repositorio Riversoft y se actualizan con el gestor de paquetes del sistema, dnf o yum. Cada componente es un paquete y puede actualizarse por separado:

Componente	Paquete
Riversoft STCP Gemini API	`stcpgemini-api`
Riversoft Console Portal	`stcpgemini-portal`
Riversoft STCP Gemini Server	`stcpgemini-server`

Buenas prácticas

Lea las notas de la versión de todas las versiones entre la instalada y la de destino. Informan cambios de comportamiento, nuevos parámetros y procedimientos específicos.
Actualice primero un entorno de homologación y repita las pruebas de los flujos críticos antes de actualizar producción.
Planifique una ventana de mantenimiento y comunique a los socios cuando las transferencias no estén disponibles.
Haga un backup de la configuración y de las bases de datos antes de cada actualización.
Actualice a una versión de destino por vez y mantenga la misma versión en todos los servidores del entorno.
Registre la versión anterior de cada paquete para poder revertir.

Antes de actualizar

Relevamiento

Registre las versiones instaladas:

rpm -q stcpgemini-api stcpgemini-portal stcpgemini-server

Verifique las versiones disponibles en el repositorio:

dnf makecache
dnf list --showduplicates stcpgemini-api stcpgemini-portal stcpgemini-server

Identifique las transferencias en curso y los agendamientos previstos para la ventana de mantenimiento.
Defina el responsable del cambio y el plan de reversión.

Backup

Archivos de configuración de los componentes:

Componente	Archivo
Riversoft STCP Gemini API	`/usr/local/stcpgemini-api/configs/config.json`
Riversoft Console Portal	`/usr/local/stcpgemini-api/portal/app/configs/config.json`
Riversoft STCP Gemini Server	`/usr/local/stcp/configs/stcpserver.config.json`

Base de configuración y base de log, según las políticas de backup de la organización.
Certificados, claves y licencias usados por los componentes.

Procedimiento de actualización

Detenga los servicios

Detenga Riversoft STCP Gemini Server antes que la API:

systemctl stop stcpgemini-server
systemctl stop stcpgemini-api

Actualice los paquetes

Actualice los metadatos del repositorio y los paquetes de los componentes instalados en el servidor:

dnf clean all
dnf makecache
dnf upgrade stcpgemini-api stcpgemini-portal stcpgemini-server

Para actualizar a una versión específica, indique la versión en el nombre del paquete, por ejemplo dnf upgrade stcpgemini-server-6.6.18.

Revise la configuración

La actualización no sustituye los archivos de configuración en uso. Compárelos con los modelos (example-*.json) de la nueva versión para identificar parámetros nuevos o modificados, según las notas de la versión. Si el gestor de paquetes crea archivos con la extensión .rpmnew, compárelos con los archivos en uso:

find /usr/local/stcpgemini-api /usr/local/stcp -name "*.rpmnew"

Actualice la base de datos, cuando sea necesario

Cuando la nueva versión exija cambios en la base de datos, las notas de la versión informan los scripts y el orden de ejecución. Ejecútelos con el acompañamiento del equipo de DBA, como en la preparación de la base de datos.

Inicie los servicios

Inicie la API antes que el Server y confirme que ambos están en ejecución:

systemctl start stcpgemini-api
systemctl start stcpgemini-server
systemctl status stcpgemini-api stcpgemini-server

Nota

Cuando Riversoft STCP DirectLink usa la misma Riversoft STCP Gemini API y el mismo Riversoft Console Portal, actualice primero la API y el Portal y después cada producto, verificando en las notas de la versión la compatibilidad entre las versiones.

Validación después de la actualización

rpm -q muestra la versión de destino de cada paquete.
systemctl status muestra running para la API y para el Server.
El Riversoft Console Portal se abre y acepta el inicio de sesión.
El Server se conecta a la base y carga la instancia (ApplName), sin errores en el log.
Una transferencia de prueba con un socio se completa en los dos sentidos.
Los agendamientos se ejecutan.

Reversión (rollback)

Si la validación falla y la causa no puede corregirse dentro de la ventana de mantenimiento:

Detenga los servicios.
Vuelva los paquetes a la versión anterior registrada antes de la actualización:
```
dnf downgrade stcpgemini-server-<versión-anterior>
```
También es posible deshacer la transacción completa con dnf history undo <id>, donde <id> es el identificador de la transacción mostrado en dnf history. Con yum, use yum downgrade y yum history undo.
Restaure los archivos de configuración del backup.
Si se ejecutaron scripts de base de datos, restaure el backup de las bases.
Inicie los servicios y repita la validación.

Importante

La reversión depende de que la versión anterior siga disponible en el repositorio y de que exista un backup de los archivos y de las bases hecho antes de la actualización.

Migración entre versiones principales

Cuando una versión exija migración, con cambios en la estructura de la base de datos, en parámetros o en el comportamiento de los componentes, el procedimiento específico se publica en las notas de la versión. Siga ese procedimiento en lugar de la actualización simple descrita en esta página.

Instalación Seguridad