ArcGIS Data Pipelines Server-Administratorvorgänge
In den folgenden Abschnitten werden die Werkzeuge und Eigenschaften beschrieben, die ArcGIS Data Pipelines Server-Administratoren zur Verfügung stehen. Jedes Werkzeug oder jede Eigenschaft ist zusammen mit dem entsprechenden Pfad aufgeführt. Die im Installationsverzeichnis verfügbaren Werkzeuge finden Sie unter <ArcGIS Data Pipelines Server install directory>\tools, und Vorgänge, die sich auf der ArcGIS Data Pipelines Server-Verwaltungs-Site befinden, finden Sie, indem Sie die URL https://machine.domain.com:14443/arcgis/admin aufrufen.
Aktualisieren von Systemeigenschaften
Administratoren können die Eigenschaften von ArcGIS Data Pipelines Server für ihre Organisation anpassen. Benutzerdefinierte Eigenschaftswerte können unter https://machine.domain.com:14443/arcgis/admin/system/properties/update festgelegt werden. Die folgenden Eigenschaften sind für die Konfiguration verfügbar:
maxWorkersPerMachine: Verwenden Sie diese Eigenschaft, um die Anzahl der Worker, die gleichzeitig aktiv sein können, zu erhöhen oder zu verringern. Worker sind die Rechenressourcen, die dem Data Pipelines-Editor, geplanten Task-Ausführungen und eigenständigen Data-Pipeline-Ausführungen zugewiesen sind.maxMemoryPerWorkerInMiB: Verwenden Sie diese Eigenschaft, um den Arbeitsspeicher, den jeder Worker verwenden kann, zu erhöhen oder zu verringern. Wenn Sie z. B. große Datenmengen verarbeiten, müssen Sie diesen Wert möglicherweise erhöhen, damit die Ausführungen erfolgreich abgeschlossen werden können.reservedInteractiveWorkersPerMachine: Verwenden Sie diese Eigenschaft, um die Anzahl der Worker, die für die interaktive Erstellung im Data Pipelines-Editor reserviert sind, zu erhöhen oder zu verringern. Wenn Sie beispielsweise über eine ArcGIS Data Pipelines Server-Site mit einem Computer verfügen undmaxWorkersPerMachineauf6festgelegt ist, sind standardmäßig zwei dieser Worker speziell für die Arbeit im Data Pipelines-Editor reserviert, und vier stehen für geplante Task-Ausführungen und eigenständige Data-Pipeline-Ausführungen zur Verfügung.allowedHosts: Mit dieser Eigenschaft können Sie angeben, welche Hosts zum Einlesen von Daten verwendet werden können, wenn die URL-Eingabe verwendet wird. Der Standardwert ist "Keine" (""). Es wird empfohlen, eine Liste von Hosts anzugeben, auf die Lesezugriff gewährt werden soll. Geben Sie z. B. die Hosts wie folgt in einer Liste an:
"allowedHosts": "exampleHost.com, mydata.org, www.test.ca"
Um Benutzern das Lesen von Daten von allen Hosts zu ermöglichen, geben Sie den Platzhalterwert `(.*)` an. Verwenden Sie Platzhalter (`*`) mit Vorsicht, da sie Benutzern die Möglichkeit geben, Daten von jedem Host zu lesen. Um zum Beispiel das Lesen von allen Hosts zu ermöglichen, geben Sie Folgendes an:
`"allowedHosts": "(.*)"`
Wenn eine URL zu einem anderen Host umgeleitet wird, müssen beide Hosts in der Liste der zulässigen Hosts angegeben sein.
allowedFileSharePaths: Verwenden Sie diese Eigenschaft, um anzugeben, welche Dateifreigabepfade über die Dateifreigabe-Eingabe zugänglich sind. Standardmäßig stehen alle Dateifreigaben, die über das ArcGIS Data Pipelines Server-Konto zugänglich sind, in der Dateifreigabe-Eingabe zur Verfügung. Einige Verzeichnisse sind immer eingeschränkt, darunter Installationsverzeichnisse sowie systemverwaltete oder vom Betriebssystem geschützte Verzeichnisse.Um beispielsweise den Zugriff auf zwei verschiedene Netzwerkfreigaben zu ermöglichen, geben Sie die folgende Eigenschaft an:
"allowedFileSharePaths": [ "\\\\network_path\\my_data", "\\\\other_network_path\\my_other_data"]"allowedFileSharePaths": [ "/net/my_network/my_data", "/other_network_path/my_other_data"]Um den Zugriff auf alle Dateifreigaben zu blockieren, geben Sie eine leere Liste (
[]) wie folgt an:"allowedFileSharePaths": []Hinweis:
Für ArcGIS Data Pipelines Server-Sites mit einem Computer werden lokale Laufwerke wie
c:\unterstützt. Für Sites mit mehreren Computern werden lokale Laufwerke nicht unterstützt. Sie müssen freigegebene Netzwerkpfade nutzen, die für alle Computer auf der Site zugänglich sind.
Importieren eines vorhandenen Serverzertifikats
Um ein vorhandenes Serverzertifikat zu importieren, klicken Sie auf Home > Machines > MachineName > sslCertificates > importExistingServerCertificate.
Damit wird ein vorhandenes Serverzertifikat in den Keystore importiert. Wenn es sich bei dem Zertifikat um ein signiertes Zertifikat einer Zertifizierungsstelle (CA) handelt, müssen Sie mit der Operation "importRootOrIntermediate" zunächst das Stamm- oder Zwischenzertifikat der Zertifizierungsstelle importieren.
Importieren eines Stammzertifikats
Um ein Stammzertifikat zu importieren, klicken Sie auf Home > Machines > MachineName > sslCertificates > importRootOrIntermediate.
Damit werden die Stamm- und Zwischenzertifikate einer Zertifizierungsstelle in den Keystore importiert. Um ein von einer Zertifizierungsstelle signiertes Zertifikat in Produktionsqualität zu erstellen, fügen Sie dem Keystore die Zertifikate der Zertifizierungsstelle hinzu, sodass der SSL-Mechanismus der Zertifizierungsstelle (und den von dieser signierten Zertifikaten) vertrauen kann. Die meisten gängigen Zertifikate der Zertifizierungsstelle sind bereits im Keystore vorhanden. Mit diesem Vorgang können Sie jedoch eine benutzerdefinierte Zertifizierungsstelle oder bestimmte Zwischenzertifikate verwenden.
Aktualisieren der Sicherheitskonfiguration
Klicken Sie zum Aktualisieren der Sicherheitskonfiguration auf Home > Security > SecurityConfig > UpdateSecurityConfig.
Damit wird die Sicherheitskonfiguration, einschließlich der TLS-Protokolle und Verschlüsselungssammlungen, für die ArcGIS Data Pipelines Server-Site aktualisiert. Durch diese Operation werden die REST-Service-Endpunkte auf jedem Servercomputer in der Site erneut bereitgestellt. Wenn Sie im Rahmen dieses Vorgangs das Kommunikationsprotokoll aktualisiert haben, dauert es eine Minute, bis Änderungen am Kommunikationsprotokoll der Site von ArcGIS Web Adaptor erkannt werden.
Aufheben der Registrierung eines Computers von der Site
Bevor Sie einen ArcGIS Data Pipelines Server-Computer von einer Site entfernen, sollten Sie Folgendes bedenken:
Wenn aktive Rechenressourcen auf dem von Ihnen entfernten Computer ausgeführt werden, werden diese beendet und der Fortschritt für laufende Data Pipelines geht verloren. Es wird empfohlen, zu warten, bis alle Prozesse abgeschlossen sind, oder sie aktiv zu beenden, bevor Sie einen Computer von der Site entfernen. Um Rechenressourcen in der Data Pipelines-App aktiv zu beenden, müssen alle Benutzer die Verbindung vom Editor trennen und aktive Task-Ausführungen abbrechen.
Um Rechenressourcen aktiv mit der REST API zu beenden, navigieren Sie zu
https://machine.domain.com:14443/arcgis/rest/services/datapipelines/computeresources/<compute resource id>, und klicken Sie aufterminate. Für Rechenressourcen mit demMODE-WertINTERACTIVEwerden beim Beenden alle Verbindungen zu verbundenen Editoren getrennt, die mit der Rechenressource verbunden sind. Für Rechenressourcen mit demMODE-WertJOBwird beim Beenden die zugehörige Ausführung abgebrochen.Nach dem Entfernen eines Computers von der Site wird empfohlen, den Service des ArcGIS Data Pipelines Servers zu beenden und den Computer herunterzufahren oder neu zu starten. Durch diese Schritte wird sichergestellt, dass keine ArcGIS Data Pipelines Server-Prozesse mehr ausgeführt werden.
Wenn ein Web Adaptor bei einer Site registriert ist, kann es etwas dauern, bis der Web Adaptor erkennt, dass ein Computer gelöscht wurde. Der Web Adaptor überprüft standardmäßig jede Minute, ob Computer zur Site hinzugefügt oder von der Site gelöscht wurden. Je nachdem, wann ein Computer gelöscht wurde, erkennt Web Adaptor den gelöschten Computer beispielsweise erst bei der nächsten Überprüfung der Site. Während dieses Intervalls werden Anforderungen weiterhin an den gelöschten Computer weitergeleitet. Dies kann dazu führen, dass Anforderungen fehlschlagen und keine Ereignisse in die Serverprotokolle geschrieben werden.
Zur Vermeidung dieses potenziellen Problems können Sie die Erkennung des gelöschten Computers durch den Web Adaptor erzwingen, indem Sie ihn neu konfigurieren. Anweisungen hierzu finden Sie unter Installieren und Konfigurieren von ArcGIS Web Adaptor für ArcGIS Data Pipelines Server.
Wenn sich lediglich ein ArcGIS Data Pipelines-Computer in der Site befindet, den Sie löschen möchten, wird die Site ebenfalls gelöscht und Sie kehren zu einer Seite zurück, auf der Sie gefragt werden, ob Sie eine Site erstellen oder eine Verbindung zu einer vorhandenen Site herstellen möchten. Beachten Sie, dass vorhandene Services und Einstellungen im Konfigurationsspeicher beibehalten werden. Wenn Sie die Site auf einem anderen Computer neu erstellen möchten, verweisen Sie beim Erstellen der Site auf den vorhandenen Konfigurationsspeicher.
Um die Registrierung eines Computers von einer Site aufzuheben, klicken Sie auf Home > Machines > Machine name > unregister.
Löschen einer Site
Klicken Sie zum Löschen einer Site auf Home > Delete Site.
Damit wird die Site-Konfiguration gelöscht, und sämtliche Serverressourcen werden freigegeben. Dieser Vorgang eignet sich für die Entwicklung oder zum Testen von Servern, die regelmäßig bereinigt werden müssen, und kann auch vor der Deinstallation durchgeführt werden. Verwenden Sie diese Option mit Bedacht, da alle Einstellungen und sonstigen Konfigurationen gelöscht werden und der Vorgang nicht rückgängig gemacht werden kann.
Mit dieser Operation werden die folgenden Tasks ausgeführt:
Alle zu der Site gehörigen Servercomputer werden angehalten.
Die Registrierung bei der Site wird für alle Servercomputer aufgehoben.
Der Konfigurationsspeicher wird gelöscht.
Konfigurieren von ArcGIS Web Adaptor
Um ArcGIS Web Adaptor zu konfigurieren, klicken Sie auf Home > System > Web Adaptors > Configuration.
Die ArcGIS Web Adaptor-Konfiguration ist eine Ressource für sämtliche Konfigurationsparameter, die für alle Web Adaptors in der Site verwendet werden. Mit dieser Ressource wird der freigegebene Schlüssel identifiziert, der von allen Web Adaptors zur Verschlüsselung wichtiger Daten-Bits in den eingehenden Anforderungen für den Server verwendet wird.
Sichern der Site
Es wird empfohlen, die Site-Einstellungen regelmäßig über die Admin-API zu exportieren. Navigieren Sie dazu zu Home > Export Site. Beim Definieren der Eigenschaft destination für die exportierte Site wird empfohlen, dass der Speicherort ein Netzlaufwerk oder ein anderer Speicherort als der ArcGIS Data Pipelines Server-Computer selbst ist. Das Ziel muss ein Speicherort sein, auf den der ArcGIS Data Pipelines Server-Computer zugreifen kann. Bei einem Site-Ausfall kann die Site wiederhergestellt werden, indem Sie eine neue Server-Site erstellen und zu Home > Import Site navigieren.
Hinweis:
Wenn eine ArcGIS Data Pipelines Server-Site mit mehreren Computern ausfällt, muss die Site nur einmal wie oben beschrieben importiert werden. Anschließend können andere ArcGIS Data Pipelines Server-Computer wie üblich mit der Site verbunden werden.
Bearbeiten der Protokolleinstellungen
Klicken Sie zum Bearbeiten der Protokolleinstellungen auf Home > Logs > Settings > Edit.
Mit dieser Prozedur werden die Protokolleinstellungen für die gesamte Server-Site, z. B. das Protokollausgabeverzeichnis, das Protokoll-Level und das Protokollformat sowie das Alter der Protokolldatei, aktualisiert.