Skip To Content

Configure disaster recovery for ArcGIS Enterprise

You can replicate your ArcGIS Enterprise deployment to a disconnected standby deployment. The standby deployment can be brought online and made your active deployment if your primary deployment fails.

Because the standby deployment is not actively connected to your primary deployment, you can set up the standby deployment in another building or city to guard against downtime due to such occurrences as localized natural disasters or power outages. Keep in mind, though, that the standby deployment must be accessible from your clients.

Export the components of your primary ArcGIS Enterprise deployment to a compressed file using the webgisdr tool, and use the compressed file to set up and maintain the standby deployment.

Before you configure disaster recovery, be sure you read Disaster recovery and replication.

Export ArcGIS Enterprise

Use the webgisdr utility with the export operation and a properties file to export your primary ArcGIS Enterprise deployment. The exported file includes your portal, hosting server, relational and tile cache data stores, and federated servers. The file size and time it takes to create it vary depending on how many items are in your portal, the number and type of hosted web layers you have, how many federated servers you have, and how many ArcGIS Server machines are in your hosting and federated servers.

You can find the webgisdr utility in the Portal for ArcGIS tools directory. The following criteria must be met to use this utility:

  • The shared directory you specify must be large enough to contain the exported file. Do a test export of your ArcGIS Enterprise deployment to get an idea how large the file will be, decide how many files you intend to keep in the shared directory, and size the directory accordingly.
  • The name, user ID, and group ID of the account that was used to install each software component in ArcGIS Enterprise on both the primary and standby deployments, and the account used to run the webgisdr tool must be the same and must have read and write privileges on the shared directory.

