Skip To Content

Creare un backup ArcGIS Enterprise

È possibile esportare i componenti dell'installazione ArcGIS Enterprise a un file di backup che può essere successivamente usato per ripristinare l'installazione nell'evento di fallimento di hardware o perdita di dati. Il file include gli elementi del portale e impostazioni, layer web hosted, federati e impostazioni server di hosting e, se si usa ArcGIS Data Store, i dati di layer feature hosted e cache di layer scene hosted. 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 hosted, 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'installazione 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 l'utilità webgisdr con l'operazione di esportazione e un file delle proprietà per creare un backup di ArcGIS Enterprise È possibile trovare la utility nella directory degli strumenti Portal for ArcGIS. Per utilizzare questo comando è 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 di quanto sarà grande il file, decidere quanti file si intende tenere nella directory condivisa e dimensionare la directory di conseguenza.
  • L'account o gli account di dominio che si usano per eseguire i servizi ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store devono disporre di accesso di scrittura per la directory condivisa che si specifica per i file di backup.
  • 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: C:\Users\<user>\AppData\Local\Temp
    • ArcGIS Data Store: <ArcGIS_Data_Store_directory>\temp
  • Il data store relazionale ArcGIS Data Store nell'installazione ArcGIS Enterprise deve avere il ripristino point-in-time abilitato se si intende creare backup incrementali (BACKUP_RESTORE_MODE = incremental).

