configurebackuplocation

Dieses Dienstprogramm wird mit allen ArcGIS Data Store-Typen verwendet.

Mit dem Dienstprogramm "configurebackuplocation" können Sie den Speicherort angeben, in den ArcGIS Data Store die Sicherungsdateien für geplante Sicherungen und für Sicherungen, die mit dem Dienstprogramm backupdatastore erstellt werden, schreiben soll. Mit dem Dienstprogramm "configurebackuplocation" können Sie zudem Eigenschaften eines Sicherungsspeichers ändern und einen Sicherungsspeicher entfernen.

Data Stores vom Typ "relational" werden mit einem lokalen Standardsicherungsspeicher erstellt. Um Datenverluste zu vermeiden, können Sie einen Standardsicherungsspeicher konfigurieren, indem Sie mit der Option change eine Remote-Dateifreigabe registrieren.

Big Data Stores vom Typ "spatiotemporal", Graph Stores und Objektspeicher werden nicht mit einem Standardsicherungsspeicher erstellt. Damit Sicherungen erstellt werden können, müssen Sie das Dienstprogramm "configurebackuplocation" mit der Option register ausführen und einen Dateifreigabe-Speicherort, einen Amazon S3-Bucket (Simple Storage Service) oder einen Microsoft Azure Blob Storage-Container für diese Sicherungen festlegen.

Hinweis:

Sicherungsdateien für Big Data Stores vom Typ "spatiotemporal" können nicht auf einem lokalen Laufwerk gespeichert werden.

Sie können einen zweiten Sicherungsspeicher registrieren, um die mit dem Dienstprogramm "backupdatastore" erstellten Sicherungen zu speichern. Als sekundären Sicherungsspeicher können Sie ein freigegebenes Dateiverzeichnis, einen S3-Bucket oder einen Azure Blob Storage-Container verwenden.

Weitere Informationen zu ArcGIS Data Store-Sicherungen finden Sie unter Verwalten von ArcGIS Data Store-Sicherungen.

Syntax:

configurebackuplocation --store {relational | spatiotemporal | graph | object} --operation {change | register | unregister | list | setdefault} [--location "<backup_location_arguments>"] [additional options]

Erforderliche Optionen

Beim Ausführen des Dienstprogramms "configurebackuplocation" müssen Sie die folgenden Optionen angeben:

--store {relational | spatiotemporal | graph | object}

Geben Sie den ArcGIS-Data-Store-Typ an, für den Sie Sicherungsspeicher konfigurieren oder abfragen. Der Standardwert ist relational.
--operation {change | register | unregister | list | setdefault}

Mit der Option --operation wird die Aktion festgelegt, die vom Dienstprogramm "configurebackuplocaton" ausgeführt wird. Der Standardwert ist change.

Im Folgenden werden die Argumente erläutert, die mit der Option --operation verwendet werden können:


