Dienstprogramme werden mit ArcGIS Data Store installiert, um dem Data Store-Administrator die Verwaltung des Data Store zu ermöglichen. In diesem Thema werden die Dienstprogramme beschrieben und die Syntax und Beispiele bereitgestellt.
Alle Dienstprogramme müssen auf dem ArcGIS Data Store-Computer ausgeführt werden. Sie finden die Dienstprogramme im Verzeichnis <ArcGIS Data Store installation directory>\datastore\tools.
Unterstützung zur Syntax erhalten Sie, wenn Sie den Namen des Dienstprogramms, gefolgt von --help, eingeben.
Hinweis:
Ihr Anmeldename muss der Windows-Administratorgruppe angehören, und Sie müssen die Eingabeaufforderung mit der Option Als Administrator ausführen öffnen, um die ArcGIS Data Store-Dienstprogramme nutzen zu können.
allowconnection
Aus Sicherheitsgründen werden alle Verbindungen zum Data Store standardmäßig über die ArcGIS-Server-Site hergestellt. Wenn Sie einen relationalen Data Store für Verbindungen von einem zusätzlichen Computer öffnen möchten, können Sie das Dienstprogramm "allowconnection" verwenden.
Das Dienstprogramm "allowconnection" kann nur auf dem primären relationalen Data Store-Computer ausgeführt werden.
Syntax
allowconnection <host name> <user name> [<database>]
Geben Sie den Namen des Computers, der eine Verbindung zum relationalen Data Store herstellen darf (Host-Name), sowie eines der vom Data Store verwendeten Datenbankkonten (Benutzername) an: entweder den Data Store-Administrator, Replikatbesitzer, Geodatabase-Administrator oder den verwalteten Benutzer (derjenige, der Feature-Layer-Daten veröffentlicht). Diese können Sie mithilfe des Dienstprogramms "listadminusers" oder "listmanageduser" abrufen. Sie können auch den Namen der Data Store-Datenbank angeben, doch da für die Speicherung der gehosteten Feature-Layer-Daten nur eine Datenbank vorhanden ist, ist dieser Wert optional.
Beispiel
In diesem Beispiel ist eine Verbindung vom workcom-Computer zum relationalen Data Store zulässig, wenn Verbindungen über den verwalteten Benutzer hqo.n_1E7 hergestellt werden.
allowconnection workcom hqo.n_1E7
backupdatastore
Mithilfe des Dienstprogramms "backupdatastore" können Sie zwischen die geplanten Sicherungszeiten eine Sicherung des relationalen Data Stores einschieben. Beispielsweise könnten Sie eine Komplettsicherung manuell erstellen, bevor Sie den Data Store aktualisieren oder daran viele Änderungen vornehmen.
Das Dienstprogramm "backupdatastore" kann nur auf dem primären Data Store-Computer ausgeführt werden. Mit backupdatastore wird ausschließlich ein relationaler Data Store gesichert.
Syntax
backupdatastore <backup name>
Beispiel
In diesem Beispiel wird eine Komplettsicherungsdatei mit dem Namen "project1bu" an dem Sicherungsspeicherort erstellt, den Sie mithilfe des Dienstprogramms "changebackuplocation" für den Data Store angegeben haben.
backupdatastore project1bu You are going to back up the data store. This could take some time, depending on the size of your data store. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
changebackuplocation
Die Data Store-Sicherungsdateien werden standardmäßig auf demselben Computer wie der Data Store gespeichert. Damit Sie im Falle eines Ausfalls des Data Store Zugriff auf Ihre Sicherungsdateien haben, sollten Sie diese auf einen separaten Computer verschieben.
Stellen Sie ein, dass der Data Store-Service mit einem Domänenkonto ausgeführt werden soll, erteilen Sie für dieses Konto Lese- und Schreibzugriff für ein freigegebenes Netzwerkverzeichnis und verschieben Sie mithilfe des Dienstprogramms "changebackuplocation" Ihre Data Store-Sicherungsdateien in das freigegebene Verzeichnis auf einem anderen Computer.
Das Dienstprogramm "changebackuplocation" gilt nur für die Sicherungen eines relationalen Data Stores.
Syntax
changebackuplocation <new directory path> [--is-shared-folder <true|false>] [--keep-old-backups <true|false>]
Geben Sie --is-shared-folder true an, wenn der Sicherungsspeicherort sich auf einem freigegebenen Netzwerkcomputer befindet. Um vorhandene Sicherungsdateien an den neuen Speicherort zu verschieben, geben Sie --keep-old-backups true an.
Beispiel
In diesem Beispiel werden Sicherungen im freigegebenen Verzeichnis "ds_backups" auf dem Computer "sysshare" erstellt. Alle im aktuellen Sicherungsverzeichnis möglicherweise vorhandenen Sicherungen werden an diesen neuen Speicherort verschoben.
changebackuplocation \\sysshare\ds_backups --is-shared-folder true --keep-old-backups true You are going to change the data store backup directory. Do you want to continue (Yes or No)?Yes
changedbproperties
Mit dem Dienstprogramm "changedbproperties" lassen sich je nach Typ des Data Stores, für den es ausgeführt wird, verschiedene Eigenschaften ändern. Relationale Data Store akzeptieren standardmäßig bis zu 150 Verbindungen. Mithilfe der Eigenschaft "--max-connections" des Dienstprogramms "changedbproperties" lässt sich die Anzahl der zulässigen Verbindungen anpassen. Bedenken Sie bei der Ermittlung des Verbindungsbedarfs Ihres Data Store, dass für interne Prozesse in ArcGIS Data Store bis zu fünf Verbindungen benötigt werden. Berücksichtigen Sie außerdem, wie viele parallele Verbindungen Ihr ArcGIS Data Store-Computer bei gleichbleibend guter Funktion akzeptieren kann. Wenn der Computer, auf dem ArcGIS Data Store ausgeführt wird, nur über einen begrenzten Speicherplatz verfügt, müssen Sie die zulässige Zahl der Verbindungen beschränken.
Wenn Sie die maximale Anzahl zulässiger Verbindungen ändern, wird diese sowohl auf dem primären als auch auf dem Standby-Data-Store-Computer geändert.
Syntax
changedbproperties --store <relational | tileCache | spatiotemporal> [configuration option]
Mögliche Konfigurationsoptionen:
- max-connections: Mit diesem Parameter geben Sie die maximale Anzahl der für einen relationalen Data Store zulässigen Verbindungen an. Die angegebene Anzahl darf nicht kleiner als 10 sein. Dieser Parameter wird nicht für Big Data Stores "spatiotemporal" oder Kachel-Cache-Data-Stores unterstützt.
- heap-size: Mithilfe dieses Parameters ändern Sie die Größe des Heap-Speichers, der von einem Big Data Store "spatiotemporal" verwendet wird. Standardmäßig nutzt dieser Data Store-Typ beim Start die Hälfte des verfügbaren RAM. Dieser Parameter wird nicht für relationale oder Kachel-Cache-Data-Stores unterstützt.
- reallocation: Für diesen Parameter ist standardmäßig TRUE eingestellt. Das bedeutet, dass Daten aus dem Big Data Store "spatiotemporal" fragmentiert (in andere Shards verschoben) werden, wenn ein Shard nicht verfügbar sein sollte. Falls ein Shard gewartet werden muss, beispielsweise bei einer Aktualisierung, können Sie die Neuzuweisung vorübergehend abschalten, indem Sie diesen Parameter auf "false" setzen. Neuzuweisungen werden für den Zeitraum ausgesetzt, der im Parameter "max-allocation-off" festgelegt wird. Dieser Parameter gilt nur für Big Data Stores "spatiotemporal".
- max-allocation-off: Dieser Parameter kommt zum Einsatz, wenn der Parameter "reallocation" deaktiviert wird. Standardmäßig ist "max-allocation-off" auf 60 Minuten eingestellt. Wenn Sie also die Neuzuweisung vorübergehend ausgeschaltet haben, wird sie nach 60 Minuten wieder aufgenommen. Sollten Sie für die Wartungsaufgabe mehr oder weniger Zeit benötigen, können Sie die Zeiteinstellung im Parameter "max-allocation-off" für die ausgesetzte Neuzuordnung ändern. Dieser Parameter gilt nur für Big Data Stores "spatiotemporal".
- prompt: Wenn Sie dieses Dienstprogramm ausführen, werden Sie aufgefordert, den angegebenen Vorgang zu bestätigen. Wenn Sie die Verwendung dieses Dienstprogramms automatisieren, setzen Sie den Parameter "prompt" auf "false", da sonst das Skript erst dann fortgesetzt wird, wenn Sie auf die Eingabeaufforderung reagiert haben.
Beispiel
In diesem Beispiel ist die für einen relationalen Data Store maximal zulässige Anzahl an Verbindungen auf 100 gesetzt:
changedbproperties --store relational --max-connections 100
You are changing the following database properties:
max number of connections to 100 (on all data store machines)
Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yeschangeloglocation
Wenn der Data Store die Fehlerprotokolldatei nicht am standardmäßigen Speicherort <ArcGIS Data Store installation directory>\arcgisdatastore\logs ablegen soll, können Sie mit dem Dienstprogramm "changeloglocation" Fehlerprotokolldateien in einem anderen Verzeichnis anlegen.
Das ArcGIS Data Store-Konto muss für den angegebenen Ordner Schreibzugriff haben.
Syntax
changeloglocation <directory path>
Beispiel
In diesem Beispiel werden die Protokolldateien lokal unter d:\datastorefiles\logs gespeichert.
changeloglocation 'd:\datastorefiles\logs'
changenosqldslocation
Kachel-Cache-Data-Stores können sehr groß werden, wenn viele hochauflösende Kacheln darin gespeichert werden. In diesen Fällen können Sie beispielsweise Daten auf ein anderes Laufwerk desselben Servers oder an einen freigegebenen Speicherort auf einem anderen Server verschieben.
Wenn Sie die Daten in ein freigegebenes Verzeichnis verschieben, müssen Sie dem Benutzer, der den ArcGIS Data Store-Prozess (Linux) bzw. -Dienst (Windows) ausführt, Lese- und Schreibberechtigungen für das Verzeichnis gewähren.
changenosqldslocation <path> [--prompt {yes | no}]In diesem Beispiel werden die Datenbanken, die Szenen-Layer-Caches speichern, in das freigegebene Verzeichnis namens "dstorecache" auf dem Computer "server2" verschoben.
changenosqldslocation \\server2\dstorecache
changepassword
ArcGIS Data Store generiert nach dem Zufallsprinzip Benutzernamen und Kennwörter für die Datenbankkonten und relationale Data Stores. Wenn Ihre Site verlangt, dass Sie Ihre eigenen Kennwörter festlegen, rufen Sie die Kennwörter für Data Store-Konten ab und setzen sie mit "changepassword" zurück.
Verwenden Sie das Dienstprogramm listadminusers zum Abrufen der Namen und Kennwörter des Administrators und das Dienstprogramm listmanageduser zum Abrufen des Benutzernamens und des Kennworts für den Feature-Daten-Besitzer.
Das Dienstprogramm "changepassword" kann nur auf dem primären relationalen Data Store-Computer ausgeführt werden.
Syntax
changepassword <user name> <new password> [--prompt {yes | no}]Tipp:
Wenn Sie Kennwortänderungen per Skript durchführen müssen, geben Sie ein Flag an, das die Bestätigungsaufforderung unterdrückt. Siehe dazu das folgende Beispiel:
changepassword gwi_n2Te0 Phfl4mp! --prompt no
Beispiel
In diesem Beispiel wird das Benutzerkennwort von gwi_n2Te0 in Phfl4mp! geändert.
changepassword gwi_n2Te0 Phfl4mp! You are going to change the password for user gwi_n2Te0. Do you want to continue (Yes or No)?Yes
changestaginglocation
Wenn Sie Ihre Feature-Layer-Daten wiederherstellen, werden die komprimierten Sicherungsdateien mit ArcGIS Data Store in einem Staging-Verzeichnis extrahiert. Das bedeutet, dass das Staging-Verzeichnis in der Lage sein muss, diese unkomprimierten Daten aufzunehmen. Wenn Ihr Data Store viele Daten enthält, sollten Sie ein separates Staging-Verzeichnis einrichten und für eine Wiederherstellung des relationalen Data Stores angeben.
Syntax
changestaginglocation <directory path>
Beispiel
In diesem Beispiel lautet das angegebene Staging-Verzeichnis \\netserver\stage.
changestaginglocation \\netserver\stage
configuredatastore
Nach der Installation von ArcGIS Data Store können Sie das Dienstprogramm "configuredatastore" ausführen, um einen Data Store zu erstellen und bei einer ArcGIS-Server-Site zu registrieren. Mit folgendem Befehl können Sie die folgenden Typen von Data Stores erstellen:
- Einen Data Store für Ihre gehostete Feature-Layer-Daten (relational)
- Einen Data Store für gehostete Szenen-Layer-Kachel-Caches (Kachel-Cache)
- Einen Data Store für archivierte Beobachtungsdaten (spatiotemporal)
Bei der Veröffentlichung eines gehosteten Szenen-Layers erstellt ArcGIS einen gehosteten Feature-Layer, einen gehosteten Szenen-Layer und einen Szenen-Cache. Um dies zu realisieren, wird in ArcGIS Data Store sowohl ein relationaler Data Store als auch ein Data Store für Kachel-Caches erstellt. Wenn Sie Ihren vorhandene GIS-Server-verwaltete Datenbank für die Speicherung gehosteter Feature-Layer-Daten verwenden möchten, bietet das Dienstprogramm "configuredatastore" die Option, nur einen Szenen-Kachel-Cache-Data Store zu erstellen.
Hinweis:
Behalten Sie im Blick, dass Sie bei Verwendung einer eigenen verwalteten Datenbank für gehostete Feature-Layer-Daten keine ArcGIS Data Store-Werkzeuge für die Verwaltung der Datenbank nutzen können. Anders ausgedrückt, nutzen Sie zur Verwaltung von Benutzern und Sicherungen die Werkzeuge Ihres DBMS. Außerdem werden Sie die Hochverfügbarkeitsfunktion, die ArcGIS Data Store bietet, nicht in Anspruch nehmen können.
Syntax
configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores <relational | tileCache | spatiotemporal>] [--nosql-only true|false]
Die Admin-URL für ArcGIS-Server hat das Format https://gisserver.domain.com:6443/arcgis. Geben Sie die URL im vorgenannten Format an, selbst wenn Ihre ArcGIS-Server-Site einen Web Adaptor verwendet.
Geben Sie Benutzernamen und Kennwort für einen integrierten Benutzer (nicht Enterprise) ein, der über Administratorberechtigungen für ArcGIS-Server verfügt.
Das Datenverzeichnis ist der Speicherort auf dem lokalen Computer, auf dem Sie die Data Store-Dateien erstellen wollen.
Konfigurieren eines spezifischen Typs von Data Store
Sie können einen ArcGIS Data Store für gehostete Feature-Layer-Daten konfigurieren, in dem Sie relational mit dem --stores-Vorgang angeben. Auf diese Weise lässt sich auch ein Data Store für gehostete Szenen-Layer-Kachel-Caches vorbereiten.
Wenn Sie die eigene verwaltete Datenbank als Data Store für gehostete Feature-Layer-Daten verwenden, jedoch gehostete Szenen-Layer veröffentlichen möchten, können Sie tile Cache beim --stores-Vorgang angeben. Dadurch wird nur der für gecachte Kacheln von Szenen-Layern verwendete Data Store registriert und kein Data Store für Feature-Layer-Daten erstellt.
Ältere Versionen:
In früheren Versionen wurde der --nosql-only-Vorgang auf true gesetzt, um einen Data Store zu erstellen, der ausschließlich für gecachte Kacheln von Szenen-Layern gedacht ist. Dieser Vorgang ist nach wie vor vorhanden, sodass vorhandene Skripte weiterhin funktionieren. Stellen Sie zukünftig stattdessen den --stores-Vorgang auf tileCache ein.
Wenn Sie ArcGIS GeoEvent Extension for Server verwenden und große Mengen an Beobachtungsdaten in hoher Geschwindigkeit speichern wollen, geben Sie spatiotemporal beim --stores-Vorgang an. Verwenden Sie zum Konfigurieren eines Big Data Store "spatiotemporal" nicht den Data Store-Konfigurationsassistenten, sondern schließen Sie den Assistenten, wenn er sich nach der Installation von ArcGIS Data Store öffnet. Sie können auf demselben Computer sowohl einen relationalen Data Store als auch einen Big Data Store "spatiotemporal" erstellen, indem Sie beim --stores-Vorgang relational,spatiotemporal angeben. Allerdings ist es nicht ratsam, beide auf dem gleichen Computer auszuführen, da sie dann um Speicherplatz und anderen Ressourcen konkurrieren.
Weitere Informationen zum Arbeiten mit Big Data Stores "spatiotemporal" finden Sie in der ArcGIS GeoEvent Extension for Server-Hilfe.
Beispiel
In diesem Beispiel wird ein Data Store für gehostete Feature-Layer-Daten (relationaler Data Store) erstellt. Die vom Data Store verwendete URL von ArcGIS-Server lautet https://dataserver.mydomain.com:6443/arcgis, der Benutzername und das Kennwort des Site-Administrators lauten "admin" bzw. "Iph33l$ik", und das Datenverzeichnis des Data Stores ist C:\datastore\data\.
configuredatastore https://dataserver.mydomain.com:6443/arcgis admin Iph33l$ik c:\datastore\data\ --stores relational
configureserviceaccount
Mithilfe des Dienstprogramms "configureserviceaccount" lässt sich die Anmeldung für das ArcGIS Data Store-Konto ändern. Wenn Sie das Konto mit diesem Dienstprogramm einrichten, können Sie die Kontoinformationen in eine Datei exportieren. Beachten Sie, dass das Kennwort in der Datei verschlüsselt ist. Die Datei können Sie für den Import der gleichen Kontoinformationen verwenden, beispielsweise, wenn Sie einen weiteren ArcGIS Data Store einrichten und das gleiche Konto nutzen möchten. Führen Sie in diesem Fall das Dienstprogramm "configureserviceaccount" auf dem neuen Computer aus und importieren Sie die Datei mit den Kontoinformationen.
Sie können es auch zum Aktualisieren des Kennworts des ArcGIS Data Store-Kontos verwenden. Wenn sich das Kennwort für die Windows-Anmeldedaten ändert, führen Sie das Dienstprogramm aus und geben Sie für das vorhandene Windows-Konto ein neues Kennwort an.
Syntax
configureserviceaccount [--username <Windows account>] [--password <account password>] [--readconfig <user configuration file>] [--writeconfig <user configuration file>]
Beispiel
In diesem Beispiel legt "configureserviceaccount" das mynetwork\datastore-Konto für die Ausführung des ArcGIS Data Store-Service fest und erteilt diesem Konto die für ArcGIS Data Store-Systemordner und -Dateien erforderlichen Berechtigungen.
configureserviceaccount --username mynetwork\datastore --password SewL0ng
Beachten Sie, dass durch eine Änderung des Kontos, über das der Service ausgeführt wird, ein Neustart des Service herbeigeführt wird.
Im vorliegenden Beispiel wird das ArcGIS Data Store-Konto geändert, und die Kontoinformationen werden in eine Datei (adsainfo) unter C:\adminfiles geschrieben.
configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo
In diesem Beispiel ist ArcGIS Data Store auf einem anderen Computer installiert, und der Administrator führt das Dienstprogramm "configureserviceaccount" aus, um das gleiche Konto mithilfe der im vorherigen Beispiel erstellten Datei einzurichten.
configureserviceaccount --readconfig C:\adminfiles\adsainfo
deletebackup
Mit dem Dienstprogramm "deletebackup" können Sie für relationale Data Stores erstellte Sicherungsdateien löschen. Führen Sie zunächst das Dienstprogramm listbackups aus, um die Namen und Erstellungsdaten Ihrer manuellen Sicherungen anzuzeigen. Danach können Sie mit dem Dienstprogramm "deletebackup" die nicht länger benötigten manuellen Sicherungen löschen.
Beachten Sie, dass Sie nur solche Sicherungen löschen können, die für die Wiederherstellung Ihres Data Store nicht erforderlich sind. So ist es beispielsweise nicht möglich, die aktuelle vollständige Sicherung eines relationalen Data Store zu löschen.
Syntax
deletebackup <backup name>
Beispiel
deletebackup featuresMarchbu You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible. Do you wish to continue (Yes or No)?yes Operation completed successfully
describedatastore
Mit dem Dienstprogramm "describedatastore" können Sie die folgenden Informationen über eine ArcGIS Data Store-Installation aufrufen:
- Sicherung, Protokolldatei, Staging und Szenen-Kachel-Cache-Datenverzeichnisse, die vom Data Store verwendet werden
- Ob sich der Speicherort in einem freigegebenen Netzwerk befindet
- Wie oft eine vollständige Sicherung des relationalen Data Store erfolgt (Sicherungsplan)
- Wie viele Tage Sicherungsdateien aufbewahrt werden
- Ob der Data Store gerade ausgeführt wird (Data Store-Status)
- Datum und Uhrzeit, zu denen der Standby-Data Store zum primären Data Store (Letztes Failover) wurde; wird nicht angezeigt, wenn kein Failover aufgetreten ist
- Die Namen des am Data Store beteiligten primären und (falls zutreffend) Standby-Computers (Mitgliedscomputer)
- Die für einen relationalen Data Store maximal zulässige Zahl an Verbindungen
- Die URL der ArcGIS-Server-Site, bei der der Data Store registriert ist (URL des zuständigen Systems)
- Die URL des Portals, das die ArcGIS-Server-Site als Hosting-Server nutzt (Portal-URL)
- Die Anzahl der aktuellen Feature-Layer-Verbindungen mit dem Data Store
- Der verbleibende freie Speicherplatz auf dem Data Store-Computer
Syntax
describedatastore
Beispiel
describedatastore
Information of ArcGIS DataStore sthiu0_5T
================================================
Backup location...........\\nwshare\dsbackups Is backup folder shared...true Staging location..........C:\arcgisdatastore\staging Tile cache location.......C:\arcgisdatastore\nosqldata Log location..............C:\arcgisdatastore\logs Backup schedule...........{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained......31 Data store status.........Started Last failover.............20150130190334005 Member machines...........DSPRIMARY.DOMAIN.COM, DSFAILOVER.DOMAIN.COM Maximum connections.......150 Owning system URL.........https://gisserver_webadaptor.esri.com/arcgis Portal for ArcGIS URL.....https://portal_webadaptor.esri.com/arcgis Number of connections.....8 connection(s) to managed database
Free disk space...........174.00GBexportmanageddb
Mit dem Dienstprogramm "exportmanageddb" wird eine Sicherungsdatei der Datenbank, in der die gehosteten Feature-Layer-Daten gespeichert werden, von Metadaten über den Data Store sowie von sämtlichen Datenbanken, die gehostete Szenen-Layer-Caches speichern, erstellt. Exportieren Sie den Data Store, wenn Sie eine Sicherung des Data Store erstellen müssen, die in einer ArcGIS Data Store-Installation auf einem Computer mit einem anderen Betriebssystem wiederhergestellt werden soll, oder bei der es sich um eine andere ArcGIS Data Store-Version handelt.
Stellen Sie vor dem Importieren des Data Store in den neuen Computer sicher, dass die Feature-Layer aktuell von keinem Benutzer bearbeitet oder in Ihrem Portal veröffentlicht werden. Achten Sie außerdem darauf, dass der Speicherort, an den Sie den Data Store exportieren, über genügend Speicherplatz für die Sicherungsdatei der gehosteten Feature-Layer-Datenbank und Kopien aller Ihrer gehosteten Szenen-Layer-Cache-Datenbanken verfügt.
Das Dienstprogramm "exportmanageddb" führt keinen Export von Big Data Stores "spatiotemporal" durch.
Syntax
exportmanageddb <backup name> --destination <output location> [--include-tilecache <true|false>] [--prompt {yes|no}]Wenn Sie weder die Option "--destination" noch das Ausgabeverzeichnis festlegen, wird im Standardsicherungsverzeichnis des Data Store ein Verzeichnis namens "dbdump" erstellt (falls es nicht bereits vorhanden ist) und die Exportdateien werden dort in einem neuen Verzeichnis abgelegt. Wenn das Standardsicherungsverzeichnis des Data Store beispielsweise \\sysshare\ds_backups lautet und Sie "dsexp1" als Sicherungsnamen, aber kein Ausgabeverzeichnis angeben, werden der exportierte relationale Data Store, der Kachel-Cache-Data Store sowie die zugehörigen Dateien im folgenden Verzeichnis abgelegt: \\sysshare\ds_backups\dbdump\dsexp1.
Mit der Operation include-tilecache geben Sie an, ob alle gehosteten Szenen-Layer-Kachel-Cache-Datenbanken in den Export einbezogen werden sollen. Standardmäßig sind diese Datenbanken darin enthalten. Sie können diese Datenbanken aus dem Export (--include-tilecache false ) ausschließen, wenn sie bereits in den letzten Export einbezogen waren und bekannt ist, dass seitdem keine zusätzlichen gehosteten Szenen-Layer in Ihrem Portal veröffentlicht wurden.
Beispiel
Im folgenden Beispiel werden die Sicherungsdatei, Kopien der gehosteten Szenen-Layer-Cache-Datenbanken und zugeordnete Data Store-Dateien in ein freigegebenes Netzwerkverzeichnis namens "preupgradeexp" auf einem Server namens "backupserver" ausgegeben. Da die Operation include-tilecache in diesem Beispiel nicht angegeben ist, werden alle gehosteten Szenen-Layer-Kachel-Cache-Datenbanken in den Export einbezogen.
exportmanageddb preupgradeexp --destination \\backupserver You are attempting to back up database 'db_e3hsm and nosql databases'. This could take a long time, depending on the size of your data. Please do not interrupt the process once it has started. Do you want to continue (Yes or No)?Yes
importmanageddb
Falls Sie einen ArcGIS Data Store exportiert haben, der gehostete Feature-Layer oder gehostete Szenen-Layer-Caches (oder beide) enthielt, können Sie mithilfe des Dienstprogramms "importmanageddb" den Data Store wiederherstellen. Es ist möglich, die Wiederherstellung auf einem aktualisierten ArcGIS Data Store-Computer oder in einer ArcGIS Data Store-Installation auf einem Computer durchzuführen, der ein anderes Betriebssystem aufweist als der Quell-ArcGIS Data Store.
Wenn ArcGIS Data Store beim gleichen ArcGIS-Server registriert sein soll wie zuvor, geben Sie --bound true an, geben Sie jedoch keinen --server-url an. Beachten Sie, dass --bound standardmäßig auf "true" festgelegt ist. Nach der Wiederherstellung müssen Sie die ArcGIS-Server-Site neu starten.
Wenn Sie den Data Store wiederherstellen und bei einer neuen ArcGIS-Server-Site registrieren möchten, geben Sie beim Import des Data Store --server-url an.
Standardmäßig werden der relationale Data Store und sämtliche gehosteten Szenen-Layer-Cache-Datenbanken importiert, die den Kachel-Cache-Data Store in der Exportdatei ausmachen. Wenn die gehosteten Szenen-Layer-Cache-Datenbanken nicht berücksichtigt werden sollen, setzen Sie die --include-tilecache-Operation auf "false".
Das Dienstprogramm "importmanageddb" führt keinen Import von Big Data Stores "spatiotemporal" durch.
Syntax
importmanageddb <backup name> --source-loc <source backup location> --data-dir <data store data directory>
--server-admin <user name of ArcGIS Server admin> --server-password <password of ArcGIS Server admin>
[--include-tilecache <true|false>] [--bound {true|false}] [--server-url <ArcGIS Server URL registered with data store>]
[--prompt {yes|no}]Beispiel
Im folgenden Beispiel wird der Data Store in der Installation einer neueren Version von ArcGIS Data Store wiederhergestellt. Das neue ArcGIS Data Store-Datenverzeichnis wird festgelegt. Der Data Store ist weiterhin an die vorhandene ArcGIS-Server-Site gebunden, sodass der Data Store und vorhandene gehostete Feature- und Szenen-Layer weiterhin funktionieren. Starten Sie Ihre ArcGIS-Server-Site neu, damit die gehosteten Feature- und Szenen-Layer auf dem neuen Computer veröffentlicht werden können.
importmanageddb preupgradeexp --source-loc \\backupserver\dbdump\preupgradeexp --data-dir c:\arcgis\datastore --server-admin siteadmin --server-password $Aup.4s --bound true
listadminusers
Das Dienstprogramm "listadminusers" gibt die Benutzernamen und Kennwörter für den Administrator, den Replikatbesitzer und den Geodatabase-Administrator eines relationalen Data Store zurück.
Syntax
listadminusers
Beispiel
listadminusers Admin users for ArcGIS Data store ds_abcd1234 ================================================= Database Admin User.... adm_32ret / tT30!bYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751*pb
listbackups
Das Dienstprogramm "listbackups" gibt die Namen der vollständigen relationalen Data Store-Backups und den Speicherort zurück, in den sie geschrieben werden. Außerdem gibt es den Sicherungsstatus (ob abgeschlossen oder nicht), den Zeitpunkt des Sicherungsbeginns sowie die Angabe, ob die Sicherung manuell mithilfe des Dienstprogramms "backupdatastore" oder automatisch mit ArcGIS Data Store erstellt wurde.
Führen Sie "listbackups" aus, um anzuzeigen, ob eine Sicherung noch läuft oder schon abgeschlossen ist, um zu ermitteln, wie viele manuelle Sicherungen es gibt, oder um vor Ausführung des Dienstprogramms "deletebackup" einen Dateinamen zu bestätigen.
Syntax
listbackups
Beispiel
listbackups Backup_Name Status Backup_Time Mode ==================================================================================== phase1proj_bu BackupComplete 2014-03-08 14:12 manual phase2proj_bu BackupComplete 2014-06-21 11:43 manual ds_gdt1oomh-20141103160748082 BackupComplete 2014-11-01 03:00 scheduled Backups located at: '\\myserver.net.com\dsbackups'
listmanageduser
Mit dem Dienstprogramm "listmanageduser" lassen sich Benutzername und Kennwort des verwalteten Benutzers des relationalen Data Store anzeigen. Der verwaltete Benutzer des Datenbankkontos, der die gehosteten Feature-Layer-Daten im Data Store besitzt.
Syntax
listmanageduser
Beispiel
listmanageduser Managed user for ArcGIS Data store ds_abcd1234 ================================================ UserName Password Database gwi_n2Te0 4cXddhZhve=Y db_qv5e1
registerdatastore
Der Data Store speichert Informationen über die Namen der ArcGIS-Server-Site-Computer. Wenn Sie Ihre ArcGIS-Server-Site auf neue Computer verschieben (beispielsweise bei der Anschaffung neuer Hardware oder wenn die vorhandenen ArcGIS-Server-Computer ausgefallen sind), müssen Sie die Registrierung des Data Store bei ArcGIS-Server aufheben, um diese Informationen zu entfernen. Sobald sich ArcGIS for Server auf einem neuen Computer befindet, können Sie den Data Store bei der ArcGIS-Server-Site mithilfe des Dienstprogramms "registerdatastore" registrieren.
Achten Sie darauf, dass die Registrierung des Data-Store bei der gleichen ArcGIS-Server-Site erfolgt, bei der er auch vorher registriert war. Der Data Store enthält die Daten für die auf der vorhandenen ArcGIS-Server-Site gehosteten Layer. Registriert man ihn auf einer anderen ArcGIS-Server-Site, werden die gehosteten Feature-Layer, Szenen-Layer-Caches oder Stream-Service-Datenarchive nicht neu erstellt.
Das Dienstprogramm "registerdatastore" kann nur auf dem primären Data Store-Computer ausgeführt werden.
Syntax
registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password>
Beispiel
In diesem Beispiel wird der Data Store auf einer ArcGIS-Server-Site mit der URL https://gisserver.domain.com:6443/arcgis erneut registriert. Der Benutzername des Administrators für die primäre ArcGIS-Server-Site lautet "agsadmin", das dazugehörige Kennwort "Tan$p0n".
registerdatastore https://gisserver.domain.com:6443/arcgis agsadmin Tan$p0n
removemachine
Führen Sie das Dienstprogramm "removemachine" aus, um eines der folgenden Elemente aus einer ArcGIS Data Store-Installation zu entfernen:
- Entfernen Sie einen Standby-Computer aus einem relationalen Data Store. Kann auf dem Standby-Computer oder dem primären Computer ausgeführt werden, falls der Standby-Computer nicht verfügbar ist.
- Entfernen Sie einen Standby-Computer aus einem Kachel-Cache-Data Store. Kann auf dem Standby-Computer oder dem primären Computer ausgeführt werden, falls der Standby-Computer nicht verfügbar ist.
- Entfernen Sie einen Computer aus einem Big Data Store "spatiotemporal". Besteht ein Big Data Store "spatiotemporal" nur aus einem Computer, dann ist die Ausführung von "removemachine" nicht möglich.
Syntax
removemachine <machine name> [--prompt <yes | no>]
Beispiel
Im vorliegenden Beispiel wird gefour, der Big Data Store "spatiotemporal"-Computer, aus dem Data Store entfernt.
removemachine gefour
removestandbymachine
Ältere Versionen:
Das Dienstprogramm "removestandbymachine" von Esri wurde ausgemustert. Es ist zwar noch vorhanden, um die Ausführung vorhandener Skripts zu ermöglichen, Sie sollten jedoch stattdessen das Dienstprogramm "removemachine" verwenden.
Mithilfe des ArcGIS-Server-REST-Befehls "remove" kann der ArcGIS-Server-Site-Administrator einen Standby-Computer aus einem relationalen oder Kachel-Cache-Data Store entfernen. Ist jedoch die ArcGIS-Server-Site nicht verfügbar, können Sie sich dafür nicht mehr als Site-Administrator anmelden. Führen Sie in solchen Fällen das Dienstprogramm "removestandbymachine" aus, um einen Standby-Computer aus dem Data Store zu entfernen.
Das Dienstprogramm "removestandbymachine" kann nur auf dem Standby-Computer eines relationalen bzw. eines Kachel-Cache-Data Store ausgeführt werden.
Syntax
removestandbymachine <machine name> [--prompt <yes | no>]
Beispiel
In diesem Beispiel lautet der Name des Standby-Computers "dsserver2".
removestandbymachine dsserver2
restoredatastore
Sollten Sie den Zugriff auf die von den gehosteten Feature-Layern Ihres Portals verwendeten Daten verlieren, können Sie Ihre Data Stores mithilfe Ihrer Sicherungsdateien und dem Befehlszeilendienstprogramm "restoredatastore" wiederherstellen.
Falls Sie den Data Store nicht wiederherstellen können, installieren Sie ArcGIS Data Store auf einem neuen Computer und stellen Sie die letzte Sicherung auf dem neuen Computer her.
Möchten Sie die Daten auf einen früheren Zeitpunkt zurücksetzen, führen Sie die Wiederherstellung auf dem bestehenden Data Store durch. Beachten Sie, dass sich ein früherer Status nur dann wiederherstellen lässt, wenn die entsprechenden Sicherungsdateien verfügbar sind. Wenn Sie beispielsweise Sicherungen lediglich fünf Tage aufbewahren, dann können Sie den Data Store nur auf einen Zeitpunkt innerhalb dieser fünf Tage zurücksetzen.
Das Dienstprogramm "restoredatastore" kann nur auf dem primären ArcGIS Data Store-Computer ausgeführt werden. Mit dem Dienstprogramm "restoredatastore" werden keine Archivdaten von Stream-Services wiederhergestellt (in Big Data Stores "spatiotemporal" verwendete Daten).
Syntax
restoredatastore [--target {most-recent | yyyy-mm-dd-hh:mm:ss | <backup file>}] [--source-loc <location of backup files>]
[--bound <true|false>] [--data-dir <new data store directory>] [--prompt {yes | no}]Bei der Wiederherstellung nach einem Absturz oder zum Verschieben des Data Store geben Sie --target most-recent an. Wenn Sie den Status des Data Store eines bestimmten vergangenen Zeitpunkts wiederherstellen wollen, geben Sie das gewünschte Datum und die Uhrzeit (UTC) an. Soll eine bestimmte Sicherungsdatei wiederhergestellt werden, geben Sie stattdessen den Namen dieser Datei an. Wenn Sie nichts Bestimmtes angeben, wird die neueste Sicherung wiederhergestellt.
Der wiederhergestellte Data Store ist standardmäßig seiner ArcGIS-Server-Site zugeordnet (daran gebunden). Möchten Sie jedoch den Data Store wiederherstellen, ohne die Zuordnung zur bisherigen ArcGIS-Server-Site beizubehalten, geben Sie --bound false an. Wählen Sie diese Variante nur dann als letzten Ausweg, wenn die frühere ArcGIS-Server-Site verlorengegangen und nicht wiederherstellbar ist. Stellen Sie dafür den Data Store ungebunden wieder her und konfigurieren Sie ihn mit einer neuen verbundenen ArcGIS-Server-Site. Die Feature-Layer, die die im Data Store enthaltenen Daten genutzt haben, sind danach allerdings verschwunden. Sie müssten eine Verbindung mit der Data Store-Datenbank herstellen, um die Daten in ein anderes Format zu extrahieren und im Portal erneut zu veröffentlichen.
Beispiel
In diesem Beispiel wird die neueste Sicherung von \\buserver\data\backups auf C:\arcgisdatastore übertragen. Da der Data Store standardmäßig an die ArcGIS-Server-Site gebunden bleibt, bei der er registriert wurde, müssen Sie --bound true nicht angeben.restoredatastore --target most-recent --source-loc \\buserver\data\backups --data-dir C:\arcgisdatastore
You are attempting to restore the data store from a data store backup. This process could take a long time,
depending on the size of your data. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes
In diesem Beispiel wird der Data Store von \\buserver\data\backups auf den Zustand vom 17. Juli 2014 um 14.30 Uhr (UTC) wiederhergestellt.restoredatastore --target 2014-07-17-14:30:00 --source-loc \\buserver\data\backups
You are attempting to restore the data store from a data store backup. This process could take a long time, depending on the size of your data. Please do not interrupt the process once it has started.
Do you want to continue (Yes or No)?Yes
revokeconnection
Wenn Sie für einen anderen Client mithilfe des Dienstprogramms allowconnection die direkte Verbindung zum relationalen Data Store vorübergehend zugelassen haben, können Sie diese Verbindungserlaubnis mithilfe des Dienstprogramms "revokeconnection" widerrufen.
Das Dienstprogramm "revokeconnection" kann nur auf dem primären Data Store-Computer ausgeführt werden.
Syntax
revokeconnection <host name> <user name> [<database>]
Beispiel
In diesem Beispiel lässt die Data Store-Datenbank Verbindungen vom workcom-Computer für den angemeldeten Benutzer "hqo.n_1E7" nicht länger zu.
revokeconnection workcom hqo.n_1E7
unregisterdatastore
Mit dem Dienstprogramm "unregisterdatabase" können Sie Folgendes tun:
- Heben Sie die Registrierung eines primären relationalen oder Kachel-Cache-Data Store-Computers bei Ihrer ArcGIS-Server-Site auf. Dies sollte nur dann erfolgen, wenn Sie die gehosteten Feature- und Kachel-Layer gelöscht haben, die die Daten im Data Store verwenden. Falls Sie dies unterlassen, werden im Portal unbrauchbare Layer zurückbleiben und unbrauchbare Services auf Ihrem Hosting-Server laufen.
Beachten Sie bei der Nutzung eines Standby-Computers, dass Sie ihn zunächst aus dem Data Store entfernen müssen, bevor Sie die Registrierung für das primäre Gerät aufheben können.
- Heben Sie die Registrierung eines aus einem einzelnen Computer bestehenden Big Data Store "spatiotemporal" auf.
Sollten Sie einen Data Store oder die davon abhängigen Services nicht länger nutzen wollen, müssen Sie die Registrierung des Data Store bei Ihrer ArcGIS-Server-Site aufheben. Wenn Sie die Registrierung eines Computers aus dem Data Store aufheben, kann ArcGIS-Server keine Verbindung zu dem Computer mehr herstellen, und alle Services, die Daten aus dem nicht länger registrierten Data Store enthalten, stellen ihre Funktion ein. Mit diesem Befehl werden die Daten nicht gelöscht. Wenn Sie jedoch feststellen, dass Sie den Data Store weiterhin benötigen, können Sie ihn mit dem Dienstprogramm registerdatastore oder configuredatastore wieder hinzufügen.
Das Dienstprogramm "unregisterdatastore" kann nur auf dem primären Data Store-Computer ausgeführt werden.
Syntax
unregisterdatastore [--prompt {yes | no}]Beispiel
Hier wird das Dienstprogramm "unregisterdatastore" mit einer Eingabeaufforderung ausgeführt. Dies ist das Standardverhalten. Um die Eingabeaufforderung zu unterdrücken, geben Sie --prompt No an.
unregisterdatastore You are going to unregister the data store. Do you want to continue (Yes or No)?Yes
updatebackupretaindays
ArcGIS Data Store bewahrt Sicherungsdateien des relationalen Data Stores standardmäßig sieben Tage lang auf. Sie können die Einstellung, wie oft Sicherungsdateien aus dem Sicherungsverzeichnis bereinigt werden sollen, mithilfe des Dienstprogramms "updatebackupretaindays" ändern.
Das Dienstprogramm "updatebackupretaindays" kann nur auf dem primären Data Store-Computer ausgeführt werden.
Syntax
updatebackupretaindays <number of days>
Beispiel
Im folgenden Beispiel wird die Aufbewahrungsdauer für Sicherungsdateien auf 10 Tage geändert:
updatebackupretaindays 10
updatebackupschedule
Standardmäßig erfolgt in ArcGIS Data Store alle vier Tage eine vollständige Sicherung. Mithilfe des Dienstprogramms "updatebackupretaindays" können Sie die Erstellungshäufigkeit einer vollständigen Sicherung ändern.
Geben Sie eine Anfangszeit im 24-Stunden-Format an, z. B. 00:00:00 für Mitternacht und 13:00:00 für 13 Uhr. Mithilfe der Option "Häufigkeit" können den Abstand zwischen den Sicherungen in Tagen angeben. Wenn Sie die Häufigkeit auf 0 setzen, werden automatische Sicherungen deaktiviert. Wenn Sie automatische Sicherungen deaktivieren möchten, sollten Sie das Dienstprogramm backupdatastore ausführen, um vollständige Sicherungen manuell vorzunehmen.
Das Dienstprogramm "updatebackupschedule" kann nur auf dem primären Data Store-Computer ausgeführt werden.
Syntax
updatebackupschedule [--starttime <local server time>] --frequency <number of days>
Falls Sie keine neue Startzeit festlegen, bleibt die vorhandene Einstellung unverändert.
Beispiel
In diesem Beispiel werden vollständige Sicherungen alle 10 Tage um 23 Uhr (lokale Serverzeit) durchgeführt:
updatebackupschedule --starttime 23:00:00 --frequency 10
updatelicense
Wenn Ihre ArcGIS for Server-Lizenz abläuft, müssen Sie die Lizenz auf der ArcGIS for Server-Site aktualisieren. Die Lizenzinformationen werden auch im relationalen Data Store des ArcGIS Data Store gespeichert. Daher müssen Sie die Lizenz im Data Store aktualisieren, nachdem Sie die Lizenz der ArcGIS for Server-Site, mit der der Data Store konfiguriert wurde, aktualisiert haben. Führen Sie dazu das Dienstprogramm "updatelicense" auf dem Computer aus, auf dem der primäre ArcGIS Data Store installiert ist. Wenn Sie über einen Standby-ArcGIS Data Store verfügen, wird die aktualisierte Lizenz auf diesem repliziert.
Syntax
updatelicense
Beispiel
Nachdem Sie die ArcGIS for Server-Lizenz aktualisiert haben, führen Sie das Dienstprogramm "updatelicense" aus, um die neue Lizenz in den Data Store zu verschieben.
updatelicense