Erstellen einer ArcGIS Enterprise-Sicherung

Die Komponenten der ArcGIS Enterprise-Bereitstellung können in eine Sicherungsdatei exportiert werden, die später zum Wiederherstellen der Bereitstellung bei einem Hardwarefehler oder Datenverlust genutzt werden kann. Die Datei umfasst Ihre Portal-Elemente und -Einstellungen, gehosteten Web-Layer, Verbund- und Hosting-Servereinstellungen und bei Verwendung von ArcGIS Data Store Ihre gehosteten Feature-Layer-Daten und gehosteten Szenen-Layer-Caches. Die Größe der Sicherungsdatei und der Zeitaufwand für deren Erstellung ist je nach Anzahl der Elemente in Ihrem Portal, Anzahl und Typ Ihrer gehosteten Web-Layer, Anzahl Ihrer Verbundserver und Anzahl der ArcGIS Server-Computer auf Ihren gehosteten und Verbundservern unterschiedlich. Wenn Sie eine Bereitstellung sichern, die keine Daten oder Services enthält, hat die erstellte Datei eine Größe von etwa 400 MB. Ihre Datei ist immer größer als dieser Wert.

Verwenden Sie das Dienstprogramm "webgisdr" mit dem Exportvorgang und eine Eigenschaftendatei, um eine Sicherung Ihrer ArcGIS Enterprise-Bereitstellung zu erstellen. Das Dienstprogramm befindet sich im Werkzeugverzeichnis von Portal for ArcGIS. Die folgenden Kriterien müssen erfüllt werden, um dieses Dienstprogramm verwenden zu können:

• Das freigegebene Verzeichnis, das Sie angeben, muss groß genug sein, um die exportierte Datei aufzunehmen. Führen Sie einen Testexport der ArcGIS Enterprise-Bereitstellung aus, um einen Eindruck von der Größe der Datei zu bekommen, legen Sie fest, wie viele Dateien in dem freigegebenen Verzeichnis beibehalten werden sollen, und wählen Sie die Größe des Verzeichnisses entsprechend aus.
• Dem Konto, mit dem die jeweilige Softwarekomponente in ArcGIS Enterprise installiert wurde, müssen Lese- und Schreibberechtigungen für das freigegebene Verzeichnis zugewiesen sein.
• Die Sicherung für jede Komponente wird in einem temporären Verzeichnis auf dem Computer der jeweiligen Komponente abgelegt, bevor sie in das von Ihnen angegebene freigegebene Verzeichnis verschoben wird. Daher müssen die folgenden Verzeichnisse groß genug sein, um die Sicherung der jeweiligen Komponente aufzunehmen:
  • Portal for ArcGIS: <Portal_content_directory>/temp
  • ArcGIS Server: /<ArcGIS_Server_installation_directory>/temp
  • ArcGIS Data Store: <ArcGIS_Data_Store_directory>/temp
• Für den ArcGIS Data Store vom Typ "relational" Ihrer ArcGIS Enterprise-Bereitstellung müssen Sie die Wiederherstellung auf einen bestimmten Zeitpunkt aktivieren.

Führen Sie die folgenden Schritte aus, um eine Sicherung Ihrer ArcGIS Enterprise-Bereitstellung zu erstellen:

1. Erstellen Sie eine Kopie der Eigenschaftendatei der Vorlage. Sie können die Kopie im selben Verzeichnis wie die Vorlage oder in einem neuen Verzeichnis speichern.

   Die Eigenschaftendatei der Vorlage, webgisdr.properties, wird standardmäßig in /arcgis/portal/tools/webgisdr installiert.

   In diesem Beispiel hat die Kopie der Datei den Namen mywebgis.properties und wird in /home/ags/arcgis/portal/propfiles gespeichert.