Per creare un backup della distribuzione 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 template, webgisdr.properties, è installato in C:\Program Files\ArcGIS\Portal\tools\webgisdr per impostazione predefinita.

    In questo esempio, la copia del file è denominata mywebgis.properties ed è salvata in C:\propfiles.

  2. Aprire la copia del file delle proprietà e modificarla per includere le informazioni specifiche del proprio sito.

    • PORTAL_ADMIN_URL = <portal admin directory URL>

      Specificare l'URL della directory amministratore Portal for ArcGIS. Usare il formato https://portalhostname.domain.com:7443/arcgis, dove portalhostname.domain.com è il nome pienamente qualificato del computer dove Portal for ArcGIS è installato.

    • PORTAL_ADMIN_USERNAME = <portal administrator user name>

      Specificare il nome utente di un membro del portale assegnato al ruolo amministratore definito da Esri.

    • PORTAL_ADMIN_PASSWORD = = <portal administrator password>

      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.

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

    • SHARED_LOCATION = < percorso dei file di backup>

      Designare una posizione condivisa in cui creare una copia temporanea dei file di backup per ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store. L'account di dominio che esegue il servizio ArcGIS Server, Portal for ArcGIS e ArcGIS Data Store e l'account che sta eseguendo la utility deve possedere l'accesso di scrittura per questa posizione. Accertarsi che la directory sia abbastanza grande da contenere i file di backup per ciascun componente. Anche se i file sono compressi, possono essere abbastanza grande a seconda della quantità e del tipo di dati presenti. Se si dispone di cache e layer della scena ospitati e si imposta INCLUDE_SCENE_TILE_CACHES su true, il file di backup ArcGIS Data Store può essere particolarmente grande.

      Legacy:

      A Portal for ArcGIS 10.4, questa proprietà era SHARED_FOLDER.

    • 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_STORE_PROVIDER = {FileSystem | AmazonS3 | AzureBlob}

      Definire se si desidera salvare il file di backup webgissite nel sistema di file o nell'archivio cloud.

      Se si desidera archiviare il backup di ArcGIS Enterprise in una directory condivisa in loco, 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 = <location of on-premises backup file>

      Designare il percorso per il file di backup webgissite.

      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 accesso di scrittura alla BACKUP_LOCATION. L'account

      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.

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

      • S3_ENCRYPTED = false

        Lasciare impostato su false. Se S3_CREDENTIAL_TYPE è stato impostato su accessKey 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 | accessKey>

        Impostare S3_CREDENTIAL_TYPE su IAMRole se si deve accedere a S3_BUCKET con un ruolo AWS IAM. Impostarlo su accessKey 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 = <backup file name>

        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.

    • 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 nelle proprietà sul nome del bucket e impostare PORTAL_BACKUP_S3_REGION sulla regione AWS in cui il bucket S3 è stato creato. Consultare Configura altamente disponibile ArcGIS Enterprise con servizi di archiviazione nella guida ArcGIS Enterprise on Amazon Web Services per maggiori informazioni su questo tipo di implementazione.

      Legacy:

      Nelle versioni precedenti a ArcGIS Enterprise 10.5.1, la proprietà PORTAL_BACKUP_S3_BUCKET è stata BACKUP_BUCKET_NAME.

    • Se si imposta BACKUP_STORE_PROVIDER su AzureBlob fornire le informazioni per le seguenti proprietà.
      • AZURE_BLOB_ACCOUNT_NAME = <account di archiviazione Azure>

        Specificare il 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.

      • AZURE_BLOB_ACCOUNT_KEY = <account key>

        Specificare la chiave account associata all'account di archiviazione Azure Blob.

      • AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED = false

        Specificare false quando si aggiungono i valori ACCOUNT_KEY al file per la prima volta. Quando si salva il file webgisdr.properties, la chiave verrà crittografata e lo strumento imposterà queste proprietà su true.

      • AZURE_BLOB_CONTAINER_NAME = <Nome del contenitore di archiviazione Azure Blob>

        Specificare il nome del contenitore Blob.

      • AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <Endpoint account archiviazione Blob>

        Specificare l'endpoint dell'account di archiviazione del servizio Blob.

      • (Opzionale) AZURE_BLOB_ENDPOINT_URL = <URL servizio Blob>

        Specificare l'URL dell'endpoint del servizio Blob se si sta utilizzando un endpoint di archiviazione Blob personalizzato. Se non si sta utilizzando un endpoint personalizzato, non rimuovere il carattere di commento a questa linea. L'URL predefinito è nel formato https://<BLOB_ACCOUNT_NAME>.blob.core.windows.net.

    • È anche possibile memorizzare la directory dei contenuti del portale in un contenitore di archiviazione Azure Blob. In tal caso, è necessario un bucket di backup per la directory dei contenuti in Azure. L'insieme di proprietà che inizia con PORTAL_BACKUP_BLOB definisce l'account usato per la directory dei contenuti del portale. I valori di queste proprietà devono corrispondere a quelli impostati nella sezione AZURE_BLOB di cui sopra; le definizioni per quella sezione si applicano anche qui.
      • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <account di archiviazione Azure>
      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <account key>
      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
      • PORTAL_BACKUP_BLOB_CONTAINER_NAME = <Nome del contenitore di archiviazione Azure Blob>
      • PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <Endpoint account di archiviazione Blob>
      • (Opzionale) PORTAL_BACKUP_BLOB_ENDPOINT_URL = <URL di servizio personalizzato Blob>
    • IS_PORTAL_PKI_AUTHENTICATED = <vero | falso>

      Se si è configurata un'infrastruttura a chiave pubblica (PKI) per proteggere l'accesso al portale, impostare questo valore su true.

      Ulteriori informazioni sulle opzioni di autenticazione nel portale

      Se si imposta su true, fornire i valori per le seguenti proprietà aggiuntive:

      • PORTAL_CLIENT_CERTIFICATE_FILE_PATH = <percorso file certificato completo>

        Specificare il percorso file completo del certificato PKI del portale in formato PKCS12.

      • PORTAL_CLIENT_CERTIFICATE_PASSWORD = <password per certificato>

        Specificare la password corrispondente per il certificato PKI.

      • PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED = falso

        Quando si inserisce per la prima volta il valore per la password del certificato, lasciare questo valore come false. Quando si esegue lo strumento per la prima volta dopo aver salvato questo valore, lo strumento codificherà la password e cambiare questa proprietà su true.

    In questo esempio, un backup del portale all'URL https://portalhostname.domain.com:7443/arcgis, più i servizi e le impostazioni dei server di hosting e federati e i dati layer feature hosted archiviati nei dati relazionali ArcGIS Data Store verranno inizialmente salvati in file in \\\\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.

    PORTAL_ADMIN_URL = https://portalhostname.domain.com:7443/arcgis
    PORTAL_ADMIN_USERNAME = admin
    PORTAL_ADMIN_PASSWORD = Th3.Ad.Pass
    PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
    
    BACKUP_RESTORE_MODE = full
    SHARED_LOCATION = \\\\myserver\\tempbackups
    INCLUDE_SCENE_TILE_CACHES = false
    
    BACKUP_STORE_PROVIDER = FileSystem
    BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup

    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.

    PORTAL_ADMIN_URL = https://portalonaws.mydomain.com:7443/arcgis
    PORTAL_ADMIN_USERNAME = entadmin
    PORTAL_ADMIN_PASSWORD = p0rtl.a.p
    PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
    
    BACKUP_RESTORE_MODE = full
    SHARED_LOCATION = \\fileserver\backups
    INCLUDE_SCENE_TILE_CACHES = true
    BACKUP_STORE_PROVIDER = AmazonS3
    
    S3_BUCKET = entbackups
    S3_CREDENTIAL_TYPE = IAMRole
    S3_REGION = eu-west-1
    S3_BACKUP_NAME = fullbackup06June
    
    PORTAL_BACKUP_S3_BUCKET = portalcontent
    PORTAL_BACKUP_S3_REGION =eu-west-1

    Questo esempio vale per l'archiviazione Azure Blob di Microsoft. Un backup completo del portale all'URL https://portalonazure.domain.com:7443/arcgis, la relativa directory contenuti, i servizi e le impostazioni dei relativi server di hosting e federati e i dati memorizzati nei data store relazionali e cache tile verranno salvati in drbackups Azure Blob.

    PORTAL_ADMIN_URL = https://portalonazure.domain.com:7443/arcgis
    PORTAL_ADMIN_USERNAME = entadmin
    PORTAL_ADMIN_PASSWORD = p0rtl.a.p
    
    SHARED_LOCATION = \\fileserver\backups
    BACKUP_STORE_PROVIDER = AzureBlob
    
    AZURE_BLOB_ACCOUNT_NAME = entbackups
    AZURE_BLOB_ACCOUNT_KEY = <key>
    AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED =false
    AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = core.windows.net
    AZURE_BLOB_CONTAINER_NAME = drbackups
    
    PORTAL_BACKUP_BLOB_ACCOUNT_NAME = entbackups
    PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <key>
    PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
    PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = core.windows.net
    PORTAL_BACKUP_BLOB_CONTAINER_NAME = portalcontent

  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 di comando sul computer Portal for ArcGIS, cambiare la directory nella posizione dell'utilità webgisdr ed eseguire l'utilità con l'opzione di esportazione.

    La posizione predefinita dell'utilità webgisdr è C:\Program Files\ArcGIS\Portal\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 cartella C:\propfiles creata dall'utente.

    webgisdr --export --file C:\propfiles\mywebgis.properties
  5. Se l'installazione ArcGIS Enterprise include cache di servizio mappa o tile hosted, creare manualmente una copia di backup di tutte le directory dove i tile di cache sono archiviate (per esempio, l'intera directory arcgiscache sotto 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 il ArcGIS Enterprise.