Instalação

A instalação segue esta ordem: banco de dados, repositório, Riversoft® STCP Gemini API, Riversoft Console Portal e Riversoft STCP Gemini Server. O Portal depende da API em execução, e o Server depende de uma instância criada no Portal.

    flowchart LR
    A[Banco de dados] --> B[Repositório Riversoft]
    B --> C[Riversoft STCP Gemini API]
    C --> D[Riversoft Console Portal]
    D --> E[Instância criada no Portal]
    E --> F[Riversoft STCP Gemini Server]

Nota

Se o Riversoft STCP DirectLink já estiver instalado, o banco de dados, o repositório, a API e o Portal já estão prontos: instale apenas o Riversoft STCP Gemini Server.

Preparação do banco de dados

O SGBD deve estar instalado, configurado e acessível, com um usuário autorizado a executar os scripts de criação. A Riversoft fornece os scripts que criam os bancos e as estruturas usadas pelos produtos: tabelas, relacionamentos, dados iniciais de configuração e objetos de log.

Importante

A equipe de DBA da organização é responsável por disponibilizar o ambiente, revisar os scripts e executá-los conforme as políticas internas, incluindo segurança, backup e controle de acesso.

Download dos scripts

SGBD	Pacote
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 executar os scripts, confirme que:

o banco correspondente ao ambiente está disponível e a conexão funciona;
o SGBD é compatível (veja Requisitos);
o usuário tem permissão para criar e alterar estruturas;
a execução segue as políticas de administração e segurança da organização.

Execução dos scripts

Execute os scripts em sequência, na ordem da numeração. Cada etapa prepara estruturas usadas pelas seguintes.

Ordem	Script	Finalidade
1	`0-STCPGeminiCreateDatabase_<SGBD>.sql`	Cria e prepara os bancos de dados.
2	`1-STCPGeminiCfg_<SGBD>.sql`	Cria as estruturas de configuração.
3	`2-STCPGeminiCfgInit_<SGBD>.sql`	Carrega os dados iniciais de configuração.
4	`3-STCPGeminiLog_<SGBD>.sql`	Cria as estruturas dos registros de log.

O sufixo <SGBD> varia conforme o banco, por exemplo 0-STCPGeminiCreateDatabase_SQLServer.sql.

Atenção

Só passe para o próximo script depois que o anterior for concluído com sucesso. Em caso de erro, interrompa o processo e corrija a causa antes de continuar.

Os nomes de banco usados nos scripts (por exemplo, GEMINI_DBConfig e GEMINI_DBLog) são referências e podem seguir o padrão da organização. Se mudar os nomes, atualize todas as referências nos scripts e na configuração dos componentes.

Validação do banco

Todos os scripts foram executados sem erros.
Os bancos e as estruturas foram criados e os dados iniciais, carregados.
As estruturas de log estão disponíveis.
Os bancos são acessíveis a partir dos servidores dos componentes.
O usuário de banco configurado nos produtos tem acesso às estruturas criadas.

Repositório Riversoft

Os pacotes são distribuídos pelo repositório oficial da Riversoft. Baixe o arquivo .repo correspondente à versão do Enterprise Linux:

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

O arquivo configura os repositórios de produção da arquitetura do sistema ($basearch) e dos pacotes independentes de arquitetura (noarch). Exemplo para o 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 os repositórios validam a assinatura GPG dos pacotes (gpgcheck=1) com a chave pública https://repo.riversoft.com.br/certs/riversoft.asc.

Importante

Use os arquivos .repo publicados pela Riversoft em vez de criar a configuração manualmente. Se já existir uma configuração anterior do repositório em /etc/yum.repos.d/, remova-a ou desabilite-a para evitar repositórios duplicados.

Atualize os metadados do gerenciador de pacotes:

dnf clean all
dnf makecache

Riversoft STCP Gemini API

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

O comando rpm -q exibe a versão instalada. Os arquivos ficam em /usr/local/stcpgemini-api. Em seguida, configure a API.

Riversoft Console Portal

Atenção

A Riversoft STCP Gemini API deve estar instalada e em execução antes da instalação do Portal.

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

Os arquivos ficam em /usr/local/stcpgemini-api/portal/. Em seguida, configure o Portal e faça o primeiro acesso para criar a instância.

Riversoft STCP Gemini Server

Importante

O Riversoft STCP Gemini Server só inicia com uma instância previamente criada no Riversoft Console Portal.

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

Os arquivos ficam em /usr/local/stcp. Em seguida, configure o Server.

Para usar roteamento e automação de arquivos, instale o Riversoft STCP Gemini Rename no mesmo servidor ou na mesma imagem de container do Riversoft STCP Gemini Server.

Validação da instalação

rpm -q mostra a versão de cada pacote instalado.
systemctl status stcpgemini-api e systemctl status stcpgemini-server exibem running.
O Portal abre no endereço da API e aceita o login.
A instância criada no Portal corresponde ao ApplName do Riversoft STCP Gemini Server.

Requisitos Atualização