Configurare il disaster recovery per ArcGIS Enterprise—Portal for ArcGIS

È possibile replicare l'installazione ArcGIS Enterprise in un'installazione in standby priva di connessioni. L'installazione in standby può essere attivata e resa attiva in caso di guasto dell'installazione primaria.

Poiché l'installazione in standby non è connessa in maniera attiva all'installazione primaria, è possibile configurare l'installazione in standby in un altro edificio o città per proteggerla da tempi di inattività dovuti a eventi quali calamità naturali o black-out elettrici. Tenere presente, tuttavia, che l'installazione in standby deve essere accessibile dai client.

Esportare i componenti del Web GIS dell'installazione ArcGIS Enterprise principale in un file compresso tramite il comando webgisdr e utilizzare il file compresso per configurare e gestire l'ambiente in di standby.

Prima di configurare il disaster recovery, assicurarsi di aver letto Disaster recovery e replica.

Esportare ArcGIS Enterprise

utilizzare il comando webgisdr per effettuare un'operazione di esportazione di un file contenente le proprietà dell'installazione ArcGIS Enterprise principale. Il file esportato include il portale, il server di hosting, i server federati e il data store relazionale La dimensione del file e il tempo richiesto per la creazione variano in base al numero di elementi nel portale, il numero e il tipo di layer Web ospitati disponibili, il numero di server federati disponibili e il numero di computer ArcGIS Server presenti nei server di hosting e federati.

È possibile trovare il comando webgisdr nella directory degli strumenti Portal for ArcGIS. Per utilizzare questo strumento, è necessario soddisfare i seguenti criteri:

La directory condivisa specificata deve essere abbastanza grande da contenere il file esportato. Eseguire un'esportazione di prova dell'installazione ArcGIS Enterprise per avere un'idea delle dimensioni finali del file, decidere il numero di file che si desidera mantenere nella directory condivisa e adattare le dimensioni della directory di conseguenza.
Il nome, ID utente o ID gruppo dell'account che è stato utilizzato per installare ogni componente software in ArcGIS Enterprise sulle installazioni principale e in standby, nonché l'account utilizzato per eseguire il comando webgisdr devono essere identici e devono disporre di privilegi di lettura e scrittura sulla directory condivisa.

Per esportare l'installazione primaria di ArcGIS Enterprise, attenersi alla procedura seguente:

Creare una copia del file delle proprietà del template. È possibile salvare la copia nella stessa directory del template o in una nuova directory.
Il file delle proprietà del modello, webgisdr.properties, è installato in /arcgis/portal/tools/webgisdr per impostazione predefinita.
In questo esempio, la copia del file è denominata mywebgis.properties ed è salvata in /home/ags/arcgis/portal/propfiles.
Aprire la copia del file delle proprietà e modificarla per includere le informazioni specifiche del proprio sito.
- SHARED_LOCATION = < percorso dei file di backup>
  Specificare una directory condivisa nella quale creare una copia temporanea dei file di backup per ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store. L'account che ha installato ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store e l'account che esegue lo strumento webgisdr devono disporre di privilegi di lettura e scrittura. Accertarsi che la directory sia abbastanza grande da contenere il file di backup. Sebbene sia compresso, il file può essere abbastanza grande in base alla quantità e al tipo di dati a disposizione. Se si dispone di layer di mappa e cache e si imposta INCLUDE_SCENE_TILE_CACHES su true, il file di backup ArcGIS Data Store può essere particolarmente grande.
  Legacy:
  In Portal for ArcGIS 10.4 questa proprietà era SHARED_FOLDER.
- BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | Azure}
  Se si desidera archiviare il backup di ArcGIS Enterprise in una directory condivisa on-premises, specificare FileSystem e lo strumento webgisdr archivierà i file di backup nella cartella di condivisione specificata per BACKUP_LOCATION.
  Se si desidera archiviare i backup di ArcGIS Enterprise in un bucket di Amazon Simple Storage Service (S3), creare un bucket S3 appositamente per archiviare i backup generati con lo strumento webgisdr e aggiornare le proprietà S3 con le informazioni necessarie per accedere al bucket.
  Se si desidera archiviare i backup di ArcGIS Enterprise in un'archiviazione Azure Blob, creare un contenitore di archiviazione Azure Blob specificatamente per la memorizzazione dei file di backup generati dall'utilità webgisdr e aggiornare le proprietà Azure con le informazioni necessarie per accedere al contenitore.
