Início rápido

Este roteiro resume a ordem de instalação dos componentes do Riversoft® STCP DirectLink em um servidor Enterprise Linux. Os detalhes de cada etapa estão em Instalação e Configuração.

Nota

Se o Riversoft STCP Gemini já estiver instalado, o banco de dados, o repositório, a API e o Portal já estão prontos: comece no passo Crie a instância e um usuário de teste.

Dica

Quer só experimentar o produto? Use o Ambiente de teste com Docker, que sobe o Riversoft STCP Gemini e o Riversoft STCP DirectLink completos em containers, sem preparar um servidor.

Pré-requisitos:

Servidor com um sistema operacional suportado e acesso de administrador (root). Veja Requisitos.
Banco de dados suportado, disponível e acessível a partir do servidor.
Arquivo de licença do Riversoft STCP DirectLink, fornecido pela Riversoft.

Prepare o banco de dados

Baixe o pacote de scripts do seu SGBD e execute-os na ordem numérica. Veja Preparação do banco de dados.

Configure o repositório Riversoft

curl https://repo.riversoft.com.br/configs/riversoft-el9.repo \
  --output /etc/yum.repos.d/riversoft-release.repo
dnf clean all && dnf makecache

Use o arquivo correspondente à versão do seu sistema (el8, el9 ou el10).

Instale e inicie a Riversoft STCP Gemini API

dnf install -y stcpgemini-api
cp /usr/local/stcpgemini-api/configs/example-config.json /usr/local/stcpgemini-api/configs/config.json

Ajuste o config.json (bancos, porta e certificado) e inicie o serviço:

systemctl start stcpgemini-api

Instale o Riversoft Console Portal

dnf install -y stcpgemini-portal

Configure o EntryPoint do Portal com o endereço da API. Veja Configuração do Portal.

Crie a instância e um usuário de teste

Acesse o Riversoft Console Portal pelo endereço da API, entre com o operador administrador padrão (stcpadmin) e troque a senha. Crie a instância que o Riversoft STCP DirectLink vai usar, ou use a instância do Riversoft STCP Gemini, e cadastre um usuário de teste. Veja Primeiro acesso.

Nota

Ao criar o serviço de rede da API do Riversoft STCP DirectLink na instância, o Riversoft Console Portal preenche os caminhos padrão das páginas estáticas (/usr/local/stcpdirectlink/static) e dos templates de página (/usr/local/stcpdirectlink/templates/riversoft/page). Altere-os somente se o Riversoft STCP DirectLink estiver instalado em outro diretório. O caminho das páginas estáticas não deve terminar com barra.

Instale o Riversoft STCP DirectLink e o Riversoft STCP DirectLink Portal

dnf install -y stcpdirectlink stcpdirectlink-portal
cp /usr/local/stcpdirectlink/configs/example-config.json /usr/local/stcpdirectlink/configs/config.json
cp /usr/local/stcpdirectlink/static/portal/assets/configs/example-config.json /usr/local/stcpdirectlink/static/portal/assets/configs/config.json

O serviço stcpdirectlink é criado na instalação do pacote, mas não é iniciado.

Configure

No config.json do Riversoft STCP DirectLink, informe em cfgInstanceName o nome da instância, os dados dos bancos, o caminho da licença em applLicense, a porta e o certificado. Veja Configuração do Riversoft STCP DirectLink.

No config.json do Riversoft STCP DirectLink Portal (/usr/local/stcpdirectlink/static/portal/assets/configs/config.json), informe em url o endereço da API do Riversoft STCP DirectLink. Veja Configuração do Riversoft STCP DirectLink Portal.

Teste e inicie o serviço

Teste a configuração em primeiro plano:

/usr/local/bin/stcpdirectlink \
  -noService \
  -config /usr/local/stcpdirectlink/configs/config.json \
  -lang ptb \
  -langfile /usr/local/stcpdirectlink/configs/messages.json \
  -debugPath /usr/local/stcpdirectlink/logs

Se não houver erros, interrompa o teste (Ctrl+C) e inicie o serviço:

systemctl enable --now stcpdirectlink
systemctl status stcpdirectlink

Acesse o Riversoft STCP DirectLink Portal

Abra https://<dominio>/portal, entre com o usuário de teste, envie um arquivo e confira a área de download. Veja Uso do Riversoft STCP DirectLink Portal.

Resultado esperado: a Riversoft STCP Gemini API, o Riversoft Console Portal, o Riversoft STCP DirectLink e o Riversoft STCP DirectLink Portal em execução, com a troca de arquivos funcionando pelo portal.

Para roteamento e automação de arquivos, instale também o Riversoft STCP Gemini Rename no mesmo servidor do Riversoft STCP DirectLink.

Próximos passos

Início rápido da API

Uso do Riversoft STCP DirectLink Portal

Configuração

Ambiente de teste com Docker