Instalación

La instalación sigue este orden: base de datos, repositorio, Riversoft® STCP Gemini API, Riversoft Console Portal y Riversoft STCP Gemini Server. El Portal depende de la API en ejecución, y el Server depende de una instancia creada en el Portal.

    flowchart LR
    A[Base de datos] --> B[Repositorio de Riversoft]
    B --> C[Riversoft STCP Gemini API]
    C --> D[Riversoft Console Portal]
    D --> E[Instancia creada en el Portal]
    E --> F[Riversoft STCP Gemini Server]

Nota

Si Riversoft STCP DirectLink ya está instalado, la base de datos, el repositorio, la API y el Portal ya están listos: instale solo Riversoft STCP Gemini Server.

Preparación de la base de datos

El SGBD debe estar instalado, configurado y accesible, con un usuario autorizado a ejecutar los scripts de creación. Riversoft proporciona los scripts que crean las bases y las estructuras usadas por los productos: tablas, relaciones, datos iniciales de configuración y objetos de log.

Importante

El equipo de DBA de la organización es responsable de proporcionar el entorno, revisar los scripts y ejecutarlos según las políticas internas, incluidas la seguridad, el backup y el control de acceso.

Descarga de los scripts

SGBD	Paquete
Microsoft SQL Server	STCPGemini_Scripts_SQLServer.zip
Oracle Database	STCPGemini_Scripts_Oracle.zip
MySQL	STCPGemini_Scripts_MySQL.zip
MariaDB	STCPGemini_Scripts_MariaDB.zip

Antes de ejecutar los scripts, confirme que:

la base del entorno está disponible y la conexión funciona;
el SGBD es compatible (vea Requisitos);
el usuario tiene permiso para crear y alterar estructuras;
la ejecución sigue las políticas de administración y seguridad de la organización.

Ejecución de los scripts

Ejecute los scripts en secuencia, en el orden de la numeración. Cada etapa prepara estructuras que usan las siguientes.

Orden	Script	Finalidad
1	`0-STCPGeminiCreateDatabase_<SGBD>.sql`	Crea y prepara las bases de datos.
2	`1-STCPGeminiCfg_<SGBD>.sql`	Crea las estructuras de configuración.
3	`2-STCPGeminiCfgInit_<SGBD>.sql`	Carga los datos iniciales de configuración.
4	`3-STCPGeminiLog_<SGBD>.sql`	Crea las estructuras de los registros de log.

El sufijo <SGBD> varía según la base, por ejemplo 0-STCPGeminiCreateDatabase_SQLServer.sql.

Atención

Pase al siguiente script solo después de que el anterior termine con éxito. Si ocurre un error, interrumpa el proceso y corrija la causa antes de continuar.

Los nombres de base usados en los scripts (por ejemplo, GEMINI_DBConfig y GEMINI_DBLog) son referencias y pueden seguir el estándar de la organización. Si cambia los nombres, actualice todas las referencias en los scripts y en la configuración de los componentes.

Validación de la base de datos

Todos los scripts se ejecutaron sin errores.
Se crearon las bases y las estructuras y se cargaron los datos iniciales.
Las estructuras de log están disponibles.
Las bases son accesibles desde los servidores de los componentes.
El usuario de base de datos configurado en los productos tiene acceso a las estructuras creadas.

Repositorio de Riversoft

Los paquetes se distribuyen por el repositorio oficial de Riversoft. Descargue el archivo .repo correspondiente a la versión de Enterprise Linux:

curl https://repo.riversoft.com.br/configs/riversoft-el8.repo \
  --output /etc/yum.repos.d/riversoft-release.repo

El archivo configura los repositorios de producción para la arquitectura del sistema ($basearch) y para los paquetes independientes de la arquitectura (noarch). Ejemplo para Enterprise Linux 9:

[Riversoft-el9-prod]
name=Riversoft Packages for Enterprise Linux 9 (prod) - $basearch
baseurl=https://repo.riversoft.com.br/prod/el9/$basearch
enabled=1
gpgcheck=1
gpgkey=https://repo.riversoft.com.br/certs/riversoft.asc

[Riversoft-el9-prod-noarch]
name=Riversoft Packages for Enterprise Linux 9 (prod) - noarch
baseurl=https://repo.riversoft.com.br/prod/el9/noarch
enabled=1
gpgcheck=1
gpgkey=https://repo.riversoft.com.br/certs/riversoft.asc

Todos los repositorios validan la firma GPG de los paquetes (gpgcheck=1) con la clave pública https://repo.riversoft.com.br/certs/riversoft.asc.

Importante

Use los archivos .repo publicados por Riversoft en lugar de crear la configuración manualmente. Si ya existe una configuración anterior del repositorio en /etc/yum.repos.d/, elimínela o deshabilítela para evitar repositorios duplicados.

Actualice los metadatos del gestor de paquetes:

dnf clean all
dnf makecache

Riversoft STCP Gemini API

dnf install -y stcpgemini-api
rpm -q stcpgemini-api

El comando rpm -q muestra la versión instalada. Los archivos quedan en /usr/local/stcpgemini-api. A continuación, configure la API.

Riversoft Console Portal

Atención

La Riversoft STCP Gemini API debe estar instalada y en ejecución antes de instalar el Portal.

dnf install -y stcpgemini-portal
rpm -q stcpgemini-portal

Los archivos quedan en /usr/local/stcpgemini-api/portal/. A continuación, configure el Portal y realice el primer acceso para crear la instancia.

Riversoft STCP Gemini Server

Importante

Riversoft STCP Gemini Server solo se inicia con una instancia creada previamente en el Riversoft Console Portal.

dnf install -y stcpgemini-server
rpm -q stcpgemini-server

Los archivos quedan en /usr/local/stcp. A continuación, configure el Server.

Para usar el enrutamiento y la automatización de archivos, instale Riversoft STCP Gemini Rename en el mismo servidor o imagen de container que Riversoft STCP Gemini Server.

Validación de la instalación

rpm -q muestra la versión de cada paquete instalado.
systemctl status stcpgemini-api y systemctl status stcpgemini-server muestran running.
El Portal se abre en la dirección de la API y acepta el inicio de sesión.
La instancia creada en el Portal corresponde al ApplName de Riversoft STCP Gemini Server.

Requisitos Actualización