Option	Beschreibung
`change`	Mit diesem Argument können Sie folgende Änderungen vornehmen: Angeben eines anderen freigegebenen Dateispeicherorts für geplante Sicherungen von Data Stores vom Typ "relational". Der mit dem Argument `change` festgelegte Speicherort ist immer der Standardsicherungsspeicher für Data Stores vom Typ "relational". Sie müssen die Option `--location` angeben, wenn Sie den Standardsicherungsspeicher für den Data Store vom Typ "relational" ändern. Ändern des Namens für den Sicherungsspeicher. Sie müssen die Option `--location` und das zugehörige Argument `name` angeben, wenn Sie den Namen eines Sicherungsspeichers ändern. Aktualisieren der Authentifizierungsinformationen, die Sie für Sicherungsspeicher in Azure oder S3 festgelegt haben. Für S3 können Sie die Informationen ändern, die Sie zuvor mit den Optionen `username` und `password` angegeben haben. Für Azure können Sie den Wert für `password` ändern.
`register`	Mit diesem Argument können Sie einen Sicherungsspeicher registrieren. Wenn Sie das Argument `register` verwenden, müssen Sie die Option `--location` angeben. Der erste Sicherungsspeicher, den Sie für einen Big Data Store vom Typ "spatiotemporal", einen Graph Store oder einen Objektspeicher definieren, wird als Standardsicherungsspeicher festgelegt. Wenn Sie einen anderen Sicherungsspeicher für einen Big Data Store vom Typ "spatiotemporal", einen Graph Store oder einen Objektspeicher registrieren, wird dieser als sekundärer Sicherungsspeicher festgelegt. Beim Data Store vom Typ "relational" wird mit dem Argument `register` immer ein sekundärer Sicherungsspeicher registriert. In dem sekundären Sicherungsspeicher können manuelle Sicherungen gespeichert werden, die mit dem Dienstprogramm backupdatastore generiert wurden.
`unregister`	Verwenden Sie dieses Argument, um einen sekundären Sicherungsspeicher aus einem Data Store zu entfernen. Wenn nur ein Sicherungsspeicher registriert ist, wird mit dem Argument "unregister" der Sicherungsspeicher für den Big Data Store vom Typ "spatiotemporal", den Objektspeicher oder den Graph Store vollständig entfernt.
`list`	Alle für den mit der Option `--store` angegebenen Data Store registrierten Sicherungsspeicher werden aufgelistet. Die Liste enthält Angaben zum physischen Sicherungsspeicher, zum Namen des Sicherungsspeichers und dazu, welcher Sicherungsspeicher als Standardsicherungsspeicher registriert ist.
`setdefault`	Wenn Sie für den Graph Store, den Objektspeicher oder den Big Data Store vom Typ "spatiotemporal" mehrere Sicherungsspeicher angegeben haben, verwenden Sie das Argument `setdefault`, um einen der Sicherungsspeicher als Standardverzeichnis festzulegen. Geplante Sicherungen werden in dieses Verzeichnis geschrieben, und es wird auch als Standardverzeichnis verwendet, wenn Sie das Dienstprogramm backupdatastore, listbackups oder restoredatastore ausführen, ohne einen Sicherungsspeicher anzugeben.

Die Option "location"

Die Option --location ist in den folgenden Szenarien erforderlich:

Geben Sie den Speicherort des Sicherungsspeichers an, wenn Sie einen Sicherungsspeicher registrieren oder den ursprünglichen Standardsicherungsspeicher für den Data Store vom Typ "relational" ändern.
Um den Namen eines vorhandenen Sicherungsspeichers zu ändern, geben Sie das Argument name und den neuen Namenswert an.

Sie können die Option --location oder den Sicherungsnamen verwenden, wenn Sie einen Standardsicherungsspeicher festlegen oder einen Sicherungsspeicher entfernen.

