Skip To Content

File delle proprietà dello strumento WebGISDR

Per creare un backup di ArcGIS Enterprise tramite lo strumento Web GIS Disaster Recovery (WebGISDR), aprire una copia del file delle proprietà e modificarlo in modo da includere informazioni specifiche del sito. Per ulteriori informazioni, consultare Creare un backup di ArcGIS Enterprise.

Proprietà del portale

Specificare le informazioni per le seguenti proprietà del portale nella copia del file delle proprietà dello strumento WebGISDR:

ProprietàDescrizione

PORTAL_ADMIN_URL = <URL amministrativo portale>

Specificare l'URL del portale. 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 = <nome utente amministratore portale>

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.

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 questa proprietà viene impostato su true per indicare che la password è stata crittografata. Per cambiare la password in futuro, impostare questa proprietà su false, specificare la nuova password del'amministratore e salvare il file.

Proprietà di backup

Specifica le informazioni per le seguenti proprietà di backup, quindi rivedi le proprietà aggiuntive necessarie per il provider dell'archivio di backup:

ProprietàDescrizione
BACKUP_RESTORE_MODE = <backup|full|incremental>

Indicare il tipo di backup che si desidera creare. La modalità predefinita è backup. Per ulteriori informazioni, vedere Modalità di backup. Per pianificare backup completi e incrementali, è necessario creare file di proprietà separati per ciascuna modalità di backup.

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 del dominio che esegue i servizi per questi componenti e l'account che esegue lo strumento WebGISDR devono avere accesso in scrittura a 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 s'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. Ad 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 si pubblicano layer scena ospitati nel portale e si desidera includere i dati di cache di scena nel backup, impostare la proprietà 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 di scena è stata creata dopo l'ultimo backup oppure se non si pubblicano scene nel portale, è possibile impostare questa proprietà su false.

BACKUP_STORE_PROVIDER = <Filesystem|AmazonS3|AzureBlob>

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

Per memorizzare il backup di ArcGIS Enterprise in una posizione di condivisione file locale, specificare FileSystem e lo strumento WebGISDR memorizzerà i file di backup nella condivisione file specificata per BACKUP_LOCATION.

Per memorizzare i backup di ArcGIS Enterprise in una posizione di archiviazione bucket compatibile con Amazon S3 oS3, crearne una specificamente per memorizzare i file di backup generati dallo strumento WebGISDR e aggiornare le proprietà S3 con le informazioni necessarie per accedere al proprio bucket.

Per memorizzare i backup di ArcGIS Enterprise in Archiviazione BLOB di Microsoft Azure, creare un contenitore di Archiviazione BLOB di Azure specificamente per la memorizzazione dei file di backup generati dallo strumento WebGISDR e aggiornare le proprietà Azure con le informazioni necessarie per accedere al contenitore.

Archiviazione file system

Se si imposta Filesystem come provider di archivio di backup, specificare le informazioni per le seguenti proprietà:

ProprietàDescrizione

BACKUP_LOCATION = <location of on-premises backup file>

Se si imposta set FileSystem come provider di archivio di backup, designare la posizione per il file di backup di webgissite.

Assicuratevi che qualsiasi backslash nel percorso sia evaso. Ad 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 nella posizione condivisa ma vengono copiati nella posizione di backup. 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 disporre di accesso in scrittura per la posizione di backup.

Se si imposta BACKUP_LOCATION su una cartella, lo strumento WebGISDR importa l'ultimo file di backup disponibile in tale cartella. Se si imposta set BACKUP_LOCATION su uno specifico file di backup nella cartella, tale file viene importato dallo strumento WebGISDR.

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 nell'unità locale sia presente spazio sufficiente 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 impostato come di commento, è copy. Nella maggior parte dei casi, può essere lasciato come commento.

Un amministratore può scegliere di comprimere i backup a spese di un tempo maggiore per completare il backup.

Archiviazione Amazon S3

Se si imposta Amazon S3 come provider di archivio di backup, specificare le seguenti informazioni:

ProprietàDescrizione

S3_ACCESSKEY = <chiave di accesso per l'account Amazon Web Services (AWS)>

Se accedi al bucket S3 utilizzando una chiave di accesso, imposta questa proprietà sulla chiave di accesso per l'account AWS. 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 = <chave segreta dell'account AWS>

Se accedi al bucket S3 utilizzando una chiave di accesso, imposta questa proprietà sulla chiave segreta associata alla chiave di accesso per il tuo account AWS.

S3_ENCRYPTED = false

Lasciare impostato su false. Se hai impostato S3_CREDENTIALTYPE su accessKey quando hai eseguito lo strumento WebGISDR, lo strumento crittograferà la chiave di accesso e la chiave segreta e imposterà S3_ENCRYPTED su true.

S3_BUCKET = <nome del S3 bucket>

Nome del bucket Amazon S3 in cui si desidera archiviare il file di backup di ArcGIS Enterprise.