Follow these steps to export your primary ArcGIS Enterprise deployment:

  1. Utwórz kopię pliku właściwości szablonu. Kopię można utworzyć w tym samym katalogu, w którym znajduje się szablon, lub w nowym katalogu.

    Plik właściwości szablonu — webgisdr.properties — jest domyślnie instalowany w katalogu /arcgis/portal/tools/webgisdr.

    W tym przykładzie kopia tego pliku ma nazwę mywebgis.properties i jest zapisana w katalogu /home/ags/arcgis/portal/propfiles.

  2. Otwórz kopię pliku właściwości do edycji i wprowadź w nim informacje właściwe dla Twojej witryny.

    • SHARED_LOCATION = <lokalizacja plików kopii zapasowej>

      Wyznacz udostępnianą lokalizację, w której ma zostać utworzona tymczasowa kopia plików kopii zapasowej dla oprogramowania ArcGIS Server, Portal for ArcGIS i ArcGIS Data Store. Konto domenowe, którego użyto do zainstalowania oprogramowania ArcGIS Server, Portal for ArcGIS i ArcGIS Data Store, a także konto służące do uruchamiania narzędzia webgisdr muszą mieć uprawnienia do odczytu i zapisu w tej lokalizacji. Pamiętaj, aby ta lokalizacja była wystarczająco duża, aby pomieścić plik kopii zapasowej. Chociaż plik jest skompresowany, może być bardzo duży, w zależności od ilości i typu istniejących danych. Jeśli istnieją hostowane warstwy scen i pamięci podręczne, a dla właściwości INCLUDE_SCENE_TILE_CACHES ustawiono wartość true, plik kopii zapasowej magazynu danych ArcGIS Data Store może być szczególnie duży.

      Wcześniejsze:

      W oprogramowaniu Portal for ArcGIS 10.4 była to właściwość SHARED_FOLDER.

    • BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3 | Azure}

      Jeśli kopia zapasowa oprogramowania ArcGIS Enterprise ma zostać zapisana lokalnie w lokalizacji udostępnionego pliku, podaj wartość FileSystem, a narzędzie webgisdr zapisze pliki kopii zapasowej w udostępnionym pliku podanym we właściwości BACKUP_LOCATION.

      Jeśli kopie zapasowe oprogramowania ArcGIS Enterprise mają być przechowywane w zasobniku Amazon Simple Storage Service (S3), utwórz zasobnik S3 służący właśnie do przechowywania plików kopii zapasowych generowanych przez narzędzie webgisdr, a następnie zaktualizuj właściwości S3 z użyciem informacji wymaganych do uzyskania dostępu do zasobnika.

      Jeśli kopie zapasowe oprogramowania ArcGIS Enterprise mają być przechowywane w magazynie obiektów blob platformy Azure, utwórz kontener magazynu obiektów blob platformy Azure służący właśnie do przechowywania plików kopii zapasowych generowanych przez narzędzie webgisdr, a następnie zaktualizuj właściwości Azure z użyciem informacji wymaganych do uzyskania dostępu do kontenera.

    • BACKUP_LOCATION = <lokalizacja lokalnego pliku kopii zapasowej>

      Pliki kopii zapasowej są początkowo zapisywane w lokalizacji SHARED_LOCATION, ale następnie są kopiowane do lokalizacji BACKUP_LOCATION. Pamiętaj, aby ta lokalizacja była wystarczająco duża, aby pomieścić plik kopii zapasowej. Chociaż plik jest skompresowany, może być bardzo duży, w zależności od ilości i typu istniejących danych. Konto służące do uruchamiania narzędzia webgisdr musi mieć uprawnienia do odczytu i zapisu do lokalizacji BACKUP_LOCATION.

      Jeśli dla właściwości BACKUP_LOCATION zostanie ustawiony folder, narzędzie do odzyskiwania po awarii importuje najnowszy plik kopii zapasowej dostępny w tym folderze. Jeśli dla właściwości BACKUP_LOCATION ustawiono konkretny plik kopii zapasowej w folderze, narzędzie do odzyskiwania po awarii importuje ten plik.

    • PORTAL_ADMIN_URL = <adres URL katalogu administratora portalu>

      Podaj adres URL katalogu administratora portalu Portal for ArcGIS. Użyj formatu https://portalhostname.domain.com:7443/arcgis, gdzie portalhostname.domain.com oznacza pełną nazwę komputera, na którym zainstalowano oprogramowanie Portal for ArcGIS.

    • PORTAL_ADMIN_USERNAME = <nazwa użytkownika administratora portalu>

      Podaj nazwę użytkownika członka portalu przypisanego do roli administratora zdefiniowanej przez Esri.

    • PORTAL_ADMIN_PASSWORD = <hasło administratora portalu>

      Podaj hasło konta administratora portalu.

    • PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>

      Dla tej opcji ustaw wartość false, gdy po raz pierwszy podajesz hasło administratora w pliku. Po zapisaniu pliku hasło zostanie zaszyfrowane, a wartość opcji PORTAL_ADMIN_PASSWORD_ENCRYPTED zostanie ustawiona na true, aby wskazać, że hasło zostało zaszyfrowane. Jeśli w przyszłości zechcesz zmienić hasło, wprowadź ustawienie PORTAL_ADMIN_PASSWORD_ENCRYPTED = false, podaj nowe hasło administratora i zapisz plik.

    • INCLUDE_SCENE_TILE_CACHES = <true | false>

      Jeśli w portalu publikujesz hostowane warstwy scen i chcesz uwzględnić dane pamięci podręcznej scen w kopii zapasowej, dla opcji INCLUDE_SCENE_TILE_CACHES ustaw wartość true. Pamiętaj, że w przypadku ustawienia wartości true w kopii zapasowej zostaną uwzględnione wszystkie dane pamięci podręcznej scen, a nie tylko nowe dane pamięci podręcznej utworzone od czasu ostatniej kopii zapasowej. Jeśli wiesz, że od czasu ostatniej kopii zapasowej nie utworzono żadnych nowych pamięci podręcznych scen, lub nie chcesz publikować scen w portalu, dla opcji INCLUDE_SCENE_TILE_CACHES możesz ustawić wartość false.

    • BACKUP_RESTORE_MODE = <full | incremental>

      Jeśli tworzysz tylko pełne kopie zapasowe, dla tej właściwości możesz ustawić wartość full. Aby jednak zmniejszyć rozmiar kopii zapasowych, możesz utworzyć dwa różne pliki właściwości: jeden z ustawieniem BACKUP_RESTORE_MODE = full, którego będziesz okazjonalnie używać do tworzenia pełnych kopii zapasowych i drugi z ustawieniem BACKUP_RESTORE_MODE = incremental służący do generowania przyrostowych kopii zapasowych między pełnymi kopiami zapasowymi. Każda przyrostowa kopia zapasowa zawiera wszystkie zmiany wprowadzone od czasu ostatniej pełnej kopii zapasowej.

    • Jeśli wdrożone oprogramowanie ArcGIS Enterprise działa u usłudze AWS, a katalog zasobów portalu jest przechowywany w zasobniku Amazon S3, potrzebny jest zasobnik kopii zapasowej dla katalogu zasobów. Utwórz zasobnik S3 kopii zapasowej i ustaw właściwość PORTAL_BACKUP_S3_BUCKET w pliku właściwości na nazwę zasobnika i ustaw właściwość PORTAL_BACKUP_S3_REGION na region usługi AWS, w którym został utworzony zasobnik S3. Więcej informacji na temat tego typu implementacji zawiera sekcja Konfigurowanie oprogramowania ArcGIS Enterprise o wysokiej dostępności z usługami przechowywania AWS w pomocy do oprogramowania ArcGIS Enterprise on Amazon Web Services.

      Wcześniejsze:

      W oprogramowaniu ArcGIS Enterprise w wersji sprzed 10.5.1 właściwości PORTAL_BACKUP_S3_BUCKET odpowiadała właściwość BACKUP_BUCKET_NAME.

    • Katalog zasobów portalu można zapisać w kontenerze magazynu obiektów blob platformy Azure. Aby użyć narzędzia webgisdr do utworzenia kopii zapasowej tego wdrożenia, musisz ustawić następujące właściwości:
      • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <konto magazynu Azure>

        Ustaw właściwość PORTAL_BACKUP_BLOB_ACCOUNT_NAME na nazwę konta magazynu obiektów platformy Azure.

        Wskazówka:

        Tę nazwę konta magazynu podano wtedy, gdy wybrano opcję Użyj magazynu w chmurze na platformie Azure jako magazynu konfiguracji i zasobów na panelu Opcje wdrożenia oprogramowania Cloud Builder.

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <klucz konta>

        Ustaw właściwość PORTAL_BACKUP_BLOB_ACCOUNT_KEY na klucz konta powiązany z kontem magazynu obiektów blob platformy Azure.

      • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false

        Ustaw właściwość PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED na wartość false, gdy wartość właściwości PORTAL_BACKUP_BLOB_ACCOUNT_KEY jest dodawana po raz pierwszy. Po zapisaniu pliku webgisdr.properties ten klucz zostanie zaszyfrowany, a narzędzie ustawi właściwość PORTAL_BACKUP_BLOB_ACCOUNT_KEY na wartość true.

      • PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT = <punkt końcowy konta magazynu obiektów blob>

        Podaj punkt końcowy konta magazynu usługi Blob.

      • PORTAL_BACKUP_BLOB_ENDPOINT_URL = <adres URL usługi Blob>

        Podaj adres URL punktu końcowego usługi Blob. Ten adres URL ma format https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name>.

    • Jeśli właściwość BACKUP_STORE_PROVIDER zostanie ustawiona na AmazonS3, podaj informacje w następujących właściwościach:
      • S3_ACCESSKEY= <klucz dostępu do konta usługi AWS>

        Tę właściwość należy ustawić, jeśli wprowadzono ustawienie S3_CREDENTIAL_TYPE=accessKeys. Użytkownik IAM reprezentowany przez ten klucz dostępu musi mieć uprawnienia do odczytu i zapisu do zasobnika S3 podanego za pomocą właściwości S3_BUCKET.

      • S3_SECRETKEY= <tajny klucz dla konta usługi AWS>

        Podaj tajny klucz powiązany z kluczem dostępu dla konta usługi AWS. Jest on używany tylko wtedy, gdy dla właściwości S3_CREDENTIAL_TYPE ustawiono wartość accessKeys.

      • S3_ENCRYPTED = false

        Pozostaw ustawioną wartość false. Jeśli dla właściwości S3_CREDENTIAL_TYPE jest ustawiona wartość accessKeys, gdy uruchamiane jest narzędzie webgisdr, narzędzie to zaszyfruje klucz dostępu i klucz tajny oraz ustawi właściwość S3_ENCRYPTED na zaszyfrowaną wartość klucza dostępu.

      • S3_BUCKET= <nazwa zasobnika S3>

        Jest to nazwa zasobnika Amazon S3, w którym chcesz przechowywać plik kopii zapasowej oprogramowania ArcGIS Enterprise.

      • S3_CREDENTIAL_TYPE= <IAMRole | accessKeys>

        Ustaw właściwość S3_CREDENTIAL_TYPE na wartość IAMRole, jeśli będziesz uzyskiwać dostęp do zasobnika S3_BUCKET za pomocą roli IAM w usłudze AWS. Ustaw ją na wartość accessKeys, jeśli będziesz uzyskiwać dostęp do zasobnika S3_BUCKET za pomocą użytkownika IAM w usłudze AWS za pośrednictwem klucza dostępu. Rola lub użytkownik IAM musi mieć uprawnienia do odczytu i zapisu do zasobnika S3 podanego za pomocą właściwości S3_BUCKET.

      • S3_REGION= <region usługi AWS, w którym utworzono zasobnik S3>
      • S3_BACKUP_NAME = <nazwa pliku kopii zapasowej>

        Ta właściwość jest używana tylko podczas odtwarzania wdrożenia oprogramowania ArcGIS Enterprise. Podaj nazwę pliku kopii zapasowej, który chcesz odtworzyć. Jeśli nie podasz nazwy pliku kopii zapasowej, zostanie odtworzony najnowszy plik kopii zapasowej.

    W tym przykładzie pełna kopia zapasowa portalu pod adresem URL https://portalhostname.domain.com:7443/arcgis, usług i ustawień jego serwerów hostujących i sfederowanych oraz danych hostowanej warstwy obiektowej zapisanych w relacyjnym magazynie danych ArcGIS Data Store zostaną początkowo zapisane w plikach w ścieżce \\\\myserver\\tempbackups. Te oddzielne pliki zostaną skompresowane do jednego pliku kopii zapasowej (entbackup) i skopiowane do ścieżki \\mybuserver\\wgbackups. Pamięci podręczne warstw scen z magazynu danych ArcGIS Data Store pamięci podręcznej kafli nie zostaną uwzględnione, ponieważ dla właściwości INCLUDE_SCENE_TILE_CACHES ustawiono wartość 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

    W tym przykładzie pełna kopia zapasowa portalu pod adresem URL https://portalonaws.mydomain.com:7443/gis, jego katalogu zasobów (zapisanego w zasobniku S3 portalcontent), usług i ustawień serwerów hostujących i sfederowanych portalu i danych zapisanych w relacyjnych magazynach danych i pamięci podręcznej kafli zostaną zapisane w zasobniku S3 entbackups w regionie usługi AWS eu-west-1. Plik kopii zapasowej ma nazwę fullbackup06June. Rola IAM służy do uzyskiwania dostępu do konta usługi AWS.

    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

  3. Zapisz plik właściwości.

    Wartość właściwości PORTAL_ADMIN_PASSWORD zostanie zaszyfrowana w pliku, a właściwość PORTAL_ADMIN_PASSWORD_ENCRYPTED zostanie ustawiona na wartość true po uruchomieniu narzędzia webgisdr z tym plikiem.

  4. Open a command shell, change directories to the location of the webgisdr utility, and run the utility with the export option.

    In this example, the properties file (mywebgis.properties) was saved in the user-created directory /home/ags/arcgis/portal/propfiles.

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

