Atualização e migração

O Riversoft® STCP Gemini Rename é distribuído como pacote RPM (stcpren), no repositório Riversoft, e como pacote DEB. Ele é atualizado pelo gerenciador de pacotes do sistema.

Boas práticas

• Leia as notas de versão de todas as versões entre a instalada e a de destino. Elas informam mudanças de comportamento, novos parâmetros e procedimentos específicos.
• Atualize primeiro um ambiente de homologação e repita os testes dos fluxos críticos antes de atualizar a produção.
• Planeje uma janela de manutenção e comunique os parceiros quando houver indisponibilidade das transferências.
• Faça backup da configuração e dos bancos de dados antes de cada atualização.
• Atualize uma versão de destino por vez e mantenha a mesma versão em todos os servidores do ambiente.
• Registre a versão anterior de cada pacote para poder fazer a reversão.

Antes de atualizar

Levantamento

• Registre a versão instalada:

  stcpren -v

• No Enterprise Linux, confira as versões disponíveis no repositório:

  dnf makecache
  dnf list --showduplicates stcpren

• Identifique os eventos, os comandos externos e os agendamentos que acionam o Riversoft STCP Gemini Rename durante a janela de manutenção.

• Defina o responsável pela mudança e o plano de reversão.

Backup

• Arquivo de configuração /usr/local/stcpren/configs/config.json.
• Banco de configuração, onde ficam os roteamentos, conforme as políticas de backup da organização. Para uma cópia rápida de um roteamento, use -export.
• No modo arquivo local, os arquivos JSON dos roteamentos.
• Os arquivos de número sequencial (.seq) do diretório applLockDir.

Procedimento de atualização

dnf clean all
dnf makecache
dnf upgrade stcpren

yum clean all
yum makecache
yum update stcpren

apt install ./stcpren-<versão>_amd64.deb

find /usr/local/stcpren -name "*.rpmnew"

stcpren -v
stcpren -db -rules <ROTEAMENTO> -scan <diretório-de-origem> -test

Validação após a atualização

• stcpren -v mostra a versão de destino.
• O teste dos roteamentos (-test) mostra as regras esperadas, sem MSG7003.
• Um roteamento acionado por evento ou por agendamento processa os arquivos como esperado.
• Os agendamentos suspensos foram reativados.

Reversão (rollback)

Se a validação falhar e a causa não puder ser corrigida dentro da janela de manutenção:

1. Suspenda novamente as execuções.

2. Volte o pacote para a versão anterior registrada antes da atualização:

   dnf downgrade stcpren-<versão-anterior>

   Também é possível desfazer a transação com dnf history undo <id>. Com yum, use yum downgrade e yum history undo. No Ubuntu, instale o pacote DEB da versão anterior.

3. Restaure o arquivo de configuração do backup.

4. Repita a validação e reative os agendamentos.

Migração entre versões principais

Quando uma versão exigir migração, com mudança em parâmetros, regras ou comportamento, o procedimento específico é publicado nas notas de versão. Siga esse procedimento em vez da atualização simples descrita nesta página.

Conversão de regras INI

Regras de versões anteriores em formato INI podem ser convertidas para o formato JSON usado nesta versão:

stcpren -ini /caminho/regras.ini -rules /usr/local/stcpren/configs/regras.json

A conversão lê a seção General e a seção FileMatching, em que as chaves Rule0, Rule1 e seguintes indicam as seções com a definição de cada regra. O resultado é registrado nas mensagens MSG7039 (sucesso) ou MSG7038 (falha).

Depois da conversão:

1. Revise o arquivo gerado. Veja Referência de regras.

2. Teste com -test sobre arquivos de exemplo:

   stcpren -rules /usr/local/stcpren/configs/regras.json -scan <diretório-de-teste> -test

3. Use o arquivo no modo arquivo local ou cadastre o roteamento no Riversoft Console Portal para o modo banco de dados.