Skip to main content

changedbproperties

Dieses ArcGIS Data Store-Dienstprogramm kann mit dem Data Store vom Typ "relational", dem Objektspeicher und dem Big Data Store vom Typ "spatiotemporal" verwendet werden.

Mit dem Dienstprogramm "changedbproperties" können Sie abhängig vom Typ des Data Store, für den Sie es ausführen, verschiedene Eigenschaften ändern.

Syntax:

changedbproperties --store {relational | spatiotemporal | object} [configuration options]

Sie müssen die Option --store und mindestens eine Konfigurationsoption angeben. Im Folgenden sind die unterstützten Konfigurationsoptionen, deren Beschreibungen und der Data-Store-Typ angegeben, der mit den einzelnen Optionen verwendet werden kann:

Konfigurationsoption

Beschreibung

Unterstützter Data-Store-Typ

--disk-threshold-readonly

Mit dieser Option wird festgelegt, wann ein Data Store vom Typ "relational" in den schreibgeschützten Modus versetzt wird, um Datenverlust aufgrund von nicht genügendem Speicherplatz zu vermeiden.

Geben Sie Größenwerte in MB an. Der Standardwert für den Speicherplatz beträgt 1024 MB.

Nur Data Store vom Typ "relational"

--max-connections

Mit diesem Parameter geben Sie die maximale Anzahl der für einen Data Store vom Typ "relational" zulässigen Verbindungen an.

Der Data Store vom Typ "relational" akzeptiert standardmäßig bis zu 150 Verbindungen. Verwenden Sie die Eigenschaft --max-connections, um die Anzahl der zulässigen Verbindungen zu ändern.

Bedenken Sie, dass für interne Prozesse in ArcGIS Data Store bis zu fünf Verbindungen benötigt werden. Überlegen Sie außerdem, wie viele parallele Verbindungen der ArcGIS Data Store-Computer bei gleichbleibend guter Performance unterstützen kann. Wenn der Computer, auf dem ArcGIS Data Store ausgeführt wird, nur über einen begrenzten Speicherplatz verfügt, müssen Sie die Anzahl der zulässigen Verbindungen möglicherweise verringern.

Die Anzahl, die Sie angeben, darf nicht kleiner als 10 sein.

Wenn Sie die maximale Anzahl zulässiger Verbindungen ändern, wird diese sowohl auf dem primären Computer als auch auf dem Standby-Computer der Data Stores geändert.

Nur Data Store vom Typ "relational"

--pitr

Mit dieser Option wird festgelegt, ob in ArcGIS Data Store inkrementelle Sicherungen für den Data Store vom Typ "relational" erstellt werden. Dadurch ist es Ihnen möglich, den Data Store vom Typ "relational" auf einen bestimmten Zeitpunkt wiederherzustellen.

Für diese Option sind die Argumente enable bzw. disable möglich.

Nur Data Store vom Typ "relational"

Die Standardeinstellung ist --pitr disable.

Achtung:

Bei einer Wiederherstellung auf einen bestimmten Zeitpunkt ist es erforderlich, dass vollständige, automatische Sicherungen vorhanden sind. Deaktivieren Sie die automatischen Sicherungen nicht, wenn Sie die Option --pitr auf enable festlegen.

Sie müssen die Option --pitr auf enable festlegen, wenn Sie das Dienstprogramm "webgisdr", das mit Portal for ArcGIS installiert wird, zum Erstellen von inkrementellen Sicherungen der ArcGIS Enterprise-Bereitstellung verwenden möchten.

--enablessl

Mit dieser Option wird die Verwendung des Protokolls Transport Layer Security (TLS) für die Kommunikation zwischen dem Data Store vom Typ "relational" und dem Hosting-Server gesteuert.

Für den Parameter --enablessl werden die folgenden Argumente unterstützt:

  • true: Dies ist die Standardeinstellung. Das Protokoll "Transport Layer Security" wird bei der Kommunikation zwischen dem Data Store vom Typ "relational" und dem Hosting-Server verwendet, wenn Sie --store relational angeben.

  • false: Geben Sie false und --store relational an, damit bei der Kommunikation zwischen dem Hosting-Server und dem Data Store vom Typ "relational" HTTP verwendet wird.

Nur Data Store vom Typ "relational"

--heap-size

Verwenden Sie diesen Parameter, um die Größe des Heap-Speichers (in MB) zu ändern, die vom Big Data Store vom Typ "spatiotemporal" oder vom Objektspeicher verwendet wird.