Geben Sie für den Big Data Store vom Typ "spatiotemporal" oder zum Registrieren eines sekundären Sicherungsspeichers für den Data Store vom Typ "relational" die folgenden Argumente mit der Option --location durch Semikolons (;) getrennt an, und setzen Sie die gesamte Argumentzeichenfolge in doppelte Anführungszeichen ("):

--location "type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>];[endpointsuffix=<Azure_cloud_location> | region=<AWS_region>]".

Im Folgenden werden die einzelnen für die Option --location unterstützten Argumente erläutert:


Argument	Beschreibung
`type=`	Dieses Argument ist erforderlich. Geben Sie an, welche Art von Speicherort für Sicherungen verwendet werden soll. Geben Sie `fs` an, um Sicherungen in einer Dateifreigabe zu speichern. Bei Data Stores vom Typ "relational" muss der Standardsicherungsspeicher eine Dateifreigabe sein. Geben Sie `s3` an, um Sicherungen in einem Amazon S3-Bucket zu speichern. Geben Sie `azure` an, um Sicherungen in einem Azure Blob Storage-Container zu speichern.
`location=`	Dieses Argument ist erforderlich. Geben Sie für Dateifreigaben den Dateipfad an. Geben Sie für Amazon S3-Buckets den Bucket-Namen und den Bucket-Pfad an. Geben Sie für BLOB-Speichercontainer den Container-Namen und den Container-Pfad an. Wenn Sie dieses Argument verwenden, um den ursprünglichen Standardsicherungsspeicher für den Data Store vom Typ "relational" zu ändern, darf der angegebene Speicherort kein vorhandener registrierter Sicherungsspeicher sein.
`name=`	Sie können dem Sicherungsspeicher einen Namen zuweisen. Handelt es sich bei dem Sicherungsspeicher um einen Dateipfad, z. B. `\\sharedserver_sharedfolders_datastorebackups`, können Sie für diesen Speicherort einen Namen, z. B. dsbackupsfolder, festlegen. Beim Ausführen des Dienstprogramms backupdatastore, listbackups oder restoredatastore können Sie dann anstelle des Verzeichnispfads diesen Namen angeben. Wenn Sie beim Konfigurieren des Data-Store-Sicherungsspeichers keinen Namen festlegen, weist ArcGIS Data Store einen Standardnamen zu.
`username=`	Dieses Argument ist erforderlich, wenn Sie das Argument `type=` auf `azure` oder `s3` festlegen. Geben Sie für S3-Buckets die Zugriffsschlüssel-ID Ihres AWS-Kontos (Amazon Web Services) an. Geben Sie für Azure Blob Storage-Container den Namen für das Microsoft Azure-Speicherkonto an, das Zugriff auf den Blob Storage-Container hat.
`password=`	Dieses Argument ist erforderlich, wenn Sie das Argument `type=` auf `azure` oder `s3` festlegen. Geben Sie für S3-Buckets den geheimen Schlüssel Ihres AWS-Kontos an. Geben Sie für Azure Blob Storage-Container den Schlüssel für das Azure-Konto an, das Sie mit dem Argument `username` festgelegt haben.
`endpointsuffix=`	Wenn Sie das Argument `type=` auf `azure` festlegen, können Sie das Argument `endpointsuffix` verwenden, um anzugeben, wo sich der Azure Blob Storage-Container befindet. Standardmäßig wird für `endpointsuffix` der Wert `core.windows.net` angenommen. Wenn sich Ihr Container in der Microsoft Azure-Government-Cloud-Umgebung befindet, legen Sie `endpointsuffix=core.usgovcloudapi.net` fest. Wenn sich Ihr Container in einer privaten Cloud befindet, legen Sie für `endpointsuffix` das Endpunktsuffix Ihrer privaten Azure-Cloud fest.
`region=`	Dieses Argument ist erforderlich, wenn Sie das Argument `type=` auf `s3` festlegen. Sie müssen den Regionscode angeben. Legen Sie beispielsweise die Region ap-southeast-2 fest, wenn der Bucket in der Region "Asien-Pazifik (Sydney)" bereitgestellt wird. Informationen zu Regionscodes finden Sie in der AWS-Dokumentation.

Zusätzliche Optionen

Folgende zusätzliche Optionen können Sie mit dem Dienstprogramm "configurebackuplocation" bereitstellen:


Option	Beschreibung
`--force`	Diese Option wird nur mit Data Stores vom Typ "relational" verwendet und ermöglicht es Ihnen, den Standardsicherungsspeicher zu ändern, auch wenn der vorhandene Standardsicherungsspeicher nicht verfügbar ist. Gültige Werte: `true` und `false`. Wenn Sie den Standardsicherungsspeicher für einen Data Store vom Typ "relational" ändern, kopiert ArcGIS Data Store die vorhandenen Sicherungsdateien vom alten Speicherort an den neuen Speicherort. Ist der Zugriff von ArcGIS Data Store auf den alten Speicherort nicht möglich, können die Dateien nicht kopiert werden. In vorherigen Versionen führt dies zu einem Fehler im Werkzeug "configurebackuplocation". Um mit der Änderung des Standardsicherungsspeichers fortzufahren, ohne vorhandene Sicherungsdateien zu kopieren, geben Sie `--force true` an. Der Standardwert für diese Option ist `false`. Das heißt, Sie können den Standardsicherungsspeicher nicht ändern, wenn ArcGIS Data Store nicht auf das vorhandene Standardverzeichnis zugreifen kann.
`--prompt`	Gültige Werte: `yes` und `no`. Wenn Sie dieses Dienstprogramm ausführen, werden Sie dazu aufgefordert, den angegebenen Vorgang zu bestätigen. Wenn Sie die Verwendung dieses Dienstprogramms automatisieren, legen Sie die Option `--prompt` auf `no` fest, da sonst das Skript erst dann fortgesetzt wird, wenn Sie auf die Eingabeaufforderung reagiert haben.

Beispiele

Die folgenden Abschnitte enthalten Beispiele für das Ändern, Festlegen oder Auflisten von Sicherungsspeichern für Data Stores.

Ändern des Standardsicherungsspeichers für den Data Store vom Typ "relational"

Im ersten Beispiel ist der Sicherungsspeicher für einen Data Store vom Typ "relational" auf ein Verzeichnis mit dem Namen "fsdata_bu" auf einem Computer mit dem Namen "myshare" festgelegt.

./configurebackuplocation.sh --operation change --store relational --location "type=fs;location=/net/myshare/fsdata_bu"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

configurebackuplocation --operation change --store relational --location "type=fs;location=\\myshare\fsdata_bu"
You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

Hinzufügen eines Sicherungsspeichers für den Data Store vom Typ "relational"

In diesem Beispiel wird unter Azure ein zweiter Sicherungsspeicher für denselben Data Store vom Typ "relational" registriert.

./configurebackuplocation.sh --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

configurebackuplocation --operation register --store relational --location "type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount"

You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)? Yes