- BACKUP_LOCATION = <posizione dei file di backup on-premises>
  I file di backup saranno inizialmente archiviati in SHARED_LOCATION, ma in seguito saranno copiati in BACKUP_LOCATION. Accertarsi che la directory sia abbastanza grande da contenere il file di backup. Anche se il file è compresso, può essere abbastanza grande a seconda della quantità e del tipo di dati presenti. L'account che esegue lo strumento webgisdr deve avere privilegi di lettura e di scrittura sulla BACKUP_LOCATION.
  Quando BACKUP_LOCATION è una cartella, lo strumento per il disaster recovery importa il file di backup più recente disponibile in quella cartella. Se BACKUP_LOCATION è un file di backup specifico nella cartella, quel file viene importato dallo strumento per il disaster recovery.
- PORTAL_ADMIN_URL = <URL della directory di amministrazione del portale>
  Specificare l'URL della directory di amministrazione di Portal for ArcGIS. Usare il formato https://portalhostname.domain.com:7443/arcgis, dove portalhostname.domain.com l'FQDN del computer in cui è installato Portal for ArcGIS.
- PORTAL_ADMIN_USERNAME = <nome utente dell'amministratore del portale>
  Specificare il nome utente di un membro del portale assegnato al ruolo amministratore definito da Esri.
- PORTAL_ADMIN_PASSWORD = <password dell'amministratore del database>
  Specificare la password dell'account dell'amministratore del portale.
- PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>
  Impostare questa opzione su false la prima volta che si compila il file con la password dell'amministratore. Quando si salva il file, la password viene crittografata e il valore di PORTAL_ADMIN_PASSWORD_ENCRYPTED è impostato su true per indicare che la password è stata crittografata. Se è necessario modificare la password in futuro, impostare PORTAL_ADMIN_PASSWORD_ENCRYPTED = false, fornire la nuova password dell'amministratore e salvare il file.
- INCLUDE_SCENE_TILE_CACHES = <true | false>
  Se i layer hosted del servizio 3D vengono pubblicati nel portale e si desidera includere i dati di cache nel backup, impostare INCLUDE_SCENE_TILE_CACHES su true. Tenere presente che, se impostato su true, tutti i dati di cache del servizio 3D sono inclusi nel backup, non solo i nuovi dati di cache creati dall'ultimo backup. Se nessuna nuova cache del servizio 3D è stata creata dall'ultimo backup o se i servizi non vengono pubblicati nel portale, è possibile impostare INCLUDE_SCENE_TILE_CACHES su false.
- BACKUP_RESTORE_MODE = <full | incremental>
  Se vengono creati solo backup completi, è possibile impostare questa proprietà su full. Per ridurre la dimensione dei backup, è possibile creare due file delle proprietà diversi: uno con BACKUP_RESTORE_MODE = full (utilizzato occasionalmente per la creazione di backup completi) e uno con BACKUP_RESTORE_MODE = incremental (per generare backup incrementali tra due backup completi). Ogni backup incrementale contiene tutte le modifiche dall'ultimo backup completo.
- Se la distribuzione di ArcGIS Enterprise viene eseguita in AWS e la directory dei contenuti del portale è memorizzata in Amazon S3, è necessario disporre di un bucket di backup per la directory dei contenuti. Creare un bucket di backup in S3 e impostare PORTAL_BACKUP_S3_BUCKET nel file delle proprietà sul nome del bucket e impostare PORTAL_BACKUP_S3_REGION sulla regione AWS in cui il bucket S3 è stato creato. Per informazioni su questo tipo di implementazione, consultare Configurare ArcGIS Enterprise a disponibilità elevata con i servizi di archiviazione AWS nella Guida di ArcGIS Enterprise on Amazon Web Services.
  Legacy:
  Nelle versioni precedenti di ArcGIS Enterprise 10.5.1, la proprietà PORTAL_BACKUP_S3_BUCKET era BACKUP_BUCKET_NAME.
- È possibile memorizzare la directory dei contenuti del portale in un contenitore di archiviazione Azure Blob. Per utilizzare il comando webgisdr per creare un backup di questa installazione, è necessario impostare le seguenti proprietà:
  - PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <account di archiviazione Azure>
    Impostare PORTAL_BACKUP_BLOB_ACCOUNT_NAME sul nome dell'account di archiviazione Azure Blob.
    Suggerimento:
    Questo nome dell'account di archiviazione è stato specificato quando si sceglie di utilizzare l'archivio cloud Azure per la configurazione e l'archivio contenuti nel pannello Opzioni di distribuzione di Cloud Builder.
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <chiave account>
    Impostare PORTAL_BACKUP_BLOB_ACCOUNT_KEY sulla chiave account associata all'account di archiviazione Azure Blob.
  - PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
    Impostare PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED su false la prima volta che si aggiunge il valore PORTAL_BACKUP_BLOB_ACCOUNT_KEY. Quando si salva il file webgisdr.properties, la chiave verrà crittografata e lo strumento imposterà PORTAL_BACKUP_BLOB_ACCOUNT_KEY su true.
  - PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT = <endpoint dell'account di archiviazione Blob>
    Specificare l'endpoint dell'account di archiviazione del servizio Blob.
  - PORTAL_BACKUP_BLOB_ENDPOINT_URL = <URL servizio Blob>
    Specificare l'URL dell'endpoint del servizio Blob. Il formato di questo URL è https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name>.
