Atualização

Atualização e migração

Os componentes do Riversoft® STCP Gemini são distribuídos como pacotes RPM no repositório Riversoft e são atualizados pelo gerenciador de pacotes do sistema, dnf ou yum. Cada componente é um pacote e pode ser atualizado separadamente:

Componente	Pacote
Riversoft STCP Gemini API	`stcpgemini-api`
Riversoft Console Portal	`stcpgemini-portal`
Riversoft STCP Gemini Server	`stcpgemini-server`

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 as versões instaladas:

rpm -q stcpgemini-api stcpgemini-portal stcpgemini-server

Confira as versões disponíveis no repositório:

dnf makecache
dnf list --showduplicates stcpgemini-api stcpgemini-portal stcpgemini-server

Identifique as transferências em andamento e os agendamentos previstos para a janela de manutenção.
Defina o responsável pela mudança e o plano de reversão.

Backup

Arquivos de configuração dos componentes:

Componente	Arquivo
Riversoft STCP Gemini API	`/usr/local/stcpgemini-api/configs/config.json`
Riversoft Console Portal	`/usr/local/stcpgemini-api/portal/app/configs/config.json`
Riversoft STCP Gemini Server	`/usr/local/stcp/configs/stcpserver.config.json`

Banco de configuração e banco de log, conforme as políticas de backup da organização.
Certificados, chaves e licenças usados pelos componentes.

Procedimento de atualização

Pare os serviços

Pare o Riversoft STCP Gemini Server antes da API:

systemctl stop stcpgemini-server
systemctl stop stcpgemini-api

Atualize os pacotes

Atualize os metadados do repositório e os pacotes dos componentes instalados no servidor:

dnf clean all
dnf makecache
dnf upgrade stcpgemini-api stcpgemini-portal stcpgemini-server

Para atualizar para uma versão específica, informe a versão no nome do pacote, por exemplo dnf upgrade stcpgemini-server-6.6.18.

Revise a configuração

Os arquivos de configuração em uso não são substituídos pela atualização. Compare-os com os modelos (example-*.json) da nova versão para identificar parâmetros novos ou alterados, conforme as notas de versão. Se o gerenciador de pacotes criar arquivos com a extensão .rpmnew, compare-os com os arquivos em uso:

find /usr/local/stcpgemini-api /usr/local/stcp -name "*.rpmnew"

Atualize o banco de dados, quando necessário

Quando a nova versão exigir alterações no banco de dados, as notas de versão informam os scripts e a ordem de execução. Execute-os com o acompanhamento da equipe de DBA, como na preparação do banco de dados.

Inicie os serviços

Inicie a API antes do Server e confirme que os dois estão em execução:

systemctl start stcpgemini-api
systemctl start stcpgemini-server
systemctl status stcpgemini-api stcpgemini-server

Nota

Quando o Riversoft STCP DirectLink usa a mesma Riversoft STCP Gemini API e o mesmo Riversoft Console Portal, atualize primeiro a API e o Portal e depois cada produto, conferindo nas notas de versão a compatibilidade entre as versões.

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

rpm -q mostra a versão de destino de cada pacote.
systemctl status mostra running para a API e para o Server.
O Riversoft Console Portal abre e aceita o login.
O Server conecta ao banco e carrega a instância (ApplName), sem erros no log.
Uma transferência de teste com um parceiro é concluída nos dois sentidos.
Os agendamentos são executados.

Reversão (rollback)

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

Pare os serviços.
Volte os pacotes para a versão anterior registrada antes da atualização:
```
dnf downgrade stcpgemini-server-<versão-anterior>
```
Também é possível desfazer a transação inteira com dnf history undo <id>, em que <id> é o identificador da transação mostrado em dnf history. Com yum, use yum downgrade e yum history undo.
Restaure os arquivos de configuração do backup.
Se scripts de banco tiverem sido executados, restaure o backup dos bancos de dados.
Inicie os serviços e repita a validação.

Importante

A reversão depende de a versão anterior continuar disponível no repositório e de existir backup dos arquivos e dos bancos feito antes da atualização.

Migração entre versões principais

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

Instalação Segurança