Vai al contenuto principale

​
Elenco dei prerequisiti

Prepara e configura i seguenti componenti esterni prima di installare Vantage:
  • Una macchina con Docker e accesso a Internet (sulla quale viene installato Vantage)
  • Macchine virtuali (con accesso a Internet durante l’installazione) da utilizzare come nodi di Kubernetes
  • Un registro di container per archiviare le immagini Docker
  • Sistemi di gestione di database relazionali (RDBMS) per il funzionamento di Vantage
  • Un server SMTP per inviare messaggi di posta elettronica agli utenti di Vantage
  • Un certificato TLS per stabilire comunicazioni crittografate
  • 2 indirizzi IP statici: uno per la configurazione e la gestione di Kubernetes, uno per l’accesso a Vantage
  • Un record DNS per l’accesso a Vantage
  • Storage esterno (opzionale per la configurazione Without high availability)

​
Requisiti della macchina per l’installazione

La macchina da cui si esegue l’installazione di Vantage deve disporre di:
  • Sistema operativo Linux o Windows Subsystem for Linux (WSL)
  • Docker versione 19.03 o successiva
  • Accesso di rete a abyvtgonprm27.azurecr.io
  • File locali contenenti una chiave SSH privata (senza passphrase) per l’account utente ansible
Tutte le macchine virtuali devono avere la stessa chiave SSH.

​
Requisiti delle macchine virtuali

Tutte le macchine virtuali possono essere eseguite in VMware o Hyper-V e devono disporre di:
  • Un indirizzo IP statico
  • Un account utente denominato ansible con:
    • Accesso tramite chiave SSH condivisa
    • Accesso sudo con opzione NOPASSWD
  • Un disco dedicato ed espandibile/volume LVM (lvm_volume) montato su /opt/local-path-provisioner su ciascun nodo worker
  • Accesso a Internet durante l’installazione alle container registry e ai repository dei pacchetti:
    • Container registry con le immagini sincronizzate preparate come prerequisito per l’installazione di Vantage. Per ulteriori informazioni, consultare Downloading Container Images.
    • Repository dei pacchetti: Ubuntu (archive.ubuntu.com), RHEL (cdn.redhat.com). Invece dell’accesso ai repository dei pacchetti, è anche possibile configurare l’accesso a un proprio repository, che deve contenere tutti i pacchetti richiesti elencati di seguito.
Requisiti comuni (tutte le distribuzioni): 
curl, socat, unzip, e2fsprogs, xfsprogs, ebtables, tar
In base al sistema operativo: 
python3-apt, apt-transport-https, software-properties-common,
conntrack, libseccomp2

​
Accesso di rete post-installazione

Dopo l’installazione del cluster, le macchine virtuali devono avere accesso a:
  • https://licensing-us.abbyy.com
  • al server di posta, per il quale le impostazioni SMTP sono specificate nel file env_specific.yml (per l’invio di inviti via email, il recupero delle password, ecc.).
  • a tutti i server di posta da cui prevedi di importare le email nelle Process skill di Vantage. Devono essere i server di posta sui quali sono registrati gli indirizzi email da cui avviene l’importazione.

​
Configurazione ad alta disponibilità

È specificato il numero minimo richiesto di macchine virtuali. Requisiti di prestazioni differenti possono richiedere un numero diverso di macchine virtuali.
Tipo di nodo KubernetesNodi MasterNodi Worker (Services)Nodi Worker (Workers)
Sistema operativoUbuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8
Numero di VM341
Core CPU (per ogni VM)21212
RAM, GB (per ogni VM)44848
Archiviazione su disco per Kubernetes, GB (per ogni VM)508080
Disco/volume per il punto di montaggio /opt/local-path-provisioner, GBNon richiestoMinimo 40Minimo 40
Larghezza di banda di rete, Gbps (per ogni VM)111

​
Senza configurazione ad alta disponibilità