- Se si imposta BACKUP_STORE_PROVIDER su AmazonS3, fornire le informazioni per le seguenti proprietà:
  - S3_ACCESSKEY= <chiave di accesso per l'account AWS>
    Deve essere impostato solo se si imposta S3_CREDENTIAL_TYPE=accessKeys. L'utente IAM rappresentato da questa chiave di accesso deve avere accesso di lettura e scrittura al bucket S3 specificato con la proprietà S3_BUCKET.
  - S3_SECRETKEY= <chiave di accesso per l'account AWS>
    Chiave segreta associata alla chiave di accesso per l'account AWS. Impiegata solo se si imposta S3_CREDENTIAL_TYPE su accessKeys.
  - S3_ENCRYPTED = false
    Lasciare impostato su false. Se S3_CREDENTIAL_TYPE è stato impostato su accessKeys durante l'esecuzione del comando webgisdr, questa codificherà la chiave di accesso e la chiave segreta e imposterà S3_ENCRYPTED sul valore della chiave di accesso codificata.
  - S3_BUCKET= <nome del bucket S3>
    Nome del bucket Amazon S3 in cui si desidera archiviare il file di backup di ArcGIS Enterprise.
  - S3_CREDENTIAL_TYPE= <IAMRole | accessKeys
    Impostare S3_CREDENTIAL_TYPE su IAMRole se si deve accedere a S3_BUCKET con un ruolo AWS IAM. Impostarlo su accessKeys se si deve accedere a S3_BUCKET con un ruolo AWS IAM mediante una chiave di accesso. L'utente IAM deve avere accesso di lettura e scrittura al bucket S3 specificato con la proprietà S3_BUCKET.
  - S3_REGION= <regione AWS in cui è stato creato il bucket S3>
  - S3_BACKUP_NAME = <nome file di backup>
    Proprietà usata solo se si ripristina una distribuzione ArcGIS Enterprise. Indicare il nome del file di backup da ripristinare. Se non si specifica alcun nome del file di backup, sarà ripristinato l'ultimo file di backup.
In questo esempio, un backup completo del portale richiamabile all'URL https://portalhostname.domain.com:7443/arcgis, più i servizi, le impostazioni dei relativi server di hosting e federati e i dati dei feature layer hosted memorizzati in ArcGIS Data Store, verranno salvati in un file di backup su \\\\myserver\\tempbackups. I file separati saranno compressi in un solo file di backup (entbackup) e copiato su \\mybuserver\\wgbackups). Le cache dei layer del servizio 3D del Data Store cache tile ArcGIS Data Store non verrà inclusa perché INCLUDE_SCENE_TILE_CACHES è impostato su false.
```
BACKUP_STORE_PROVIDER = FileSystem
SHARED_LOCATION = \\\\myserver\\tempbackups
BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup
PORTAL_ADMIN_URL = https://portalhostname.domain.com:7443/arcgis
PORTAL_ADMIN_USERNAME = admin
PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
INCLUDE_SCENE_TILE_CACHES = false
BACKUP_RESTORE_MODE = full
```
In questo esempio, un backup completo del portale all'URL https://portalonaws.mydomain.com:7443/gis, oltre alla relativa directory contenuti (archiviata nel bucket S3 portalcontent), i servizi e le impostazioni dei relativi server di hosting e federati e i dati dei feature layer hosted memorizzati in data store cache tile e relazionali, saranno archiviati nel bucket S3 entbackups nella regione AWS eu-west-1. Il nome del file di backup è fullbackup06June. Per accedere all'account AWS viene impiegato un ruolo IAM.
```
BACKUP_STORE_PROVIDER = AmazonS3 PORTAL_ADMIN_URL = https://portalonaws.mydomain.com:7443/gis PORTAL_ADMIN_USERNAME = entadmin PORTAL_ADMIN_PASSWORD = p0rtl.a.p PORTAL_ADMIN_PASSWORD_ENCRYPTED = false INCLUDE_SCENE_TILE_CACHES = true BACKUP_RESTORE_MODE = full PORTAL_BACKUP_S3_BUCKET = portalcontent S3_BUCKET = entbackups S3_CREDENTIAL_TYPE = IAMRole S3_REGION = eu-west-1
S3_BACKUP_NAME = fullbackup06June
```
Salvare le proprietà del file.
Il valore di PORTAL_ADMIN_PASSWORD verrà crittografato nel file e PORTAL_ADMIN_PASSWORD_ENCRYPTED verrà impostato su true dopo aver eseguito il comando webgisdr con il file.
Aprire una finestra dei comandi, cambiare le directory in base alla posizione del comando webgisdr ed eseguire il comando con l'opzione di esportazione.
In questo esempio, il file delle proprietà (mywebgis.properties) è stato salvato nella directory /home/ags/arcgis/portal/propfiles creata dall'utente.
```
webgisdr --export --file /home/ags/arcgis/portal/propfiles/mywebgis.properties
```