2. Öffnen Sie die Kopie der Eigenschaftendatei, und bearbeiten Sie sie, um Informationen anzugeben, die für Ihre Site spezifisch sind.

   • SHARED_LOCATION = <Verzeichnis für Sicherungsdateien>

     Legen Sie einen freigegebenen Speicherort fest, an dem eine temporäre Kopie der Sicherungsdateien für ArcGIS Server, Portal for ArcGIS und ArcGIS Data Store erstellt werden soll. Das Konto, mit dem ArcGIS Server, Portal for ArcGIS und ArcGIS Data Store installiert wurden, und das Konto, das das Dienstprogramm "webgisdr" ausführt, müssen über Lese- und Schreibzugriff auf dieses Verzeichnis verfügen. Stellen Sie sicher, dass das Verzeichnis groß genug für die Sicherungsdatei ist. Obwohl die Datei komprimiert ist, kann sie je nach Datenmenge und -typ ziemlich umfangreich sein. Wenn Sie über gehostete Szenen-Layer und Caches verfügen und INCLUDE_SCENE_TILE_CACHES auf true festlegen, kann die ArcGIS Data Store-Sicherungsdatei besonders groß sein.

     Ältere Versionen:

     In Portal for ArcGIS 10.4 lautete diese Eigenschaft SHARED_FOLDER.

   • BACKUP_STORE_PROVIDER = {FileSystem | AmazonS3}

     Diese Eigenschaft ist erstmals in 10.5.1 verfügbar. Wenn Sie Ihre ArcGIS Enterprise-Sicherungsdatei lokal an einem Speicherort der Dateifreigabe speichern möchten, legen Sie FileSystem fest, damit das Dienstprogramm "webgisdr" Ihre Sicherungsdateien in der Dateifreigabe ablegt, die Sie für BACKUP_LOCATION festgelegt haben.

     Wenn Sie Ihre ArcGIS Enterprise-Sicherungen in einem Amazon Simple Storage Service (S3)-Bucket speichern möchten, erstellen Sie ein S3-Bucket speziell zum Speichern von Sicherungsdateien, die mit dem Dienstprogramm "webgisdr" erstellt werden, und aktualisieren Sie die S3-Eigenschaften mit den Informationen, die für den Zugriff auf den Bucket erforderlich sind.

   • BACKUP_LOCATION = <Verzeichnis einer lokalen Sicherungsdatei>

     Diese Eigenschaft ist erstmals in 10.5.1 verfügbar. Wenn Sie BACKUP_STORE_PROVIDER = FileSystem festlegen, werden Sicherungsdateien in SHARED_LOCATION gespeichert, anschließend jedoch nach BACKUP_LOCATION kopiert. Stellen Sie sicher, dass der Speicherort groß genug für die Sicherungsdatei ist. Obwohl die Datei komprimiert ist, kann sie je nach Datenmenge und -typ recht umfangreich sein. Das Konto, mit dem das Dienstprogramm "webgisdr" ausgeführt wird, muss über Lese- und Schreibzugriff auf BACKUP_LOCATION verfügen.

   • PORTAL_ADMIN_URL = <URL des Adminverzeichnisses für das Portal>

     Geben Sie die URL des Admin-Verzeichnisses von Portal for ArcGIS an. Verwenden Sie das Format https://portalhostname.domain.com:7443/arcgis, wobei portalhostname.domain.com der vollständig qualifizierte Name des Computers ist, auf dem Portal for ArcGIS installiert ist.

   • PORTAL_ADMIN_USERNAME = <Benutzername des Portal-Administrators>

     Geben Sie den Benutzernamen eines Portal-Mitglieds an, dem die von Esri definierte Administratorrolle zugewiesen ist.

   • PORTAL_ADMIN_PASSWORD = <Kennwort des Portal-Administrators>

     Geben Sie das Kennwort des Portal-Administratorkontos an.

   • PORTAL_ADMIN_PASSWORD_ENCRYPTED = <true | false>

     Legen Sie diese Option auf false fest, wenn Sie die Datei zum ersten Mal mit Ihrem Administratorkennwort füllen. Wenn Sie die Datei speichern, wird Ihr Kennwort verschlüsselt und der Wert für PORTAL_ADMIN_PASSWORD_ENCRYPTED auf true gesetzt, um anzugeben, dass das Kennwort verschlüsselt wurde. Wenn Sie das Kennwort in Zukunft ändern müssen, legen Sie PORTAL_ADMIN_PASSWORD_ENCRYPTED = false fest, geben Sie Ihr neues Administratorkennwort an, und speichern Sie die Datei.

   • INCLUDE_SCENE_TILE_CACHES = <true | false>

     Wenn Sie gehostete Szenen-Layer in Ihrem Portal veröffentlichen und die Szenen-Cache-Daten in die Sicherung einbeziehen möchten, legen Sie INCLUDE_SCENE_TILE_CACHES auf true fest. Beachten Sie, dass bei Auswahl der Einstellung true alle Szenen-Cache-Daten in die Sicherung einbezogen werden, nicht nur die neuen Cache-Daten, die seit der letzten Sicherung erstellt wurden. Wenn Ihnen bekannt ist, dass keine neuen Szenen-Caches seit Ihrer letzten Sicherung erstellt wurden oder Sie keine Szenen für das Portal veröffentlichen, können Sie INCLUDE_SCENE_TILE_CACHES auf false festlegen.

   • BACKUP_RESTORE_MODE = <full | incremental>

     Wenn Sie nur vollständige Sicherungen erstellen, können Sie diese Eigenschaft auf full festlegen. Um die Größe von Sicherungen zu verringern, können Sie jedoch zwei verschiedene Eigenschaftendateien erstellen: eine mit BACKUP_RESTORE_MODE = full, die Sie gelegentlich zum Erstellen vollständiger Sicherungen verwenden, und eine mit BACKUP_RESTORE_MODE = incremental zum Erstellen inkrementeller Sicherungen zwischen vollständigen Sicherungen. Jede inkrementelle Sicherung enthält alle Änderungen seit der letzten vollständigen Sicherung.

     Wenn BACKUP_RESTORE_MODE nicht in der Eigenschaftendatei festgelegt wird, werden standardmäßig full-Sicherungen erstellt.

   • Wenn Ihre ArcGIS Enterprise-Bereitstellung unter AWS ausgeführt wird und das Inhaltsverzeichnis des Portals in Amazon S3 gespeichert wird, benötigen Sie einen Sicherungs-Bucket für das Inhaltsverzeichnis. Erstellen Sie einen Sicherungs-Bucket in S3, und legen Sie PORTAL_BACKUP_S3_BUCKET in der Eigenschaftendatei auf den Namen des Buckets fest, und setzen Sie PORTAL_BACKUP_S3_REGION auf die AWS-Region, in der Sie den S3-Bucket erstellt haben. Weitere Informationen zu diesem Implementierungstyp finden Sie in der Hilfe zu ArcGIS Enterprise unter Konfigurieren von ArcGIS Enterprise on Amazon Web Services mit AWS-Speicherservices.

     Ältere Versionen:

     Vor ArcGIS Enterprise 10.5.1 lautete die PORTAL_BACKUP_S3_BUCKET-Eigenschaft BACKUP_BUCKET_NAME.

   • Ab 10.5.1 ArcGIS Enterprise Cloud Builder for Microsoft Azure können Sie Ihr Portal-Inhaltsverzeichnis in einem Azure-Blobspeicher-Container speichern. Um eine Sicherung dieser Bereitstellung mit dem Dienstprogramm "webgisdr" zu erstellen, müssen Sie die folgenden Eigenschaften festlegen (neu in 10.5.1):
     • PORTAL_BACKUP_BLOB_ACCOUNT_NAME = <Azure-Speicherkonto>

       Legen Sie PORTAL_BACKUP_BLOB_ACCOUNT_NAME auf den Namen des Azure-Blobspeicherkontos fest.

       Tipp:

       Sie haben diesen Speicherkontonamen bei Auswahl der Option Use Azure Cloud Storage for the configuration and content store im Bereich Deployment Options von Cloud Builder festgelegt.

     • PORTAL_BACKUP_BLOB_ACCOUNT_KEY = <Kontoschlüssel>

       Setzen Sie PORTAL_BACKUP_BLOB_ACCOUNT_KEY auf den mit Ihrem Azure-Blobspeicherkonto verknüpften Kontoschlüssel.

     • PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED = false

       Legen Sie PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED auf false fest, wenn Sie zuerst den PORTAL_BACKUP_BLOB_ACCOUNT_KEY-Wert hinzufügen. Wenn Sie die webgisdr.properties-Datei speichern, wird der Schlüssel verschlüsselt und das Werkzeug setzt PORTAL_BACKUP_BLOB_ACCOUNT_KEY auf true.

     • PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT = <Speicherkonto-Endpunkt>

       Legen Sie den Speicherkonto-Endpunkt für den Blob-Service fest.

     • PORTAL_BACKUP_BLOB_ENDPOINT_URL = <Blob-Dienst-URL>

       Legen Sie die URL des Blob-Service-Endpunktes fest. Diese URL liegt im Format https://<PORTAL_BACKUP_BLOB_ACCOUNT_NAME>.<PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT>/<container name> vor.

   • Wenn Sie BACKUP_STORE_PROVIDER auf AmazonS3 festgelegt haben, stellen Sie Informationen für die folgenden Eigenschaften bereit (erstmals in 10.5.1 verfügbar):
     • S3_ACCESSKEY= <Der Zugriffsschlüssel für Ihr AWS-Konto>

       Diese Einstellung wird nur benötigt, wenn S3_CREDENTIAL_TYPE=accessKeys festgelegt wurde. Der durch diesen Zugriffsschlüssel dargestellte IAM-Benutzer muss über Lese- und Schreibzugriff für den S3-Bucket verfügen, den Sie mit der S3_BUCKET-Eigenschaft festlegen.

     • S3_SECRETKEY= <Der geheime Schlüssel für Ihr AWS-Konto>

       Legen Sie den geheimen Schlüssel fest, der mit dem Zugriffsschlüssel für Ihr AWS-Konto verknüpft ist. Dieser wird nur dann verwendet, wenn Sie S3_CREDENTIAL_TYPE auf accessKeys festgelegt haben.

     • S3_ENCRYPTED = false

       Behalten Sie die Einstellung auf false bei. Wenn Sie S3_CREDENTIAL_TYPE beim Ausführen des Dienstprogramms "webgisdr" auf accessKeys gesetzt haben, werden der Zugriffsschlüssel und der geheime Schlüssel vom Dienstprogramm verschlüsselt und S3_ENCRYPTED wird auf den Wert des verschlüsselten Zugriffsschlüssel festgelegt.

     • S3_BUCKET= <Name des S3-Buckets>

       Dies ist der Name des Amazon S3-Buckets, in dem Sie Ihre ArcGIS Enterprise-Sicherungsdatei speichern möchten.

     • S3_CREDENTIAL_TYPE= <IAMRole | accessKeys

       Legen Sie S3_CREDENTIAL_TYPE auf IAMRole fest, wenn Sie mit einer AWS IAM-Rolle auf S3_BUCKET zugreifen möchten. Legen Sie ihn auf accessKeys fest, wenn Sie mit einem AWS IAM-Benutzer über einen Zugriffsschlüssel auf den S3_BUCKET zugreifen. Die IAM-Rolle bzw. der IAM-Benutzer muss über Lese- und Schreibzugriff für den S3-Bucket verfügen, den Sie mit der S3_BUCKET-Eigenschaft festlegen.

     • S3_REGION= <AWS-Region, in der Sie den S3-Bucket erstellt haben>
     • S3_BACKUP_NAME = <Name der Sicherungsdatei>

       Diese Eigenschaft wird nur beim Wiederherstellen einer ArcGIS Enterprise-Bereitstellung verwendet. Geben Sie den Namen der Sicherungsdatei an, die Sie wiederherstellen möchten. Wenn Sie den Namen der Sicherungsdatei nicht angeben, wird die aktuelle Sicherungsdatei wiederhergestellt.

   In diesem Beispiel werden das Portal mit der URL https://portalhostname.domain.com:7443/arcgis, die Services und Einstellungen seiner Hosting- und Verbundserver sowie die gehosteten Feature-Layer-Daten, die im ArcGIS Data Store vom Typ "relational" gespeichert sind, anfänglich in eine Sicherungsdatei unter \\\\myserver\\tempbackups ausgegeben. Die getrennten Dateien werden in eine einzelne Sicherungsdatei komprimiert (entbackup) und nach \\mybuserver\\wgbackups kopiert. Szenen-Layer-Caches aus dem Data Store vom Typ "Kachel-Cache" von ArcGIS Data Store werden nicht einbezogen, da INCLUDE_SCENE_TILE_CACHES auf false festgelegt ist.

   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 diesem Beispiel wird eine vollständige Sicherung des Portals unter der URL https://portalonaws.mydomain.com:7443/gis, dessen Inhaltsverzeichnis (im S3-Bucket portalcontent gespeichert), die Services und Einstellungen des Hosting- und Verbundservers sowie die in den Data Stores vom Typ "relational" und "Kachel-Cache" gespeicherten Daten in den S3-Bucket entbackups der AWS-Region, eu-west-1, ausgegeben . Der Name der Sicherungsdatei lautet fullbackup06June. Eine IAM-Rolle wird für den Zugriff auf das AWS-Konto verwendet.

   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. Speichern Sie die Eigenschaftendatei.

   Der Wert PORTAL_ADMIN_PASSWORD wird in der Datei verschlüsselt und PORTAL_ADMIN_PASSWORD_ENCRYPTED wird auf true festgelegt, nachdem Sie das Dienstprogramm "webgisdr" mit dieser Datei ausgeführt haben.