S3_CREDENTIALTYPE = <IAMRole|accessKey>

Imposta questa proprietà su IAMRole se intendi accedere al bucket S3 tramite un ruolo IAM AWS. Impostala su accessKey se accederai al bucket S3 tramite utente AWS IAM con una chiave di accesso. Il ruolo o l'utente IAM deve avere accesso di lettura e scrittura al bucket S3specificato con la proprietà S3_BUCKET.

S3_REGION = <regioneAWS in cui è stato creato il bucket S3>

Specificare la regione AWS in cui è stato creato il bucket S3.

S3_BACKUP_NAME = <backup file name>

Questa proprietà viene utilizzata solo quando si ripristina un'organizzazione 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.

Archiviazione BLOB di Azure

Se si imposta AzureBlob come provider di archivio di backup, specificare le seguenti informazioni:

ProprietàDescrizione

AZURE_BLOB_ACCOUNT_NAME = <Azure storage account>

Specificare il nome dell'Azure account di archiviazione 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_CONTAINER_NAME = <nome del contenitore di archivio BLOB di Azure>

Specificare il nome del contenitore BLOB.

AZURE_BLOB_CREDENTIALTYPE = <accessKey|servicePrincipal|userAssignedIdentity|sasToken>

Imposta il tipo di credenziali Blob di Azure su uno dei seguenti valori:

  • accessKey - Accesso al contenitore utilizzando la chiave di accesso dell'account di archiviazione.
  • servicePrincipal - Accesso al contenitore utilizzando un entità servizio Azure AD.
  • userAssignedIdentity - Accesso al contenitore utilizzando un'identità assegnata dall'utente Azure.
  • sasToken - Accesso al contenitore utilizzando una firma di accesso condivisa. Questi token generalmente scadono con cadenza regolare, per cui sono sconsigliati per backup e ripristino automatizzati.

La chiave, il token o l'identità specificata deve disporre dell'accesso in lettura, scrittura e filtro alla risorsa del contenitore Blob Azure specificata con la proprietà AZURE_BLOB_CONTAINER_NAME.

AZURE_BLOB_ACCOUNT_KEY = <account key>

Se AZURE_BLOB_CREDENTIALTYPE è impostato su accessKey, imposta questa proprietà sulla chiave dell'account associata al tuo account di archiviazione Blob Azure.

AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED = false

Lasciare impostato su false. Se AZURE_BLOB_CREDENTIALTYPE è impostato su accessKey quando esegui lo strumento WebGISDR, lo strumento eseguirà la crittografia della chiave di accesso e imposterà AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED su true.

AZURE_BLOB_SP_TENANT_ID

= <ID tenant Azure>

Se AZURE_BLOB_CREDENTIAL_TYPE è impostato su servicePrincipal, imposta questa proprietà sull'ID tenant Azure associato all'entità servizio.

AZURE_BLOB_SP_CLIENT_ID

= <ID client principale servizio Azure>

Se AZURE_BLOB_CREDENTIAL_TYPE è impostato su servicePrincipal, imposta questa proprietà sull'ID client entità servizio Azure.

AZURE_BLOB_SP_CLIENT_SECRET_KEY

= <Chiave segreta principale servizio Azure>

Se AZURE_BLOB_CREDENTIAL_TYPE è impostato su servicePrincipal, imposta questa proprietà sulla chiave segreta del principale del servizio Azure.

AZURE_BLOB_SP_CLIENT_SECRET_KEY_ENCRYPTED = false

Lasciare impostato su false. Se AZURE_BLOB_CREDENTIAL_TYPE è stato impostato servicePrincipal quando p stato eseguito lo strumento WebGISDR, lo strumento crittograferà la chiave di accesso e imposterà AZURE_BLOB_SP_CLIENT_SECRET_KEY_ENCRYPTED sul valore della chiave di accesso crittografata.

AZURE_BLOB_USER_MI_CLIENT_ID

= <ID client identità gestita assegnato dall'utente>

Se AZURE_BLOB_CREDENTIAL_TYPE è impostato su userAssignedIdentity, imposta questa proprietà sull'ID client identità gestita assegnato dall'utente.

AZURE_BLOB_SAS_TOKEN

= <token forma accesso condiviso>

Se AZURE_BLOB_CREDENTIAL_TYPE è impostato su sasToken, imposta questa proprietà sul token della firma di accesso condiviso generato da Azure. Siccome i token SAS generalmente durano poco, questa opzione potrebbe non essere preferibile per flussi di lavoro di backup e ripristino automatizzati.

AZURE_BLOB_SAS_TOKEN_ENCRYPTED = false

Lasciare impostato su false. Se AZURE_BLOB_CREDENTIALTYPE è impostato su sasToken quando esegui lo strumento WebGISDR, lo strumento eseguirà la crittografia del token SAS e imposterà AZURE_BLOB_SAS_TOKEN_ENCRYPTED su true.

AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <Endpoint account archiviazione Blob>

Specifica l'endpoint dell'account di archiviazione.

(Facoltativo) AZURE_BLOB_ENDPOINT_URL = <URL servizio BLOB>

Specifica l'URL dell'endpoint del servizio Blob se utilizzi 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.

AZURE_BLOB_BACKUP_NAME = <backup file name>

Questa proprietà viene utilizzata solo quando si ripristina un'organizzazione 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.

AZURE_BLOB_SP_AUTHORITY_HOST = <identity host>

Se AZURE_BLOB_CREDENTIAL_TYPE sono impostati su servicePrincipal e operano in un tenant che non utilizza login.microsoftonline.com (predefinito), definire l'authority host utilizzato per autenticare l'entità principale di servizio. Ad esempio, login.microsoftonline.us.

PORTAL_BACKUP_BLOB_SP_AUTHORITY_HOST = <identity host>

Se AZURE_BLOB_CREDENTIAL_TYPE sono impostati su servicePrincipal e operano in un tenant che non utilizza login.microsoftonline.com (predefinito), definire l'authority host utilizzato per autenticare l'entità principale di servizio. Ad esempio, login.microsoftonline.us.

Proprietà PKI

Se hai configurato un'autenticazione del certificato client basata su un'infrastruttura a chiave pubblica (PKI) per accedere al tuo portale, fornisci informazioni per le seguenti proprietà:

ProprietàDescrizione
IS_PORTAL_PKI_AUTHENTICATED = <true|false>

Se è stata configurata una PKI per proteggere l'accesso al portale, impostare questo valore su true. Ulteriori informazioni sulle opzioni di autenticazione del portale.

PORTAL_CLIENT_CERTIFICATE_FILE_PATH

= <percorso completo del file di certificato>

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

PORTAL_CLIENT_CERTIFICATE_PASSWORD

= <password per il certificato>

Specificare la password corrispondente per il certificato PKI.

PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED = false

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.

Contenuto del portale nelle proprietà del cloud

Se memorizzi la directory del contenuto del portale in un bucket Amazon S3 o in un contenitore Blob Azure, devi creare un bucket o un contenitore di backup per la directory del contenuto. 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.

Archiviazione Amazon S3

Se l'organizzazione ArcGIS Enterprise viene eseguita su AWS e il contenuto del portale viene memorizzato Amazon S3, specificare le informazioni per le seguenti proprietà:

Nota:

Se i computer dell'organizzazione accedono Amazon S3 utilizzando un endpoint VPC, la copia interregionale non è consentita. Quando si implementa la ridondanza geografica, creare un bucket nella stessa regione dello standby e accertarsi che il bucket del contenuto esportato sia sincronizzato tramite AWS CLI (o un processo automatico) prima di eseguire l'operazione di importazione WebGISDR. Questo bucket duplicato deve essere specificato nel file di ripristino di webgisdr.properties come PORTAL_BACKUP_S3_BUCKET con la regione appropriata.

ProprietàDescrizione

PORTAL_BACKUP_S3_BUCKET = <nome del bucket>

Specificare il nome del bucket S3 in cui si desidera memorizzare la directory del contenuto del portale.

PORTAL_BACKUP_S3_REGION = <AWS regione in cui è stato creato il bucket >

Specificare la regione AWS in cui è stato creato il bucket.

Per ulteriori informazioni su questo tipo di implementazione, vedi Configurare un portale ad alta disponibilità con Amazon S3.

Archiviazione BLOB di Azure

Se si intende memorizzare la directory del contenuto del portale in un contenitore di archiviazione BLOB di Azure, specificare le informazioni per le seguenti proprietà:

Nota:

I valori per queste proprietà devono corrispondere a quelli impostati nella sezione delle proprietà di archiviazione BLOB di Azure precedente. Saranno visualizzate anche le definizioni per quella sessione.

ProprietàDescrizione

PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <account di archiviazione Azure>

Specificare il nome dell'account di archiviazione BLOB di Azure.

PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <chiave account>

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

PORTAL_BACKUP_ACCOUNT_KEY_ENCRYPTED = false

Specificare false quando ai aggiungono inizialmente i valori chiave account al file.

PORTAL_BACKUP_BLOB_CONTAINER_NAME = <nome del contenitore di archiviazione BLOB di Azure>

Specificare il nome del contenitore BLOB.

PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX = <endpoint account di archiviazione BLOB>

Specificare l'endpoint dell'account di archiviazione.

(facoltativo) PORTAL_BACKUP_BLOB_ENDPOINT_URL = <URL del servizio di archiviazione BLOB>

Se utilizzi un endpoint di archiviazione Blob personalizzato, specifica l'URL dell'endpoint del servizio Blob. 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.

Esempi

I seguenti file delle proprietà di esempio contengono scenari per ogni opzione del provider di backup.

  • 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