A file is created in the location you specified for the SHARED_LOCATION in the properties file. The file name is <timestamp>.webgissite.

Move the export file

If the export file was created in a location that the standby deployment cannot access, move the backup file to a location that the webgisdr tool can access. Make a copy of the properties file specifically to be used for importing, and update the BACKUP_LOCATION value in the new properties file to reflect the new location of the export file. If the BACKUP_LOCATION is a directory, the tool will extract the latest backup within the directory into the SHARED_LOCATION. If the BACKUP_LOCATION is set to a specific backup file, the tool will extract that backup into the SHARED_LOCATION.

Ensure the machines in the standby deployment can access the SHARED_LOCATION path.

Należy pamiętać, że konto domeny służące do uruchamiania narzędzia webgisdr powinno mieć co najmniej prawo do odczytu lokalizacji BACKUP_LOCATION i do zapisu w lokalizacji SHARED_LOCATION. Dodatkowo należy upewnić się, że konto używane podczas instalowania serwera ArcGIS Server, witryny Portal for ArcGIS i aplikacji ArcGIS Data Store ma prawo do odczytu lokalizacji SHARED_LOCATION.

For the purposes of this workflow example, the copy of the properties file is named toimport.properties.

Install components for standby deployment

Before you import the ArcGIS Enterprise deployment to the standby for the first time, you need to install and configure all software components (ArcGIS Server, Portal for ArcGIS, ArcGIS Web Adaptor, and ArcGIS Data Store) on the standby machines. The URL used to access the portal (either the load balancer URL or web adaptor URL) and the ArcGIS Server services URL must be the same for the standby deployment as they are for your primary deployment.

