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 dell’infrastruttura

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
Pacchetti specifici per sistema operativo:
Ubuntu 20.04RHEL 8
python3-apt, apt-transport-https, software-properties-common, conntrack, libseccomp2device-mapper-libs, nss, conntrack, container-selinux, libseccomp

​
Accesso di rete post-installazione

Dopo l’installazione del cluster, le macchine virtuali devono avere accesso a:
  • https://licensing-us.abbyy.com
  • Il server di posta, per il quale le impostazioni SMTP sono specificate nel file env_specific.yml (per l’invio di inviti tramite email, il recupero delle password, ecc.).
  • Tutti i server di posta da cui si prevede di importare le email nelle Process skill di Vantage.

​
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.33.3 di Kubernetes verrà installata durante l’installazione di Vantage.

​
Container Registry

Puoi utilizzare qualsiasi container registry.

​
Requisiti del database

È necessario disporre di un database Microsoft SQL Server o PostgreSQL con la seguente configurazione:Opzione 1: Microsoft SQL Server
VersioneOSCore CPURAM, GBSpazio su disco, GBRicerca full-text
Enterprise 2022Linux44Consigliato: 400, Min: 200Abilitata
Opzione 2: PostgreSQL
VersioneCore CPURAM, GBSpazio su disco, GB
14+44Consigliato: 400, Min: 200
Deve essere configurato un server di database 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 l’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.

​
Requisiti di archiviazione

Lo storage esterno è un requisito facoltativo solo per la configurazione Without high availability. I requisiti di dimensione del disco per la configurazione ad alta disponibilità sono descritti nella Performance Guide.ABBYY Vantage distribuisce lo storage locale sui dischi rigidi delle macchine virtuali fornite, il che velocizza l’installazione del prodotto. Tuttavia, questa opzione può comunque essere influenzata da riavvii inattesi e arresti anomali delle macchine virtuali. Poiché ciò può comportare la perdita dei dati archiviati, durante l’installazione si consiglia di utilizzare uno storage esterno.ABBYY Vantage consente di definire l’utilizzo di tipi di storage specifici nei modi elencati di seguito.

​
Utilizzo di uno storage locale

In questo caso, i volumi con accesso ReadWriteOnce compatibile POSIX verranno forniti localmente nella directory /opt/local_path_provisioner su ciascun nodo Kubernetes. Per i tipi di volume ReadWriteMany, Vantage distribuirà 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 verranno archiviati nella directory /opt/local_path_provisioner, quindi assicurarsi di disporre di un volume/disco dedicato per questo percorso sul primo nodo abbyy_services (il primo nodo di questo gruppo è definito nel file inventory) con una dimensione minima di 500 GB.Per la configurazione ad alta disponibilità, il primo nodo abbyy_services ospiterà anche lo storage locale del volume persistente. Sarà necessaria una capacità aggiuntiva del disco rigido in base al carico di elaborazione. Per i dettagli sulle quantità richieste, vedere la Performance Guide.
Se lo storage locale del volume persistente esaurisce lo spazio, Vantage potrebbe interrompere il funzionamento con perdita di alcuni dati. Si consiglia di monitorare lo spazio libero dal proprio lato e di configurare avvisi quando lo spazio sta per esaurirsi, in modo da poter aggiungere tempestivamente altro storage 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.

​
Definizione delle proprie classi di storage

Se si desidera utilizzare uno storage esterno non NFS, seguire i passaggi riportati di seguito:
  1. Durante il processo di installazione, dopo la creazione del cluster Kubernetes (fase 4 in Running the installation scripts), distribuire i driver CSI (container storage interface) appropriati e creare le relative classi di storage.
  2. Compilare 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.
Se l’archiviazione locale su volumi persistenti esaurisce lo spazio, Vantage potrebbe arrestarsi causando la perdita di dati. Monitorare lo spazio libero e configurare avvisi.

​
Cluster Redis (solo Azure AKS)

Un cluster Redis è richiesto solo per la configurazione ad alta disponibilità (Highly Available) di Azure AKS. Non è richiesto per distribuzioni su Macchine Virtuali o per distribuzioni Azure non ad alta disponibilità.
Per le distribuzioni Azure AKS ad alta disponibilità è richiesto un cluster Redis esterno con la seguente configurazione:
ConfigurationRequirement
Redis Version6.2 o successiva
Number of Nodes6 o più
RAM per Node4 GB (minimo)
Cluster ModeAbilitato
Cluster PasswordObbligatoria
SSH Port22 (per la configurazione)
Le seguenti opzioni devono essere impostate in redis.conf: 
appendonly yes
cluster-config-file nodes-6379.conf
cluster-enabled yes
cluster-node-timeout 5000
cluster-require-full-coverage no
maxclients 10000
maxmemory 2048mb
maxmemory-policy noeviction
repl-backlog-size 256mb
repl-ping-slave-period 5
save ""
slave-serve-stale-data yes
stop-writes-on-bgsave-error no
supervised auto
masterauth <password>
requirepass <password>
Il valore di maxmemory deve essere impostato a metà della memoria disponibile su ciascun nodo Redis. Sostituisci <password> con la password del tuo cluster.
Azure Cache for Redis non è attualmente supportato. Devi distribuire Redis su macchine virtuali fuori dal cluster AKS. Il supporto per Azure Cache for Redis è previsto in una prossima versione.