Festlegen eines Sicherungsspeichers für einen Graph Store

In diesem Beispiel wird ein Sicherungsspeicher auf einer Netzwerkfreigabe für einen Graph Store registriert. Dem Sicherungsspeicher wird ein Name, "fshare", zugewiesen.

./configurebackuplocation.sh --operation register --store graph --location "type=fs;location=/net/sharedmachine/g_bu;name=fshare" --prompt no

configurebackuplocation --operation register --store graph --location "type=fs;location=\\sharedmachine\g_bu;name=fshare" --prompt no

Hinzufügen eines Sicherungsspeichers und Festlegen eines Standardverzeichnisses

In diesem Beispiel wird ein zweiter Sicherungsspeicher für den Big Data Store vom Typ "spatiotemporal" festgelegt. Der zusätzliche Sicherungsspeicher befindet sich im Azure-Speicher.

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount" --prompt no

In diesem Beispiel wird auf AWS ein zweiter Sicherungsspeicher für denselben Big Data Store vom Typ "spatiotemporal" in der Region "Europa (Spanien)" festgelegt. Dem Sicherungsspeicher wird ein Name, "awsloc", zugewiesen.

./configurebackuplocation.sh --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

configurebackuplocation --operation register --store spatiotemporal --location "type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0;region=eu-south-2" --prompt no

In diesem Beispiel wird der S3-Bucket als Standardsicherungsspeicher für den Big Data Store vom Typ "spatiotemporal" festgelegt. Dafür wird der Name des Sicherungsspeichers (awsloc) genutzt.

./configurebackuplocation.sh --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

configurebackuplocation --operation setdefault --store spatiotemporal --location "name=awsloc" --prompt no

Abrufen einer Liste aller Sicherungsspeicher für einen Data Store

In diesem Beispiel werden alle Sicherungsspeicher für den Big Data Store vom Typ "spatiotemporal" aufgelistet.

./configurebackuplocation.sh --operation list --store spatiotemporal

configurebackuplocation --operation list --store spatiotemporal

Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       /net/sharedmachine/ge_bu     false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false

Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       \\sharedmachine\ge_bu        false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false