Sie können mehrere Eigenschaften konfigurieren, um die Einstellungen für GeoAnalytics Server in Ihrer Bereitstellung zu ändern. Sie sollten konfiguriert werden, um die Performance von GeoAnalytics Server zu optimieren. Beim Konfigurieren dieser Einstellungen muss Folgendes beachtet werden:
- die Anzahl der Aufträge, die gleichzeitig ausgeführt werden
- die Größe der verwendeten Daten
- die Häufigkeit der Aufträge
- die verfügbaren Ressourcen
Die GeoAnalytics Tools, die Portal-Mitglieder ausführen, werden von Aufgaben im Systemservice GeoAnalyticsTools Ihrer ArcGIS Server-Site unterstützt. Die folgenden Systemeigenschaften werden in der GeoAnalytics Server-Site festgelegt, wohingegen die Service-Eigenschaften und die Anzahl der Instanzen im Systemservice "GeoAnalyticsTools" selbst festgelegt werden. Bevor Sie Änderungen an Parametern vornehmen, sollten Sie sich alle Einstellungsoptionen sorgfältig durchlesen und Ihre GeoAnalytics-Konfiguration planen.
Vorsicht:
Wenn Sie ein Upgrade auf eine neue Version von ArcGIS Enterprise durchführen, bleiben diese GeoAnalytics Server-Einstellungen nicht erhalten. Notieren Sie sich deshalb vor einem Upgrade alle Einstellungen, die Sie geändert haben, und implementieren Sie diese erneut, wenn das Upgrade abgeschlossen ist.
In diesem Thema werden die folgenden Beispiele verwendet:
- Beispiel 1: GeoAnalytics Server-Site mit drei Computern, auf der immer nur ein Auftrag ausgeführt wird
- Beispiel 2: GeoAnalytics Server-Site mit drei Computern, auf der zwei Aufträge gleichzeitig ausgeführt werden
Beide Beispiele basieren auf drei Computern (Knoten) mit je 16 GB Arbeitsspeicher und 4 CPU-Kernen. Insgesamt verfügt jede GeoAnalytics Server-Site über 48 GB Arbeitsspeicher und 12 Prozessorkerne.
Hinweis:
Es wird empfohlen, nicht mehr als 30 GB Arbeitsspeicher pro Computer für GeoAnalytics zuzuweisen.
Systemeigenschaften
Die folgenden Systemeigenschaften sind optionale Eigenschaften, die von einem Site-Administrator konfiguriert werden können, um CPU- und Speicherressourcen für den Worker-Prozess der Rechenplattform der einzelnen Computer in der ArcGIS Server-Site zuzuweisen:
- percentageMaxAllowedComputeCores: Die maximale Anzahl der CPU-Kerne (in Prozent von der insgesamt verfügbaren Anzahl auf einem Computer), die vom Worker-Prozess der Rechenplattform auf einem einzelnen Knoten genutzt werden kann. Der Standardwert ist 80 Prozent und der maximal zulässige Wert ist 90 Prozent. Wenn der angegebene Wert weniger als einem CPU-Kern entspricht, wird genau ein CPU-Kern für den Worker-Prozess der Rechenplattform verwendet.
- percentageMaxAllowedComputeMemory: Der maximale Arbeitsspeicher (in Prozent vom insgesamt verfügbaren Speicher auf einem Computer), der vom Worker-Prozess der Rechenplattform auf einem einzelnen Knoten genutzt werden kann. Der Standardwert ist 80 Prozent und der maximal zulässige Wert ist 90 Prozent.
Gehen Sie zum Bearbeiten der Systemeigenschaften folgendermaßen vor:
- Melden Sie sich am ArcGIS Server-Administratorverzeichnis als Benutzer mit Administratorberechtigungen an. Die URL hat das Format http://gisserver.domain.com:6080/arcgis/admin/.
- Wechseln Sie zu System > Eigenschaften.
- Klicken Sie auf Aktualisieren.
- Fügen Sie die Eigenschaften im folgenden JSON-Format hinzu: { "percentageMaxAllowedComputeCores": <value>, "percentageMaxAllowedComputeMemory": <value>} (z. B. {"percentageMaxAllowedComputeCores": 90, "percentageMaxAllowedComputeMemory": 90}).
Service-Eigenschaften
Für den Service GeoAnalyticsTools sind zwei Eigenschaften auf Service-Ebene vorhanden, um den maximal zulässigen Arbeitsspeicher und die maximal zulässigen CPU-Kerne pro Auftrag zuzuweisen. Standardmäßig sind dies 6 GB pro Computer und 4 CPU-Kerne. Es wird empfohlen, diese Werte entsprechend den in Ihrer Site verfügbaren Speicher- und CPU-Ressourcen anzupassen. Mit den Standardwerten kommen die Vorteile der verteilten Berechnung nicht zum Tragen, wodurch die Performance beeinträchtigt ist.
Hinweis:
Eigenschaften auf Service-Ebene können nur durch Administratoren festgelegt werden. Sie müssen die Anzahl der Kerne in Ihrer Server-Site und die Menge an Arbeitsspeicher (RAM) auf jedem Computer kennen. Wenn Sie diese Werte nicht kennen, können Sie die GeoAnalytics-Integritätsprüfung verwenden, um sie herauszufinden.
Zum Abschätzen der maximal zulässigen Menge an Arbeitsspeicher pro Auftrag und Computer kann die folgende Gleichung verwendet werden:
Floor(((percentageMaxAllowedComputeCores) * (total cores on the Server Site) / (number of simultaneous jobs)) = (Maximum allowed compute cores per job)Zum Abschätzen der maximal zulässigen Anzahl der Rechenkerne pro Auftrag kann die folgende Gleichung verwendet werden:
Floor((percentageMaxAllowedComputeMemory) * (GB of RAM on a single GeoAnalytics machine) / (number of simultaneous jobs)) = (Maximum allowed memory per job per machine)Hinweis:
Die verwendete Menge an Arbeitsspeicher pro Computer ist für alle GeoAnalytics Server-Computer identisch. Wenn Ihre GeoAnalytics Server-Site mehrere Computer mit unterschiedlicher Menge an Arbeitsspeicher (RAM) enthält, dann verwenden Sie den Wert des Computers mit der geringsten Menge an RAM.
In Beispiel 1 sollen bis zu 80 Prozent der verfügbaren Rechenkerne und des verfügbaren Berechnungsspeichers genutzt werden (siehe Systemeigenschaften). Bei einer Site mit insgesamt 12 CPU-Kernen und 48 GB RAM (16 GB auf jedem Computer) wird über die Menge an Kernen und RAM mit den folgenden Gleichungen entschieden.
- Anzahl der Kerne:
Floor(((.80) * (12))/1) = Floor(9.6) = 9 - Menge an RAM pro Computer:
Floor(((.80) * (16))/1) = Floor(12.8) = 12
Um die in GeoAnalytics Server verfügbaren Ressourcen zu nutzen und Aufgaben auf mehrere Site-Computer zu verteilen, können Sie die Werte wie folgt aktualisieren:
- Maximal zulässiger Speicher pro Auftrag pro Computer (GB): 12
- Maximal zulässige Anzahl der Berechnungskerne pro Auftrag (CPU): 9
Auf diese Weise ist sichergestellt, dass der Auftrag auf die drei Computer der Site verteilt wird und knapp 80 Prozent der verfügbaren Ressourcen auf allen Computern nutzt. Die festgelegte Zuweisung wirkt sich auch auf die Anzahl der Instanzen aus. Hierzu mehr weiter unten.
In Beispiel 2 sollen bis zu 80 Prozent der verfügbaren Rechenkerne und des verfügbaren Rechenspeichers genutzt werden (siehe Systemeigenschaften) und zwei Aufträge gleichzeitig ausgeführt werden können. Das bedeutet, dass die Ressourcen jederzeit für zwei Aufträge festgelegt werden müssen. Bei einer Site mit insgesamt 12 CPU-Kernen und 48 GB RAM (16 GB auf jedem Computer) wird über die Menge an Kernen und RAM mit den folgenden Gleichungen entschieden.
- Anzahl der Kerne:
Floor(((.80) * (12))/2) = Floor(4.8) = 4 - Menge an RAM pro Computer:
Floor(((.80) * (16))1) = Floor(6.4) = 6
Um die in GeoAnalytics Server verfügbaren Ressourcen zu nutzen und Aufgaben auf mehrere Site-Computer zu verteilen, können Sie die Werte wie folgt aktualisieren:
- Maximal zulässiger Speicher pro Auftrag pro Computer (GB): 6
- Maximal zulässige Anzahl der Berechnungskerne pro Auftrag (CPU): 4
Zum Ändern dieser Eigenschaften führen Sie die folgenden Schritte aus:
- Melden Sie sich bei ArcGIS Server Manager auf Ihrem GeoAnalytics Server als Benutzer mit Administratorberechtigungen an. Die URL hat das Format https://gisserver.domain.com:6443/arcgis/manager.
- Wählen Sie auf der Registerkarte Services den Ordner System aus.
- Suchen Sie in der Liste der verfügbaren Services den GeoAnalyticsTools-Service, und wählen Sie ihn zum Bearbeiten aus.
- Auf der Seite Parameter können Sie die Eigenschaften für den Service festlegen. Zu diesen zählen folgende:
- Maximal zulässiger Speicher pro Auftrag pro Computer (GB): Die Arbeitsspeichermenge in Gigabyte, die pro Auftrag und Computer genutzt werden kann.
- Maximal zulässige Anzahl der Berechnungskerne pro Auftrag (CPU): Die Gesamtanzahl der CPU-Kerne, die pro Auftrag auf allen Computern in Ihrem Cluster genutzt werden können.
- Wenn Sie die Einstellungen abgeschlossen haben, klicken Sie auf Speichern und neu starten, um die Service-Eigenschaften zu aktualisieren.
Wenn die ursprünglichen Werte nicht verändert werden, nutzen GeoAnalytics-Aufgaben nur einen Teil der verfügbaren Ressourcen (4 Kerne der 12 verfügbaren Kerne und 18 GB von 48 GB verfügbarem Speicher in der Beispielkonfiguration).
Hinweis:
Achten Sie beim Auswählen der Speichermenge darauf, keinen höheren Wert als den für Computerressourcen definierten Prozentwert (standardmäßig 80 Prozent) festzulegen. Falls doch, dann werden die Aufträge eine Minute lang auf Ressourcen warten, die eigentlich nicht verfügbar sind, um dann mit der folgenden Fehlermeldung abgebrochen zu werden: ERROR BD_101057: Der verteilte Auftrag kann nicht gestartet werden. Überprüfen Sie die Einstellungen des GeoAnalyticsTools-Service, und stellen Sie sicher, dass genügend Ressourcen zur Ausführung des Auftrags verfügbar sind. Diese Fehlermeldung wird auch dann angezeigt, wenn Ressourcen nicht verfügbar sind, weil sie von anderen Aufträgen verwendet werden.
Minimale und maximale Anzahl von Instanzen des GeoAnalyticsTools-Service
Standardmäßig ist als minimale und maximale Anzahl von Instanzen des GeoAnalyticsTools-Service eine pro ArcGIS Server-Computer in der Site festgelegt. Je nach Anzahl der Computer (n) in der GeoAnalytics Server-Site sind (n) Instanzen verfügbar, um GeoAnalytics-Aufträge zu übernehmen. Je nach Anzahl der Instanzen sowie der Menge des Arbeitsspeichers und der Anzahl der CPU-Kerne, die in den Service-Eigenschaften pro Auftrag zugewiesen wurden, können mehrere Anfragen gleichzeitig verarbeitet werden. Zusätzliche Anfragen an GeoAnalytics Tools werden in die Warteschlange eingereiht, bis die Instanz bzw. die Speicher- oder CPU-Ressourcen wieder zur Verfügung stehen. Sollten innerhalb von einer Minute keine Ressourcen verfügbar sein, wird der Auftrag abgebrochen.
Es ist ideal, für Aufträge mit entsprechendem Bedarf die maximale Menge an Arbeitsspeicher und CPU-Kernen zuzuweisen.
Wenn mehrere Aufträge gleichzeitig verarbeitet werden sollen, können Sie die maximale Anzahl von Instanzen bei Bedarf auf mehr als eine pro Computer in der Site erhöhen. Allerdings müssen Sie auch die CPU- und Speicherbeschränkungen pro Auftrag anpassen, damit genügend CPU- und Speicherressourcen für alle parallelen Aufträge zur Verfügung stehen.
Gehen Sie folgendermaßen vor, um die minimale und maximale Anzahl von Instanzen des GeoAnalyticsTools-Service festzulegen:
- Melden Sie sich beim ArcGIS Server-Administratorverzeichnis an. Die URL hat das Format https://gisserver.domain.com:6443/arcgis/admin.
- Wechseln Sie zu Services > System > GeoAnalyticsTools.
- Klicken Sie auf Bearbeiten.
- Bearbeiten Sie die Eigenschaften maxInstancesPerNode und minInstancesPerNode, und klicken Sie dann auf Änderungen speichern.
In dem Beispiel mit drei Computern sind insgesamt drei Instanzen verfügbar, was für die Anwendungsfälle in Beispiel 1 und 2 vollkommen ausreichend ist. Wenn in diesem Szenario mit drei Computern mehr als drei Aufträge parallel ausgeführt werden sollen, müssen Sie nicht nur die CPU- und Speicherbeschränkungen anpassen, sondern auch die Anzahl der Instanzen entsprechend erhöhen.
Die CPU- und Speicherbeschränkungen für alle Instanzen sollten insgesamt geringer sein als die Systembeschränkungen für CPU und Arbeitsspeicher. Der gesamte Arbeitsspeicher pro Knoten multipliziert mit der Anzahl der Instanzen muss weniger betragen als der verfügbare Arbeitsspeicher auf einem einzelnen Computer – hier also (16 GB x 0,80) / 2 Instanzen = 6,4. Das Ergebnis muss zudem eine ganze Zahl sein, in diesem Fall 6. Weiterhin muss die Anzahl an Rechenkernen kleiner sein als die Gesamtanzahl der Prozessorkerne dividiert durch die Anzahl der Instanzen – d. h. (12 Kerne x 0,80) / 2 Instanzen = 4,8 -> 4.
Timeout des GeoAnalyticsTools-Service
Standardmäßig gilt für Aufträge mit langer Laufzeit bei der Verarbeitung durch den GeoAnalyticsTools-Service ein Timeout von 24 Stunden. Sie sollten mithilfe dieser Eigenschaft längere oder kürzere Timeouts für Tools definieren. Gehen Sie folgendermaßen vor, um die Timeout-Eigenschaft für den GeoAnalyticsTools-Service in ArcGIS Server Manager zu bearbeiten.
- Melden Sie sich bei ArcGIS Server Manager an. Die URL hat das Format https://gisserver.domain.com:6443/arcgis/manager.
- Wählen Sie auf der Registerkarte Services den Ordner System.
- Suchen Sie in der Liste der verfügbaren Services den GeoAnalyticsTools-Service, und wählen Sie ihn zum Bearbeiten aus.
- Legen Sie auf der Registerkarte Pooling die Timeout-Eigenschaft für den Service im Abschnitt Service-Timeouts angeben fest. Legen Sie für Die maximale Zeit, die ein Client einen Service verwenden kann einen neuen Wert in Sekunden für die Timeout-Eigenschaft fest.
- Klicken Sie auf Speichern und neu starten, um den Service zu aktualisieren.
GeoAnalytics Server-Speicherort für temporäre Dateien
Wenn ein Task in GeoAnalytics Server ausgeführt wird, werden temporäre Dateien standardmäßig in den Ordner \<ArcGIS Server installation directory>\server\framework\runtime\spark\work> geschrieben. Administratoren können einen alternativen Speicherort für temporäre Dateien auswählen, indem sie mit den folgenden Schritten die Eigenschaft geoAnalyticsTempFolder angeben.
Hinweis:
Der Speicherort geoAnalyticsTempFolder sollte ein lokales Verzeichnis auf jedem Computer der GeoAnalytics Server-Site sein und ausreichend verfügbaren Festplattenspeicher enthalten, damit GeoAnalytics-Tasks mit sehr großen Datasets ausgeführt werden können.
- Melden Sie sich am ArcGIS Server-Administratorverzeichnis auf der GeoAnalytics Server-Site als Benutzer mit Administratorberechtigungen an. Die URL hat das Format http://gisserver.domain.com:6080/arcgis/admin/.
- Wechseln Sie zu System > Eigenschaften.
- Klicken Sie auf Aktualisieren.
- Fügen Sie die Eigenschaft im folgenden JSON-Format hinzu: {"geoanalyticsTempFolder": "<value>"} (z. B. {"geoanalyticsTempFolder": "/data/temp"}). Es kann bis zu einer Minute dauern, bis die Änderungen auf der Seite mit den Systemeigenschaften wirksam geworden sind.
- Überprüfen Sie mit dem Service zum Prüfen der Integrität der Rechenplattform den Zustand Ihres GeoAnalytics Server. Navigieren Sie zu System > Platform Services > Compute_Platform und klicken Sie auf Health.