4. Öffnen Sie eine Befehlsshell auf dem Portal for ArcGIS-Computer, ändern Sie das Verzeichnis in das des Dienstprogramms "webgisdr", und führen Sie das Dienstprogramm mit der Exportoption aus.

   Das Dienstprogramm "webgisdr" wird unter <Portal for ArcGIS installation directory>/tools/webgisdr installiert.

   Die Syntax für "webgisdr" lautet wie folgt:

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

   Wie zuvor erwähnt, wurde die Eigenschaftendatei (mywebgis.properties) in dem vom Benutzer erstellten Verzeichnis /home/ags/arcgis/portal/propfiles gespeichert.

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

   Die Sicherungsdatei wird in dem Verzeichnis erstellt, das Sie für den SHARED_LOCATION in der Eigenschaftendatei angegeben haben. Der Dateiname lautet <timestamp>.webgissite.

5. Wenn die ArcGIS Enterprise-Bereitstellung Kartenservice- oder gehostete Kachel-Layer-Caches enthält, erstellen Sie manuell eine Sicherheitskopie aller Verzeichnisse, in denen die Cache-Kacheln gespeichert werden (z. B. das vollständige Verzeichnis arcgiscache unter C:\arcgisserver\directories\ oder <ArcGIS Server installation directory>/arcgis/server/usr/directories).

   Diese Verzeichnisse enthalten die Karten-Cache-Kacheln und die Kachelschemadatei conf.xml. Die Cache-Verzeichnisse können auch eine File-Geodatabase, status.gdb, mit Informationen dazu enthalten, welche Kacheln erstellt wurden.

Sie können diese Datei zum Wiederherstellen der ArcGIS Enterprise-Bereitstellung verwenden.