Pular para o conteúdo principal
Esta seção apresenta o processo de atualização do ABBYY Vantage para a versão mais recente disponível.
Antes de atualizar o Vantage, verifique se todos os requisitos da nova versão listados na seção System Requirements foram satisfeitos.
O processo de atualização consiste nas seguintes etapas:
  1. Sincronizar imagens de contêiner.
  2. Fazer backup dos dados.
  3. Executar os scripts de instalação.
  4. Desinstalar o Vantage.
  5. Atualizar o ABBYY Vantage.

​
Sincronizar imagens de contêiner

Para sincronizar imagens de contêiner, siga as etapas em Baixar imagens de contêiner.

​
Fazer backup dos dados

Para restaurar o Vantage para a versão que estava em execução no momento da atualização, você deve ter um backup dos bancos de dados, do Consul e de cópias dos segredos do Kubernetes. Siga as etapas abaixo para fazer o backup correto desses componentes:
  1. Antes de criar um backup dos bancos de dados e do Consul, é necessário parar o cluster. Desligue todos os nós do cluster.
  2. Crie um backup de:
    • Bancos de dados: A lista de bancos de dados é: apigatewayregistry, auth, auth-identity, catalogstorage, cron, documentset, folderimport, interactive-jobs, mail, mailimport, permissions, publicapi, reporting, secretstorage, security-audit, skillinfo, skillmonitor, storage, subscriptions, tokenmanagement, transactions, workflows, workspace.
    • Consul: O Kubernetes CronJob faz backup do Consul em um armazenamento RWX externo (como NFS), em pods com o nome [X].consul-backup. Você pode obter os arquivos TGZ de backup na pasta PVC chamada consul-backup.
  3. Inicie o cluster. Inicie todos os nós do cluster.
  4. Faça backup de cópias dos segredos do Kubernetes. Para obter as chaves, execute os seguintes comandos:
kubectl get secret -n abbyy-vantage secretstorage-encryptionkeys -o yaml
kubectl get secret -n abbyy-vantage tokenmanagement-encryptionkeys -o yaml
Antes de criar um backup das cópias de segredos do Kubernetes, certifique-se de que o cluster esteja em execução.
Backups são criados apenas por precaução. Se a atualização for bem-sucedida, você não precisará restaurar a partir do backup.

​
Executar os scripts de instalação

Antes de atualizar o ABBYY Vantage, siga as etapas de Instalação. Para executar os scripts de instalação:
  1. Configure os arquivos de configuração.
Por padrão, o technology core versão 2 é excluído ao atualizar o ABBYY Vantage. Para mantê-lo, adicione o parâmetro techcore.keep_previous_version ao arquivo env_specific.yml e defina seu valor como true.
  1. Prepare os certificados.
  2. Baixe as imagens de contêiner.
  3. Execute os scripts de instalação (passos 1-3).

​
Desinstalar o ABBYY Vantage

Execute o seguinte playbook para desinstalar o produto: 
ansible-playbook -i inventories/k8s -v playbooks/uninstall-vantage.yml
Este playbook removerá todos os serviços, mas deixará o repositório de dados intacto.

​
Atualizar o ABBYY Vantage

Para atualizar o ABBYY Vantage:
  1. Execute os seguintes playbooks para realizar uma verificação pré-implantação e ler e aceitar os documentos legais do Vantage:
ansible-playbook -i inventories/k8s -v playbooks/0-PreflightCheck-k8s.yml
ansible-playbook -i inventories/k8s -v playbooks/legal.yml
Os playbooks:
  • Realizarão uma verificação preliminar dos recursos para os quais os Parameters estão especificados no arquivo env_specific.yml do playbook (banco de dados, conexão SMTP, etc.).
  • Solicitarão ao administrador do sistema que aceite os termos do EULA e da Política de Privacidade da ABBYY.
  1. Execute o seguinte playbook para atualizar o Vantage:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml
Os playbooks vão instalar uma nova versão do produto. Em média, o processo levará cerca de 20 a 30 minutos.
Após a atualização do ABBYY Vantage, você terá que realizar a autorização novamente. Os tokens de autorização obtidos antes da atualização não funcionarão mais.
Para trabalhar com o Advanced Designer e o Scanning Station, você precisa baixar as novas versões e instalá-las em seus computadores:
  • https://<your-vantage-host>/ad/latest - para baixar o Advanced Designer
  • https://<your-vantage-host>/ss/latest - para baixar o Scanning Station
Se o processo de atualização falhar, consulte a seção a seguir, Recovery.

​
Recuperação

Se o processo de atualização não for bem-sucedido, siga estas etapas:
  1. Verifique se os pods do cluster estão funcionando corretamente e reinicie-os se não estiverem.
  2. Analise os logs dos pods que não estão funcionando conforme o esperado.
  3. Siga os procedimentos de solução de problemas indicados nos logs dos pods.
  4. Se a atualização falhar em qualquer etapa da instalação de uma nova versão do Vantage (por exemplo, aguardando jobs do Vantage, aguardando deployments do Vantage), corrija a causa do erro e, em seguida, execute o playbook de instalação:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml

​
Instalando o Vantage com recuperação de dados em um novo cluster

Se as etapas descritas acima não resolverem o problema, você pode instalar o Vantage com recuperação de dados em um novo cluster seguindo estas etapas:
  1. Certifique-se de que você tem todos os backups mais recentes dos seus dados.
  2. Restaure os dados a partir dos backups que você criou anteriormente.
  3. Prepare o arquivo env_specific contendo os dados de conexão com os bancos de dados e o armazenamento externo restaurados a partir dos backups.
  4. Instale o Vantage seguindo as etapas de Running the installation scripts na seção Installation. Para a etapa 2 (executar o instalador a partir de uma imagem Docker), use o comando a seguir:
docker run -it --net=host \
-v $PWD/kube:/root/.kube \
-v $PWD/inventory:/ansible/inventories/k8s/inventory \
-v $PWD/env_specific.yml:/ansible/inventories/k8s/group_vars/all/env_specific.yml \
-v $PWD/ssl:/ansible/files/ssl:ro \
--privileged \
registry.local/vantage/vantage-k8s:2.7.1
  1. Substitua os valores de chave nos secrets secretstorage-encryptionkeys e tokenmanagement-encryptionkeys pelos valores que você fez backup anteriormente: a. Execute o comando: 
    kubectl edit secrets -n abbyy-vantage secretstorage-encryptionkeys
    b. No arquivo que é aberto após key-<guid>.xml, substitua a string base64 pela string base64 contida na chave que foi previamente copiada para backup para o secret secretstorage-encryptionkeys. c. Salve suas alterações e feche o editor. d. Faça o mesmo para o secret tokenmanagement-encryptionkeys usando o comando: 
    kubectl edit secrets -n abbyy-vantage tokenmanagement-encryptionkeys
  2. Após sobrescrever as chaves, reinicie os pods secretstorage e tokenmanagement: 
kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=secretstorage -o name)

kubectl -n abbyy-vantage rollout restart $(kubectl -n abbyy-vantage get deployments -l app.kubernetes.io/component=tokenmanagement -o name)
  1. Reinicie as transações. Em uma máquina conectada ao cluster, execute o seguinte comando para acessar o serviço de transações:
kubectl port-forward -n abbyy-vantage deployments/abbyy-vantage-transactions 8080:8080
No seu navegador, acesse http://localhost:8080/index.html e execute o seguinte método de API: 
/api/recovery/transactions/restart
Se o endereço do host do Vantage tiver sido alterado após a recuperação e houver convites pendentes no sistema, será necessário reenviar esses convites.