Standardmäßig nutzt ein Big Data Store vom Typ "spatiotemporal" beim Start 50 % des gesamten RAM bzw. 70 % des verfügbaren RAM, je nachdem, welcher Wert kleiner ist. Sie können die Heap-Größe in einen Wert zwischen 512 MB und 32.000 MB ändern. Sie müssen jedoch darauf achten, dass die angegebene Größe die auf dem Computer verfügbare Größe des Arbeitsspeichers nicht übersteigt. Wenn der Big Data Store vom Typ "spatiotemporal" mehrere Computer enthält, führen Sie das Dienstprogramm "changedbproperties" auf jedem Computer aus, um die Heap-Größe zu vergrößern.

Der vom Objektspeicher standardmäßig verwendete Heap-Speicher hängt vom verfügbaren RAM auf dem Computer ab.

  • In den meisten Fällen nutzt ein Objektspeicher 50 % des gesamten RAM bzw. 70 % des verfügbaren RAM, je nachdem, welcher Wert kleiner ist.

  • Auf Computern mit mehr als 20 GB RAM nutzt der Objektspeicher beim Start 40 % des RAM, aber nur, wenn der verfügbare RAM 40 % bis 70 % des gesamten RAM beträgt.

Sie können die Heap-Größe für den Objektspeicher in einen Wert zwischen 1024 MB (Minimum) und 124.000 MB (Maximum) ändern. Beachten Sie jedoch Folgendes:

  • Wenn der verfügbare RAM auf dem Computer zwischen 16 GB und 32 GB liegt, beträgt die minimale nutzbare Heap-Größe für den Objektspeicher 6 GB.

  • Stellen Sie sicher, dass die angegebene Menge für die Heap-Größe den verfügbaren RAM des Computers nicht überschreitet.

Wenn der Objektspeicher mehrere Computer enthält, werden alle Computer im Cluster aktualisiert, und der Objektspeicher wird auf allen Computern im Cluster neu gestartet.

Nur Big Data Store vom Typ "spatiotemporal" und Objektspeicher

--rebalance

Für diese Option ist standardmäßig true eingestellt. Dies bedeutet, dass Daten aus dem Big Data Store vom Typ "spatiotemporal" auf andere Computer verteilt werden, wenn ein Computer nicht verfügbar sein sollte.

Wenn ein Computer des Big Data Store vom Typ "spatiotemporal" beispielsweise im Rahmen eines Upgrades gewartet werden muss, können Sie die Neuverteilung vorübergehend abschalten, indem Sie --rebalance false angeben. Die Neuverteilung wird für die im Parameter --max-rebalance-off festgelegte Anzahl von Minuten ausgesetzt.

Nur Big Data Store vom Typ "spatiotemporal"

--max-rebalance-off

Diese Option wird in Kombination mit der Option --rebalance verwendet, um anzugeben, wie lange die Neuverteilung ausgesetzt bleibt.

Standardmäßig ist --max-rebalance-off auf 60 Minuten eingestellt. Wenn Sie also den Neuausgleich vorübergehend ausgeschaltet haben, wird er nach 60 Minuten wieder aufgenommen. Sollten Sie für die Wartungsaufgabe mehr bzw. weniger Zeit benötigen, sollten Sie die Zeiteinstellung für die ausgesetzte Neuverteilung im Parameter --max-rebalance-off entsprechend ändern.

Nur Big Data Store vom Typ "spatiotemporal"

--prompt

Wenn Sie dieses Dienstprogramm ausführen, werden Sie dazu aufgefordert, den angegebenen Vorgang zu bestätigen. Wenn Sie die Verwendung dieses Dienstprogramms automatisieren, geben Sie --prompt no an, da sonst das Skript erst dann fortgesetzt wird, wenn Sie auf die Eingabeaufforderung reagiert haben.

Alle von diesem Dienstprogramm unterstützten Data Stores

Beispiele

Die folgenden Abschnitte enthalten Beispiele zur Verwendung der Optionen, die mit dem Dienstprogramm "changedbproperties" verfügbar sind.

Ändern des schreibgeschützten Schwellenwerts für den Data Store vom Typ "relational"

