Skip To Content

Creare un backup di ArcGIS Enterprise

È possibile esportare i componenti dell'installazione ArcGIS Enterprise in un file di backup che può essere utilizzato in seguito per ripristinare l'ambiente in caso di guasto hardware o perdita dei dati. Il file include gli elementi e le impostazioni del portale, i layer Web ospitati, le impostazioni del server di hosting e del server federato, e, se si utilizza ArcGIS Data Store, i dati dei feature layer e le cache dei layer di mappa. La dimensione del file di backup e il tempo richiesto per la creazione varia in base al numero di elementi nel portale, il numero e il tipo di layer Web ospitati, il numero di server federati disponibili e il numero di computer ArcGIS Server presenti nel server di hosting e nel server federato. Quando si esegue il backup di un ambiente che non contiene né dati né servizi, la dimensione del file generato è di circa 400 MB. Il file sarà sempre più grande di questo valore.

Utilizzare lo strumento webgisdr con l'operazione di esportazione e un file delle proprietà per creare un backup di ArcGIS Enterprise. È possibile trovare lo strumento nella directory degli strumenti di 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'ambiente 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.
  • L'account che è stato utilizzato per installare ogni componente software in ArcGIS Enterprise deve disporre di privilegi di lettura e scrittura sulla directory condivisa.
  • Il backup di ciascun componente viene salvato in una directory provvisoria su ogni computer prima di essere spostato nella directory condivisa specificata; pertanto le seguenti directory devono avere dimensioni sufficienti per contenere il backup di ciascun componente:
    • Portal for ArcGIS: <Portal_content_directory>/temp
    • ArcGIS Server: /<ArcGIS_Server_installation_directory>/temp
    • ArcGIS Data Store: <ArcGIS_Data_Store_directory>/temp
  • Il ArcGIS Data Store Data Store relazionale nella propria installazione ArcGIS Enterprise deve avere il ripristino point-in-time abilitato.

Per creare un backup dell'ambiente ArcGIS Enterprise, attenersi alla procedura seguente:

  1. 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.

  2. 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}

      Nuova proprietà in 10.5.1. 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.

    • BACKUP_LOCATION = <percorso dei file di backup on-premises>

      Nuova proprietà in 10.5.1. Se si imposta BACKUP_STORE_PROVIDER = FileSystem, i file di backup sono inizialmente archiviati nella SHARED_LOCATION per poi essere copiati nella BACKUP_LOCATION Verificare che la destinazione 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.

    • 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 del servizio 3D ospitato 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 nel file delle proprietà non viene impostato BACKUP_RESTORE_MODE, per impostazione predefinita vengono creati backup di tipo full.

    • 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.

    • A partire dalla versione 10.5.1 ArcGIS Enterprise Cloud Builder for Microsoft Azure, è 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 distribuzione, è necessario impostare le seguenti proprietà (novità in 10.5.1):
      • 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à (novità in 10.5.1):
      • 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 ospitati 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 ospitati 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 SHARED_LOCATION = \\\\myserver\\tempbackups BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackupfile PORTAL_ADMIN_URL = https://portalhostname.mydomain.com:7443/arcgis 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

  3. 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.

  4. Aprire una finestra dei comandi nel computer Portal for ArcGIS, cambiare le directory in base alla posizione del webgisdr ed eseguire lo strumento con l'opzione di esportazione.

    Lo strumento webgisdr è installato in <Portal for ArcGIS installation directory>/tools/webgisdr.

    La sintassi di webgisdr è la seguente:

    webgisdr --{export | import} --file <location and name of properties file>

    Come spiegato in precedenza, il file delle proprietà (mywebgis.properties) era salvato nella directory /home/ags/arcgis/portal/propfiles creata dall'utente.

    webgisdr --export --file /home/ags/arcgis/portal/propfiles/mywebgis.properties

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

  5. Se l'ambiente ArcGIS Enterprise include map service o cache di layer Tile ospitati, creare manualmente una copia di backup di tutte le directory in cui le tile della cache sono memorizzate (ad esempio, l'intera directory arcgiscache in C:\arcgisserver\directories\ o <ArcGIS Server installation directory>/arcgis/server/usr/directories).

    Queste directory contengono le tile della cache dei servizi mappa e il file dello schema di tiling conf.xml. Le directory della cache possono anche contenere un file geodatabase, status.gdb, contenente informazioni relative alle tile create.

È possibile utilizzare questo file per ripristinare ArcGIS Enterprise.