Viene creato un file di backup nella posizione specificata per SHARED_LOCATION nel file delle proprietà. Il nome file è <timestamp>.webgissite.

Spostare il file di esportazione

Se il file di esportazione è stato creato in una posizione alla quale l'installazione in standby non può accedere, spostare il file di backup in una posizione accessibile allo strumento WebGISDR. Creare una copia del file delle proprietà da utilizzare in modo specifico per l'importazione, quindi aggiornare il valore della proprietà BACKUP_LOCATION nel nuovo file delle proprietà in base alla nuova posizione del file di esportazione. Se BACKUP_LOCATION è una directory, lo strumento estrarrà il backup più recente all'interno della directory su SHARED_LOCATION. Se BACKUP_LOCATION è impostato su un file di backup specifico, lo strumento estrarrà tale backup su SHARED_LOCATION.

Assicurarsi che i computer nell'installazione in standby possano accedere al percorso SHARED_LOCATION.

Accertarsi che l'account di dominio che esegue lo strumento webgisdr abbia almeno accesso in lettura a BACKUP_LOCATION e accesso in scrittura a SHARED_LOCATION. Accertarsi anche che l'account che ha installato ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store abbia accesso in lettura a SHARED_LOCATION.

Ai fini di questo esempio relativo al flusso di lavoro, la copia del file delle proprietà è denominata toimport.properties.

Installare i componenti per l'ambiente di standby

Prima di importare per la prima volta l'installazione ArcGIS Enterprise nell'ambiente di standby per la prima volta, è necessario installare e configurare tutti i componenti software (ArcGIS Server, Portal for ArcGIS, ArcGIS Web Adaptor e ArcGIS Data Store) sui computer di standby. L'URL utilizzato per accedere al portale (URL del bilanciatore o URL del Web Adaptor) e l'URL dei servizi ArcGIS Server per l'ambiente di standby devono essere gli stessi dell'installazione principale.

Ad esempio, se l'URL per accedere al portale primario è https://myportalslb.organization.com/portal e l'URL dei servizi per il portale primario GIS Server è https://myserverslb.organization.com/server, l'installazione in standby deve utilizzare gli stessi URL.

Non sono richieste licenze ArcGIS aggiuntive per l'installazione in standby poiché l'ambiente non è attivo, ma vengono richieste in caso di errore dell'installazione dell'ambiente primario.

Importare nell'installazione in standby

Una volta creato un'installazione vuota nell'ambiente standby, importare i propri contenuti dall'installazione primaria.

Se l'installazione primaria di ArcGIS Enterprise è in alta affidabilità, lo strumento webgisdr, quando si importano i propri contenuti nell'installazione in standby, consente di mantenere le impostazioni di alta affidabilità per il sito GIS Server, per i data store relazionali e per le cache tile ArcGIS Data Store. Per il portale, lo strumento webgisdr annulla la registrazione dell'ambiente di standby, ripristina il portale nell'ambiente primario e una volta importato nell'ambiente di standby, lo registra nuovamente.

Aprire una finestra dei comandi sul computer Portal for ArcGIS dell'installazione in standby, cambiare le directory alla posizione dello strumento webgisdr ed eseguire lo strumento attraverso le opzioni di esportazione.
In questo esempio, il file delle proprietà (toimport.properties) è stato salvato nella directory /home/ags/arcgis/portal/propfiles creata dall'utente.
```
webgisdr --export --file /home/ags/arcgis/portal/propfiles/toimport.properties
```
Osservare che il file delle proprietà non deve trovarsi nella stessa directory in cui è stato salvato quando è stato creato. Se lo si sposta, specificare il nuovo percorso della directory con il parametro --file.

Mantenere aggiornata l'installazione in standby

Per ridurre al minimo la perdita di dati, esportarli dall'installazione primaria e importarli in quella standby il più frequentemente possibile. La frequenza di esecuzione di questa operazione dipende dal tempo richiesto per esportare e importare l'installazione e dalla possibilità di creare uno script dei processi di esportazione e importazione senza alcun intervento dell'operatore (ad esempio, potrebbe essere necessario copiare fisicamente i file da una posizione ad un'altra).

Passare all'ambiente di standby quando si verifica un errore nell'ambiente primario

Come descritto in Disaster recovery e replication, il dipartimento IT può attivare l'installazione in standby in caso di errore nell'installazione primaria.

Qualche feedback su questo argomento?