For example, if the URL to access the portal on the primary deployment is https://myportalslb.organization.com/portal and the services URL for the GIS Server on the primary deployment is https://myserverslb.organization.com/server, the standby deployment must use the same URLs.

Additional ArcGIS licenses are not required for the standby deployment because it is not actively accessed; you only make it the active deployment if the primary fails.

Import to standby deployment

Once you have an empty deployment on the standby machines, import the content from your primary deployment.

If your primary ArcGIS Enterprise deployment is highly available, the webgisdr tool maintains high-availability settings for the GIS Server site and the ArcGIS Data Store relational and tile cache data stores when you import to the standby deployment. For the portal, the webgisdr tool unregisters the standby portal machine, restores the portal to the primary machine, and reregisters the standby machine when imported.

  1. Open a command shell on the Portal for ArcGIS machine of the standby deployment, change directories to the location of the webgisdr utility, and run the utility with the export option.

    In this example, the properties file (toimport.properties) was saved in the user-created directory /home/ags/arcgis/portal/propfiles.

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

    Note that the property file does not have to be in the same directory you saved it in when first created. If you do move it, specify the new directory location with the --file parameter.

Maintain standby deployment

To minimize data loss, export from the primary and import to the standby deployment as frequently as possible. How often you can do this depends on how long it takes to export and import your deployment, and whether you can script the export and import processes without the need for manual intervention (for example, you may need to physically copy files from one location to another).

Switch to standby when primary fails

As discussed in Disaster recovery and replication, your IT department can bring the standby deployment online if your primary deployment fails.