Tipo di nodo KubernetesNodi masterNodi worker (Services)Nodi worker (Workers)
Sistema operativoUbuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8Ubuntu 20.04 o RHEL 8
Numero di VM111
Core della CPU (per ogni VM)21212
RAM, GB (per ogni VM)44848
Archiviazione su disco per Kubernetes, GB (per ogni VM)508080
Disco/volume per il punto di montaggio /opt/local-path-provisioner, GBNon richiestoMinimo 40Minimo 40
Larghezza di banda di rete, Gbps (per ogni VM)111
La versione 1.28.4 di Kubernetes verrà installata durante l’installazione di Vantage.

​
Registro dei container

Puoi utilizzare qualsiasi registro di container.

​
Requisiti del database

È necessario disporre di un database Microsoft SQL Server con la seguente configurazione:
VersioneOSCore CPURAM, GBSpazio su disco, GBRicerca full-text
Enterprise 2022Linux44Consigliato: 400, Min: 200Abilitata
Deve essere configurato un server di database SQL esterno ed è necessario disporre delle credenziali appropriate per creare e gestire il nuovo database. Il programma di installazione richiede l’indirizzo IP di SQL Server, oltre a un nome utente e una password per la connessione al database.

​
Server SMTP

Il server deve funzionare tramite il protocollo SMTP. Il programma di installazione richiede l’indirizzo IP/nome DNS e la porta del server SMTP, oltre a una password per connettersi al server (se il server richiede l’autenticazione). Il server SMTP deve essere autorizzato a inviare email agli utenti di Vantage. Configura SMTP con o senza autenticazione in env_specific.yml.
Consigliamo di usare l’opzione con autenticazione (con login e password).
Con autenticazione (consigliato) Con login e password. In questo caso, la sezione smtp nel file env_specific.yml deve essere definita come segue: 
smtp:
  host: X.X.X.X
  login: email
  password: password
  port: 587
  useSSL: false
  secureSocketOptions: null
Senza autenticazione Senza nome utente e password. In questo caso, la sezione smtp nel file env_specific.yml deve essere definita come segue: 
mailFrom: email
smtp:
  host: X.X.X.X
  login: null
  password: null
  port: 25
  useSSL: false
  secureSocketOptions: None
Non dimenticare di aggiungere il Parameter mailFrom all’elemento radice.
Consigliamo di utilizzare l’opzione con autenticazione (con login e password).

​
Certificato TLS

È necessario disporre di un certificato wildcard o specifico per il dominio. Se l’installazione di Vantage si connetterà a servizi esterni utilizzando l’attività Custom o esporterà verso sistemi esterni, il certificato dovrà essere emesso da un’autorità di certificazione pubblica, ad esempio https://letsencrypt.org/.

​
Indirizzi IP statici

1. Accesso all’API di Kubernetes. Un indirizzo IP statico che verrà utilizzato come indirizzo IP virtuale per accedere all’endpoint del server API di Kubernetes per configurare e gestire il cluster. L’indirizzo IP deve essere definito nel file env_specific.yml come segue. Per ulteriori informazioni, vedere Impostazione dei file di configurazione: 
k8s:
  api:
    ip: X.X.X.X
2. Accesso ai servizi Vantage. È necessario un indirizzo IP statico che verrà utilizzato per accedere ai servizi Vantage tramite HTTPS. È necessario creare in anticipo un record DNS A appropriato. L’indirizzo IP deve essere definito nel file env_specific.yml come segue. Per ulteriori informazioni, consultare Installation: 
loadbalancer:
  external_ip: X.X.X.X

​
Record DNS per il successivo accesso a Vantage

Non sono previsti requisiti specifici. Il programma di installazione richiede un dominio primario e un nome DNS che sarà utilizzato per accedere a Vantage. Il record DNS deve puntare all’indirizzo IP dedicato all’accesso a Vantage.

​
Archiviazione esterna

L’archiviazione esterna è un requisito facoltativo esclusivamente per la configurazione Senza alta disponibilità. I requisiti relativi alle dimensioni del disco per la configurazione ad alta disponibilità sono descritti nella Guida alle prestazioni. ABBYY Vantage implementa un’archiviazione locale sui dischi rigidi delle macchine virtuali fornite, accelerando l’installazione del prodotto. Tuttavia, questa opzione può comunque risentire di riavvii imprevisti e arresti anomali delle macchine virtuali. Poiché ciò può comportare la perdita dei dati memorizzati, si consiglia di utilizzare un’archiviazione esterna durante l’installazione. ABBYY Vantage consente di definire l’utilizzo di specifici tipi di archiviazione nei modi descritti di seguito.

