Vai al contenuto principale
Questa sezione descrive il processo di aggiornamento di ABBYY Vantage all’ultima versione disponibile.
Prima di aggiornare Vantage, assicurarsi che tutti i requisiti della nuova release elencati nella sezione Requisiti di sistema siano soddisfatti.
Il processo di aggiornamento consiste nei seguenti passaggi:
  1. Sincronizzare le immagini dei container.
  2. Eseguire il backup dei dati.
  3. Eseguire gli script di installazione.
  4. Disinstallare Vantage.
  5. Aggiornare ABBYY Vantage.

​
Sincronizzare le immagini dei container

Per sincronizzare le immagini dei container, seguire i passaggi in Scaricare le immagini dei container.

​
Eseguire il backup dei dati

Per ripristinare Vantage alla versione in esecuzione al momento dell’aggiornamento, è necessario disporre di un backup dei database, di Consul e di copie delle secret di Kubernetes. Seguire i passaggi riportati di seguito per eseguire correttamente il backup di questi componenti:
  1. Prima di creare un backup dei database e di Consul, è necessario arrestare il cluster. Arrestare tutti i nodi del cluster.
  2. Creare un backup di:
    • Database: L’elenco dei database è: 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: Il CronJob di Kubernetes esegue il backup di Consul su uno storage RWX esterno (come NFS) tramite un pod denominato [X].consul-backup. È possibile recuperare i file TGZ di backup dalla cartella PVC denominata consul-backup.
  3. Avviare il cluster. Avviare tutti i nodi del cluster.
  4. Eseguire il backup delle copie delle secret di Kubernetes. Per ottenere le chiavi, eseguire i seguenti comandi:
kubectl get secret -n abbyy-vantage secretstorage-encryptionkeys -o yaml
kubectl get secret -n abbyy-vantage tokenmanagement-encryptionkeys -o yaml
Prima di eseguire il backup delle copie dei secret di Kubernetes, assicurarsi che il cluster sia in esecuzione.
I backup vengono eseguiti solo a scopo precauzionale. Se l’aggiornamento va a buon fine, non sarà necessario effettuare il ripristino dal backup.

​
Eseguire gli script di installazione

Prima di aggiornare ABBYY Vantage, seguire i passaggi descritti in Installation. Per eseguire gli script di installazione:
  1. Configurare i file di configurazione.
Per impostazione predefinita, il Technology Core versione 2 viene eliminato durante l’aggiornamento di Vantage. Per mantenerlo, aggiungere il parametro techcore.keep_previous_version al file env_specific.yml e impostarne il valore su true.
  1. Preparare i certificati.
  2. Scaricare le immagini dei container.
  3. Eseguire gli script di installazione (passaggi 1-3).

​
Disinstallare Vantage

Esegui il seguente playbook per disinstallare il prodotto: 
ansible-playbook -i inventories/k8s -v playbooks/uninstall-vantage.yml
Questo playbook rimuoverà tutti i servizi, lasciando integro l’archivio dati.

​
Aggiornare ABBYY Vantage

Per aggiornare ABBYY Vantage:
  1. Esegui i seguenti playbook per effettuare una verifica pre-distribuzione e per leggere e accettare i documenti legali di Vantage:
ansible-playbook -i inventories/k8s -v playbooks/0-PreflightCheck-k8s.yml
ansible-playbook -i inventories/k8s -v playbooks/legal.yml
I playbook eseguiranno:
  • Un controllo preliminare delle risorse per cui i Parameter sono specificati nel file env_specific.yml del playbook (database, connessione SMTP, ecc.).
  • Una richiesta all’amministratore di sistema di accettare i termini dell’EULA e dell’Informativa sulla privacy di ABBYY.
  1. Eseguire il seguente playbook per aggiornare Vantage:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml
I playbook installeranno una nuova versione del prodotto. In media, il processo richiederà circa 20-30 minuti.
Dopo l’aggiornamento di ABBYY Vantage, dovrai eseguire nuovamente l’autorizzazione. I token di autorizzazione ottenuti prima dell’aggiornamento non saranno più validi.
Per lavorare con Advanced Designer e Scanning Station, è necessario scaricare le nuove versioni e installarle sulle tue macchine:
  • https://<your-vantage-host>/ad/latest - per scaricare Advanced Designer
  • https://<your-vantage-host>/ss/latest - per scaricare Scanning Station
Se il processo di aggiornamento non va a buon fine, consulta la sezione seguente, Recovery.

​
Ripristino

Se il processo di aggiornamento non è riuscito, segui questi passaggi:
  1. Verifica che i pod nel cluster funzionino correttamente e riavviali se non lo fanno.
  2. Analizza i log dei pod che non funzionano come previsto.
  3. Segui le procedure di risoluzione dei problemi indicate nei log dei pod.
  4. Se l’aggiornamento non riesce in una qualsiasi fase dell’installazione di una nuova versione di Vantage (ad esempio, in attesa dei job di Vantage, in attesa dei deployment di Vantage), risolvi la causa dell’errore e quindi esegui il playbook di installazione:
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml

​
Installazione di Vantage con recupero dati su un nuovo cluster

Se i passaggi descritti sopra non hanno risolto il problema, puoi installare Vantage con recupero dati su un nuovo cluster seguendo questi passaggi:
  1. Assicurati di avere tutti i backup più recenti dei tuoi dati.
  2. Ripristina i dati dai backup che hai creato in precedenza.
  3. Prepara il file env_specific contenente i dati per la connessione ai database e agli archivi esterni ripristinati dai backup.
  4. Installa Vantage seguendo i passaggi descritti in Running the installation scripts nella sezione Installazione. Per il passaggio 2 (esecuzione del programma di installazione da un’immagine Docker), utilizza il comando riportato di seguito:
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. Sovrascrivi i valori delle chiavi nei secret secretstorage-encryptionkeys e tokenmanagement-encryptionkeys con i valori di cui hai eseguito il backup in precedenza: a. Esegui il comando: 
    kubectl edit secrets -n abbyy-vantage secretstorage-encryptionkeys
    b. Nel file che si apre, dopo key-<guid>.xml, sostituisci la stringa base64 con quella contenuta nella chiave che avevi precedentemente sottoposto a backup per il secret secretstorage-encryptionkeys. c. Salva le modifiche e chiudi l’editor. d. Esegui la stessa operazione per il secret tokenmanagement-encryptionkeys utilizzando il comando: 
    kubectl edit secrets -n abbyy-vantage tokenmanagement-encryptionkeys
  2. Dopo aver riscritto le chiavi, riavvia i pod 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. Riavvia le transaction. Su una macchina connessa al cluster, esegui il seguente comando per accedere al servizio di transaction:
kubectl port-forward -n abbyy-vantage deployments/abbyy-vantage-transactions 8080:8080
Nel browser, apri l’indirizzo http://localhost:8080/index.html ed esegui il seguente metodo API: 
/api/recovery/transactions/restart
Se l’indirizzo host di Vantage è cambiato dopo il ripristino e nel sistema sono presenti inviti non accettati, è necessario reinviare questi inviti.