Instalación

La instalación sigue los mismos pasos de Riversoft® STCP Gemini, cambiando el paquete del producto: base de datos, repositorio, Riversoft STCP Gemini API, Riversoft Console Portal y Riversoft STCP DirectLink (paquetes stcpdirectlink y stcpdirectlink-portal). La API y el Portal gestionan el producto, y Riversoft STCP DirectLink usa la instancia creada en el Portal.

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

Antes de empezar, revise el checklist previo a la instalación.

Nota

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

Nota

Con Riversoft STCP Enterprise Server (Windows), la instalación sigue los procedimientos de Enterprise Server y no se describe en esta página.

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 DirectLink

Importante

Riversoft STCP DirectLink usa una instancia creada previamente en el Riversoft Console Portal.

dnf install -y stcpdirectlink
rpm -q stcpdirectlink

El paquete instala:

Elemento	Ubicación
Aplicación	`/usr/local/stcpdirectlink`
Ejecutable	`/usr/local/bin/stcpdirectlink`
Servicio `systemd`	`stcpdirectlink`, habilitado en el arranque del sistema
Logs	`/var/log/stcpdirectlink`
Usuario y grupo del servicio	`stcp`

El servicio no se inicia en la primera instalación. A continuación, instale Riversoft STCP DirectLink Portal, configure Riversoft STCP DirectLink y pruebe la ejecución antes de iniciar el servicio.

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 DirectLink.

Riversoft STCP DirectLink Portal

Riversoft STCP DirectLink Portal, que las personas usan para enviar y recibir archivos, se distribuye en el paquete stcpdirectlink-portal:

dnf install -y stcpdirectlink-portal
rpm -q stcpdirectlink-portal

Los archivos quedan en /usr/local/stcpdirectlink/static/portal. El paquete instala la plantilla assets/configs/example-config.json, a partir de la cual se crea el config.json del portal. El propio Riversoft STCP DirectLink sirve el portal en la ruta /portal, sin servidor web adicional. A continuación, configure el portal. Vea también Uso de Riversoft STCP DirectLink Portal.

Licencia

Riversoft STCP DirectLink exige un archivo de licencia válido, proporcionado por Riversoft.

Copie el archivo de licencia al servidor y restrinja los permisos de acceso al usuario del servicio.
Indique la ruta del archivo en applLicense, en el config.json (vea Aplicación y seguridad).
Inicie el servicio. La licencia se valida en el inicio, y el servicio no se inicia si el archivo no existe o no es válido.

Para renovar o cambiar la licencia, sustituya el archivo y reinicie el servicio.

Validación de la instalación

rpm -q muestra la versión de cada paquete instalado.
systemctl status stcpgemini-api y systemctl status stcpdirectlink muestran running.
El Portal se abre en la dirección de la API y acepta el inicio de sesión.
La instancia configurada en Riversoft STCP DirectLink (cfgInstanceName) existe en el Portal.
Riversoft STCP DirectLink Portal se abre por HTTPS en /portal y acepta el inicio de sesión de un usuario de prueba.

Requisitos Actualización