Administração
O Riversoft® STCP Gemini Rename usa a mesma instância e o mesmo Riversoft Console Portal do Riversoft STCP Gemini Server e do Riversoft STCP DirectLink. Não há um portal próprio.
A administração é feita pelo Riversoft® Console Portal, a interface web de configuração e supervisão de instâncias, usuários, serviços de rede, agendamentos e demais recursos. O mesmo Portal configura e monitora o Riversoft STCP Gemini e o Riversoft STCP DirectLink: usados juntos ou separadamente, os dois produtos compartilham a mesma gestão.
Primeiro acesso
Acesse o Portal pelo navegador, informando o endereço (IP e porta ou URL) em que a Riversoft STCP Gemini API está em execução.
No primeiro acesso, use as credenciais padrão:
| Campo | Valor |
|---|---|
| Operador | stcpadmin |
| Senha | Admin |
Atenção
Troque a senha padrão imediatamente após o primeiro acesso.
Criação da instância
Depois do login, crie no Portal a instância que o produto vai usar e informe o nome dela na configuração do produto:
| Produto | Parâmetro |
|---|---|
| Riversoft STCP Gemini Server | ApplName (veja Configuração) |
| Riversoft STCP DirectLink | cfgInstanceName (veja Configuração) |
| Riversoft STCP Gemini Rename | cfgInstanceName, igual ao ApplName do Riversoft STCP Gemini Server (veja Configuração) |
Importante
O Riversoft STCP Gemini Server e o Riversoft STCP DirectLink não iniciam sem uma instância configurada. Na inicialização, cada produto lê a instância no banco de configuração pelo nome informado em ApplName ou cfgInstanceName. Se o nome não existir, o serviço não inicia e registra o erro no log. O Riversoft STCP Gemini Rename, quando usa o banco de dados, também depende da instância e não executa corretamente sem ela.
- Crie a instância no Riversoft Console Portal antes de iniciar os serviços.
- Informe o nome exatamente como foi cadastrado.
Serviços de supervisão
O Riversoft Console Portal acompanha e opera o Riversoft STCP Gemini Server e o Riversoft STCP DirectLink pelos serviços de supervisão. A Riversoft STCP Gemini API conecta a esses serviços, e o Portal recebe as respostas por uma rota específica da API.
Cadastre na instância um serviço de rede de supervisão para cada produto em uso:
| Serviço de rede | Produto | Porta padrão |
|---|---|---|
| Supervisão (gemini) | Riversoft STCP Gemini Server | 33050 |
| Supervisão (directlink) | Riversoft STCP DirectLink | 33060 |
Em cada serviço de supervisão, configure:
- o endereço e a porta em que o produto aguarda as conexões de supervisão;
- a credencial de supervisão, usada para autenticar as conexões da API;
- o TLS, quando a conexão passar por redes não confiáveis.
Depois, no cadastro API/Supervisão do Riversoft Console Portal, informe o endereço, a porta e a credencial de cada serviço de supervisão, para que a Riversoft STCP Gemini API consiga se conectar a ele.
Nota
As portas de supervisão precisam estar acessíveis somente a partir do servidor da Riversoft STCP Gemini API. Não as publique para redes externas.
Recursos administrados no Portal
| Recurso | Descrição |
|---|---|
| Instâncias | Conjuntos de configuração usados pelo Riversoft STCP Gemini Server e pelo Riversoft STCP DirectLink. |
| Usuários | Parceiros e sistemas que trocam arquivos com a instância. |
| Serviços de rede | Protocolos, endereços, portas e segurança das conexões. |
| Agendamentos | Conexões e tarefas executadas em datas ou intervalos definidos. |
| Tipos de arquivo | Regras e tags aplicadas aos arquivos. |
| Roteamentos e regras | Definições usadas pelo Riversoft STCP Gemini Rename. |
Os mesmos recursos podem ser gerenciados por integração, pela Riversoft STCP Gemini API.
Roteamentos
Os roteamentos são cadastrados na instância, no Riversoft Console Portal, pelos operadores com permissão de configuração. Cada roteamento tem um nome, informado em -rules na execução.
Boas práticas:
- Use nomes curtos e estáveis: o nome está nos eventos e nos agendamentos que acionam o roteamento.
- Ordene as regras da mais específica para a mais genérica, porque vale a primeira que corresponder.
- Antes de ativar uma alteração, teste o roteamento com
-test. Veja Testar um roteamento. - Bloqueie uma regra (
Locked) em vez de apagá-la quando quiser suspendê-la temporariamente. - Exporte os roteamentos com
-exportantes de alterações grandes, para ter uma cópia de comparação.
A estrutura dos roteamentos está em Referência de regras.
Licença
O arquivo de licença é fornecido pela Riversoft, é vinculado ao número de série da instância e é informado em License. Na inicialização, o número de série e a licença são validados e a mensagem MSG7909 registra a empresa, a validade e os módulos. Sem licença válida, a execução termina com o código 4. Antes do vencimento, solicite a renovação ao Suporte e substitua o arquivo.