Der Data Store vom Typ "relational" wird standardmäßig in den schreibgeschützten Modus versetzt, wenn weniger als 1.024 MB Speicherplatz verfügbar ist. Im folgenden Beispiel schreiben andere Apps auf den Computer. Der Administrator konfiguriert daher, dass der Data Store vom Typ "relational" früher in den schreibgeschützten Modus versetzt wird: sobald der freie Speicherplatz auf dem Computer unter 4.000 MB liegt:

./changedbproperties.sh --store relational --disk-threshold-readonly 4000

changedbproperties --store relational --disk-threshold-readonly 4000

You are changing the following database properties:
      ...disk space threshold to change relational store into READONLY mode to 4000MB)
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)?Yes

Ändern der Anzahl der zulässigen Verbindungen mit dem Data Store vom Typ "relational"

In diesem Beispiel ist die für einen Data Store vom Typ "relational" maximal zulässige Anzahl an Verbindungen auf 100 gesetzt:

./changedbproperties.sh --store relational --max-connections 100

changedbproperties --store relational --max-connections 100

You are changing the following database properties:
      ...max number of connections to 100 (on all relational 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)?Yes

Aktivieren der Wiederherstellung auf einen bestimmten Zeitpunkt für den Data Store vom Typ "relational"

Standardmäßig ist die Wiederherstellung auf einen bestimmten Zeitpunkt deaktiviert. In diesem Beispiel wird die Wiederherstellung auf einen bestimmten Zeitpunkt für den Data Store vom Typ "relational" aktiviert:

./changedbproperties.sh --store relational --pitr enable

changedbproperties --store relational --pitr enable

You are changing the following database properties:
      ...enable point-in-time recovery for relational store
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)?Yes

Deaktivieren von SSL

Standardmäßig kommuniziert der Data Store vom Typ "relational" mit dem Hosting-Server über HTTPS. In diesem Beispiel wird der Parameter --enablessl verwendet, um den Data Store vom Typ "relational" so zu konfigurieren, dass er mit dem Hosting-Server über HTTP kommuniziert.

./changedbproperties.sh --store relational --enablessl false

changedbproperties --store relational --enablessl false

You are changing the following database properties:
      ...disable ssl for relational store
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)?Yes

Ändern der Heap-Größe für den Big Data Store vom Typ "spatiotemporal" oder den Objektspeicher

Sie können die RAM-Menge ändern, die der Big Data Store vom Typ "spatiotemporal" oder der Objektspeicher beim Start nutzt. Werte der Heap-Größe in MB.

Achtung:

Durch Verringern der Heap-Größe könnte verhindert werden, dass der Data Store gestartet wird. Wenn Sie die Heap-Größe erhöhen, geben Sie keine Zahl über der verfügbaren RAM-Größe des Computers an.

In diesem Beispiel ist die Heap-Größe auf einem Big-Data-Store-Computer vom Typ "spatiotemporal" auf 1.600 MB festgelegt.

./changedbproperties.sh --store spatiotemporal --heap-size 1600

changedbproperties --store spatiotemporal --heap-size 1600

You are changing the following database properties:
      ...heap size for spatiotemporal store to 1600MB (on current machine)
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)?Yes

In diesem Beispiel ist die Heap-Größe auf einem Objektspeichercomputer auf 2.400 MB festgelegt.

./changedbproperties.sh --store object --heap-size 2400

changedbproperties --store object --heap-size 2400

You are changing the following database properties:
      ...heap size to 2400MB for the object store installed on this machine
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)?Yes

Unterbrechen der Neuverteilung für den Big Data Store vom Typ "spatiotemporal"

In diesem Beispiel muss der Administrator eine kurze Wartungsprozedur auf einem Computer im Big Data Store vom Typ "spatiotemporal" durchführen und möchte die Neuverteilung durch den Data Store verhindern. Dazu werden die Optionen --rebalance und --max-rebalance-off verwendet, um die Neuverteilung für 30 Minuten zu unterbrechen. Nach 30 Minuten ändert der Big Data Store vom Typ "spatiotemporal" rebalance automatisch in "true".

Da dies regelmäßig erfolgen muss, speichert der Administrator die folgende Anweisung in einem Skript und legt die Option "prompt" auf "no" fest.

./changedbproperties.sh --store spatiotemporal --rebalance false --prompt no

./changedbproperties.sh --store spatiotemporal --max-rebalance-off 30 --prompt no

changedbproperties --store spatiotemporal --rebalance false --prompt no

changedbproperties --store spatiotemporal --max-rebalance-off 30 --prompt no