Instalação

A instalação segue os mesmos passos do Riversoft® STCP Gemini, trocando o pacote do produto: banco de dados, repositório, Riversoft STCP Gemini API, Riversoft Console Portal e Riversoft STCP DirectLink (pacotes stcpdirectlink e stcpdirectlink-portal). A API e o Portal fazem a gestão do produto, e o Riversoft STCP DirectLink usa a 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 DirectLink]
    F --> G[Riversoft STCP DirectLink Portal]
  

Antes de começar, confira o checklist de pré-instalação.

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.

Download dos scripts

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.

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

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

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

curl https://repo.riversoft.com.br/configs/riversoft-el10.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.

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

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 DirectLink

dnf install -y stcpdirectlink
rpm -q stcpdirectlink

O pacote instala:

O serviço não é iniciado na primeira instalação. Em seguida, instale o Riversoft STCP DirectLink Portal, configure o Riversoft STCP DirectLink e teste a execução antes de iniciar o serviço.

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

Riversoft STCP DirectLink Portal

O Riversoft STCP DirectLink Portal, usado por pessoas para enviar e receber arquivos, é distribuído no pacote stcpdirectlink-portal:

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

Os arquivos ficam em /usr/local/stcpdirectlink/static/portal. O pacote instala o modelo assets/configs/example-config.json, a partir do qual é criado o config.json do portal. O próprio Riversoft STCP DirectLink serve o portal no caminho /portal, sem servidor web adicional. Em seguida, configure o portal. Veja também Uso do Riversoft STCP DirectLink Portal.

Licença

O Riversoft STCP DirectLink exige um arquivo de licença válido, fornecido pela Riversoft.

1. Copie o arquivo de licença para o servidor e restrinja as permissões de acesso ao usuário do serviço.
2. Informe o caminho do arquivo em applLicense, no config.json (veja Aplicação e segurança).
3. Inicie o serviço. A licença é validada na inicialização, e o serviço não inicia se o arquivo não existir ou for inválido.

Para renovar ou trocar a licença, substitua o arquivo e reinicie o serviço.

Validação da instalação

• rpm -q mostra a versão de cada pacote instalado.
• systemctl status stcpgemini-api e systemctl status stcpdirectlink exibem running.
• O Portal abre no endereço da API e aceita o login.
• A instância configurada no Riversoft STCP DirectLink (cfgInstanceName) existe no Portal.
• O Riversoft STCP DirectLink Portal abre por HTTPS em /portal e aceita o login de um usuário de teste.