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.

Usare la utility webgisdr con l'operazione di esportazione e file di proprietà per creare un backup di ArcGIS Enterprise. È possibile trovare la utility nella directory degli strumenti Portal for ArcGIS. Accertarsi di rispettare questi criteri quando si utilizza lo strumento:

  • La directory condivisa specificata deve essere abbastanza grande da contenere il file esportato. Per stimare le dimensioni finali del file, utilizzare l'utilità webgisdr con l'operazione di esportazione per creare un'esportazione di prova dell'installazione di ArcGIS Enterprise. Verificare le dimensioni del file, decidere il numero di file che si desidera mantenere nella directory condivisa, tenere in considerazione che l'installazione crescerà nel tempo e adattare le dimensioni della directory di conseguenza. Dal momento che è probabile che le dimensioni del file aumentino nel tempo, occorre continuare a monitorare le dimensioni di questi file di backup e adattare la dimensione di archiviazione in base alle esigenze.
  • 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).

Nota:

Se il contenuto del portale è memorizzato nel file system, la scansione antivirus in tempo reale può influire sulle prestazioni del backup. Prendere in considerazione la possibilità di escludere la directory dei contenuti del portale e le directory SHARED_LOCATION e BACKUP_LOCATION di backup dallo scanner antivirus.

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.

    • 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 = <backup | full | incremental>

      Indicare il tipo di backup che si desidera creare. Introdotto su 10.9, la modalità backup può essere usata quando è disponibile uno spazio limitato sul disco rigido del computer del portale o quando i backup non sono programmati regolarmente. Quando si usa questa modalità, il limite di dimensione predefinito viene applicato ai log delle transazioni interne, impedendo loro di riempire il disco rigido. Se vengono creati solo backup completi, è possibile impostare questa proprietà su backup. Se vengono creati sia backup completi che incrementali, è possibile creare due file proprietà separati: uno con BACKUP_RESTORE_MODE = full, da utilizzare occasionalmente per creare backup completi, e uno con BACKUP_RESTORE_MODE = incremental per generare backup incrementali fra i 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 webgisdr 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.

      Assicuratevi che qualsiasi backslash nel percorso sia evaso. Per esempio, C:\backups dovrebbe essere inserito come C:\\backups e \fileserver\backups dovrebbe essere inserito come \\\\fileserver\\backups.
    • 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.

      Per archiviare il backup di ArcGIS Enterprise in una directory condivisa in loco, specificare FileSystem e l'utility webgisdr archivierà i file di backup nella cartella di condivisione specificata per BACKUP_LOCATION.

      Per archiviare i backup ArcGIS Enterprise in una posizione di archiviazione bucket Amazon Simple Storage Service (S3) o un S3 compatibile, crearne uno specificamente per l'archiviazione dei file di backup generati dalla utility webgisdr e aggiornare le proprietà S3 con le informazioni necessarie per accedere al bucket.

      Per archiviare i backup di ArcGIS Enterprise in un'archiviazione Microsoft 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.

      Nota:

      Se la distribuzione ArcGIS Enterprise è in loco ma i backup sono memorizzati nel cloud, la creazione dei backup e il ripristino richiederanno più tempo rispetto a quello normalmente richiesto in caso di memorizzazione dei backup in una condivisione di file in loco.

    • BACKUP_LOCATION = <location of on-premises backup file>

      Designare il percorso per il file di backup webgissite.

      Assicuratevi che qualsiasi backslash nel percorso sia evaso. Per esempio, C:\backups dovrebbe essere inserito come C:\\backups e \\fileserver\backups dovrebbe essere inserito come \\\\fileserver\\backups.

      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.

      Nota:

      Durante un'esportazione, se sta richiedendo molte tempo per impacchettare il backup, considerare l'impostazione di BACKUP_LOCATION a un percorso locale. È possibile poi copiare il pacchetto finito alla sua posizione prevista. Assicurarsi che ci sia abbastanza spazio sul drive locale per archiviare il backup temporaneamente.

    • COMPRESSION_METHOD= <copy | fastest | fast | normal | maximum | ultra>

      Determinare il metodo di compressione per il backup webgissite. Il valore predefinito se non è popolato o commentato è copy. Nella maggior parte delle situazioni, questo può essere lasciato commentato. Un amministratore può scegliere di comprimere ulteriormente i backup a spese di un tempo maggiore per completare il backup.

    • Se si imposta BACKUP_STORE_PROVIDER su AmazonS3 fornire le informazioni per le seguenti proprietà.
      • S3_ACCESSKEY= <La chiave di accesso per l'account Amazon Web Services (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= <La chiave segreta dell'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 S3 bucket>

        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= <AWS regione in cui è stato creato il S3 bucket>
      • 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. Non deve essere lo stesso bucket in cui si trova il portale stesso; in caso contrario, si verificherà una duplicazione del contenuto ogni volta che si esegue un backup. Creare un bucket di backup S3, impostare PORTAL_BACKUP_S3_BUCKET nel file di proprietà al nome del bucket e impostare PORTAL_BACKUP_S3_REGION alla regione AWS nella quale è stato creato il bucket S3. Consultare Configura altamente disponibile ArcGIS Enterprise con servizi di archiviazione AWS nella guida ArcGIS Enterprise on Amazon Web Services per maggiori informazioni su questo tipo di implementazione.

      Nota:

      Se le macchine della tua distribuzione accedono a Amazon S3 usando un endpoint VPC, la copia interregionale non è consentita. Quando si implementa la ridondanza geografica, creare un bucket nella stessa regione dell'implementazione standby e assicurarsi che il bucket di backup del contenuto del portale esportato sia sincronizzato utilizzando la CLI di AWS (o un processo automatizzato) prima di eseguire l'operazione di importazione WebGISDR. Questo bucket replicato dovrebbe essere specificato nel file di ripristino webgisdr.properties come PORTAL_BACKUP_S3_BUCKET con la regione appropriata.

      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 = <Azure storage account>

        Specificare il nome dell'account di archiviazione Azure Blob.

        Suggerimento:

        Avete specificato il nome di account di archiviazione quando avete scelto l'opzione Utilizzare archiviazione cloud Azure per la configurazione e l'archiviazione del contenuto nel pannello Opzioni rilevamento 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 Azure contenitore archivio 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. Non deve essere lo stesso bucket in cui si trova il portale stesso; in caso contrario, si verificherà una duplicazione del contenuto ogni volta che si esegue un backup. 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 = <Azure storage account>
      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <account key>
      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false
      • PORTAL_BACKUP_BLOB_CONTAINER_NAME = <Nome del Azure contenitore archivio 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 = backup
    SHARED_LOCATION = \\\\myserver\\tempbackups
    INCLUDE_SCENE_TILE_CACHES = false
    
    BACKUP_STORE_PROVIDER = FileSystem
    BACKUP_LOCATION = \\\\mybuserver\\wgbackups\\entbackup

    In questo esempio, un backup 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 = backup
    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 = contentbackups
    PORTAL_BACKUP_S3_REGION =eu-west-1

    Questo esempio vale per l'archiviazione Microsoft Azure Blob. Un backup 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 Azure drbackups Blob.

    
    PORTAL_ADMIN_URL = https://portalonazure.domain.com:7443/arcgis
    PORTAL_ADMIN_USERNAME = entadmin
    PORTAL_ADMIN_PASSWORD = p0rtl.a.p
    
    BACKUP_RESTORE_MODE = backup
    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 = contentbackups

  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 per la webgisdrutility è 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
    Nota:

    Se durante l'esecuzione lo strumento sembra andare in stallo, verificare che il prompt dei comandi non sia in modalità QuickEdit. Consultare Problemi comuni e relative soluzioni per maggiori informazioni.

  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.