​
Utilizzo dell’archiviazione locale sui dischi rigidi delle macchine virtuali fornite

In questo caso, i volumi con accesso ReadWriteOnce compatibile con POSIX verranno predisposti localmente nella directory /opt/local_path_provisioner su ciascun nodo Kubernetes. Per i tipi di volume ReadWriteMany, Vantage effettuerà il deployment di un in-cluster nfs-kernel-server sul primo nodo abbyy_services (l’IP di questo nodo è il primo nel blocco corrispondente nel file inventory). I dati del server NFS saranno archiviati nella directory /opt/local_path_provisioner, quindi assicurati di avere un volume/disco dedicato per questo percorso sul primo nodo abbyy_services (il primo nodo di questo gruppo è definito nel file inventory) con una capacità minima di 500 GB. Per una configurazione ad alta disponibilità, il primo nodo abbyy_services ospiterà anche l’archiviazione locale per i volumi persistenti. Sarà necessaria ulteriore capacità del disco rigido a seconda del carico di elaborazione. Per i dettagli sulle quantità di spazio richieste, consulta la Performance Guide.
Se lo spazio dell’archiviazione locale dei volumi persistenti si esaurisce, Vantage potrebbe smettere di funzionare con perdita di alcuni dati. Ti consigliamo di monitorare lo spazio libero da parte tua e di configurare avvisi per lo spazio in esaurimento, in modo da poter aggiungere spazio di archiviazione in tempo e prevenire la perdita di dati.

​
Utilizzo di uno storage NFS esterno

Il programma di installazione di Vantage consente di configurare automaticamente uno storage NFS da utilizzare come spazio di archiviazione di Vantage per servizi specifici, ad esempio per importare ed esportare dati in una cartella condivisa e per archiviare i dati raccolti dal monitoraggio. La sezione nel file env_specific.yml avrà il seguente aspetto: 
k8s:
  storage:
    rwx:
      external:
        enabled: true
        type: "nfs"
        nfs:
          address: <indirizzo IP del server nfs>
          path: <condivisione esportata del server nfs>
Affinché Vantage funzioni correttamente, consigliamo di impostare per la directory radice del server NFS (ad esempio /opt/nfs) i seguenti permessi e il seguente proprietario: 
drwxr-xr-x 4 65532 65532 4096 Dec 12 09:25 /opt/nfs/
Di seguito è riportato un esempio di configurazione di directory nel file /etc/exports quando una macchina Linux viene utilizzata come server NFS: 
/opt/nfs *(rw,sync,all_squash,insecure,no_subtree_check,anonuid=65532,anongid=65532)
Nel caso in cui sia necessario collegare un altro tipo di storage, consultare la sezione Defining your own storage classes riportata di seguito.

​
Definire classi di storage personalizzate

Se vuoi utilizzare uno storage esterno non basato su NFS, segui i passaggi seguenti:
  1. Durante il processo di installazione, dopo aver creato il cluster Kubernetes (passaggio 4 in Esecuzione degli script di installazione), distribuisci i driver CSI (container storage interface) appropriati e crea le relative classi di storage per tali driver.
  2. Compila la sezione k8s nel file env_specific.yml utilizzando il seguente codice:
k8s:
  storage:
    rwo:
      class_name: "<rwo posix compatible storage class>"
    rwx:
      class_name: "<read_write_many_storage_class>"
  1. Proseguire con l’installazione.
Per lo storage NFS, configurare env_specific.yml: 
k8s:
  storage:
    rwx:
      external:
        enabled: true
        type: "nfs"
        nfs:
          address: <indirizzo IP del server nfs>
          path: <condivisione esportata del server nfs>
Se lo spazio sul volume persistente locale si esaurisce, Vantage potrebbe interrompere il funzionamento con conseguente perdita di dati. Monitora lo spazio libero e configura degli avvisi.