Verbinden zusätzlicher Computer mit einer ArcGIS Notebook Server-Site (Linux-Container)

Ab ArcGIS Notebook Server 10.7.1 werden Sites mit mehreren Computern unterstützt. In einer Site mit mehreren Computern wird jeder Computer mit identischen Docker-Setups gleich konfiguriert. Zudem kann auf jedem Computer ArcGIS Notebooks ausgeführt werden.

Ab Version 10.9 unterstützt ArcGIS Notebook Server mehrlizenzfähige Sites, was bedeutet, dass nicht mehr für alle Computer in einer Site dieselbe Lizenzstufe erforderlich ist. Sie können zum Beispiel eine Site für drei Computer einrichten, wobei ein Computer mit einer Advanced-Lizenz und zwei mit Standard-Lizenzen ausgestattet sein kann. Vor Version 10.9 war für alle Computer dieselbe Lizenzstufe erforderlich (d. h. entweder Advanced oder Standard). Die mit Version 10.9 eingeführte Mehrlizenzfähigkeit ermöglicht die Skalierung, sodass eine unterschiedliche Anzahl von Computern mit Advanced- oder Standard-Lizenz hinzugefügt werden kann.

Vorversion:

In Version 10.7 wurden nur Sites mit einem Computer unterstützt.

ArcGIS Notebook Server-Sites mit mehreren Computern ermöglichen die Unterstützung weiterer gleichzeitiger Notebook-Benutzer. Wenn Sie viele aktive Benutzer haben oder die Ressourcen des einzelnen Computers für die Anforderungen der Benutzer nicht ausreichen, kann die Erweiterung auf eine Site mit mehreren Computern von Vorteil sein.

Hinweis:

Gibt es wenige Notebook-Benutzer, die weitere Computerressourcen benötigen, können Sie eine Änderung der Ressourcenbegrenzung Ihrer Website als eingeschränkte Alternative zum Hinzufügen von Computern in Betracht ziehen.

Auf allen Computern in einer ArcGIS Notebook Server-Site wird dieselbe Software in derselben Version installiert. Auf dem ersten Computer, den Sie einrichten, müssen Sie die ArcGIS Notebook Server-Site erstellen. Anschließend können Sie weitere ArcGIS Notebook Server-Computer mit der Site verbinden.

Hinweis:

Anders als bei ArcGIS Server-Rollen unterstützt ArcGIS Notebook Server nicht das Hinzufügen weiterer Computer zu einer Site vom ersten Computer aus. Sie müssen mit dem ArcGIS Notebook Server-Konfigurationsassistenten oder dem Dienstprogramm joinsite nacheinander auf jeden Computer zugreifen und ihn mit der Site verbinden.

Vor der Installation

Wenn Sie eine Site erstellen, legen Sie fest, wo der Konfigurationsspeicher gespeichert werden soll. Hierbei handelt es sich um ein Verzeichnis, das die kritischen Dateien und Konfigurationsinformationen für die Site hostet. Die Site verfügt auch über die Serververzeichnisse system und workspace.

Wenn Sie eine ArcGIS Notebook Server-Site erstellen, geben Sie Speicherorte für den Konfigurationsspeicher und die Serververzeichnisse an. In einer Umgebung mit mehreren Computern müssen Sie den Konfigurationsspeicher und die Serververzeichnisse freigeben, sodass die anderen Computer darauf zugreifen können. Jedem Computer, der mit der Site verbunden wird, müssen Lese- und Schreibberechtigungen für diese Speicherorte erteilt werden.

Installieren und Konfigurieren einer Site mit mehreren Computern

Wenn Sie eine ArcGIS Notebook Server-Site mit mehreren Computern einrichten möchten, müssen Sie zusätzliche Schritte in dieser Installationsanweisung befolgen.

1. Überprüfen Sie die Systemanforderungen für ArcGIS Notebook Server, um sicherzustellen, dass alle Computer qualifiziert sind. Passen Sie auf allen Computern die Firewalls so an, dass sie Port 11443 für die Kommunikation über jeden Computer in der ArcGIS Enterprise-Bereitstellung öffnen.

   Achten Sie darauf, dass Sie auf beiden Computern den gleichen Betriebssystembenutzer verwenden. Das für die Installation von ArcGIS Notebook Server verwendete Benutzerkonto ist das Konto, das zum Ausführen der Software verwendet wird. Gruppen- und alle anderen Benutzer müssen mindestens über Ausführungsberechtigungen für das Installationsverzeichnis von ArcGIS Notebook Server verfügen. Beachten Sie, dass die Installation von ArcGIS Notebook Server mit dem Root-Konto nicht unterstützt wird. Zum Beispiel könnte das für die Installation auf zwei Computern verwendete Benutzerkonto folgendermaßen aussehen:

   1. Installieren Sie ArcGIS Notebook Server auf dem ersten Computer unter /data/ags als Benutzer AGS mit der Benutzer-ID 58103.
   2. Installieren Sie ArcGIS Notebook Server auf dem zweiten Computer unter /data/ags mit dem gleichen Benutzernamen und der gleichen ID (AGS, Benutzer-ID 58103).
2. Stellen Sie sicher, dass Sie während der Installation bis zu diesem Punkt folgende Aufgaben ausgeführt haben:
   1. Installieren Sie Docker auf allen Computern. Laden Sie auf jedem Computer die von Esri bereitgestellten Docker-Images herunter, und speichern Sie sie an einem Speicherort, auf den das System zugreifen kann.
   2. Installieren und autorisieren Sie ArcGIS Notebook Server auf jedem Computer. Sie können auch eine automatische Installation der Software durchführen.
   3. Führen Sie auf jedem Computer das Befehlszeilendienstprogramm "PostInstaller" aus, das unter <ArcGIS Notebook Server installation directory>/tools/postInstallUtility liegt, um die Docker-Images in das lokale Repository zu laden.
   4. Führen Sie die Schritte zum Konfigurieren von ArcGIS Notebook Server nach der Installation aus.
3. Erstellen Sie zwei Verzeichnisse im Netzwerk, geben Sie diese frei, und geben Sie den Installationsbenutzer als Besitzer an. Eines wird für den Konfigurationsspeicher und das andere für die Serververzeichnisse verwendet. Sie müssen den Ordnern mindestens 700 Berechtigungen erteilen.

   Hinweis:

   Freigegebene Netzwerkverzeichnisse, die ausgeblendet sind oder Sonderzeichen verwenden (z. B. $) werden von ArcGIS Notebook Server nicht unterstützt.

   Beispiel:
   1. Erstellen Sie ein Verzeichnis mit der Bezeichnung config-store. Legen Sie als Besitzer AGS mit der Benutzer-ID 58103 fest. Erteilten Sie mindestens 700 Berechtigungen für das Verzeichnis.
   2. Geben Sie den Ordner "config-store" frei, sodass beide Computer über den gleichen Pfad, z. B. /net/myserver/config-store, darauf zugreifen können.
   3. Erstellen Sie ein Verzeichnis mit der Bezeichnung arcgisnotebookserver. Legen Sie als Besitzer AGS mit der Benutzer-ID 58103 fest. Erteilten Sie mindestens 700 Berechtigungen für das Verzeichnis.
   4. Geben Sie den Ordner "arcgisnotebookserver" frei, sodass beide Computer über den gleichen Pfad, z. B. /net/myserver/arcgisnotebookserver, darauf zugreifen können.

      Auch wenn sich die Verzeichnisse auf dem Computer befinden, den Sie zur Erstellung der Site verwenden, müssen Sie dennoch die Verzeichnisse manuell erstellen und freigeben und sie über einen Netzwerkpfad referenzieren.

4. Erstellen Sie auf einem der Computer eine neue ArcGIS Notebook Server-Site. Stellen Sie sicher, dass Sie die Pfade für die Serververzeichnisse und den Konfigurationsspeicher verwenden, die Sie zuvor eingerichtet haben.
5. Wenn Sie die vorherigen Schritte abgeschlossen haben, können Sie jeden zusätzlichen Computer mit dem Konfigurationsassistenten mit der von Ihnen erstellten Site verbinden. Wenn Sie die Computer über die Befehlszeile mit der Site verbinden möchten, finden Sie entsprechende Informationen in Schritt 6.
   1. Öffnen Sie auf dem ersten zusätzlichen Computer den ArcGIS Notebook Server-Konfigurationsassistenten.
   2. Überprüfen und befolgen Sie die Anweisungen im Assistenten, und klicken Sie auf Continue.
   3. Klicken Sie auf Join Existing Site.
   4. Geben Sie die Site-URL und die Anmeldeinformationen für die ArcGIS Notebook Server-Site wie in Schritt 4 erstellt ein.
   5. Wiederholen Sie die Teilschritte a bis d für jeden zusätzlichen Computer, den Sie mit der Site verbinden möchten.
6. Alternativ zum Konfigurationsassistenten können Sie einen Computer wie folgt über ein Befehlszeilendienstprogramm zur Site hinzufügen:
   1. Stellen Sie sicher, dass Sie bei dem Computer mit dem ArcGIS Notebook Server-Konto angemeldet sind.
   2. Öffnen Sie eine Eingabeaufforderung, und führen Sie das Dienstprogramm aus, das sich unter <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh befindet. Die Befehlszeilenparameter für das Dienstprogramm lauten wie folgt:

      Parameter	Beschreibung
      -u oder --username	Der Benutzername des primären Site-Administrators. Der Benutzername darf keines der folgenden Zeichen enthalten: \/:*?|<>
      -p oder --password	Das Kennwort für den primären Site-Administrator. Das Kennwort darf keines der folgenden Zeichen enthalten: \/:*?|<>
      -f oder --file	Die Verbindungsdatei des Konfigurationsspeichers für das Dienstprogramm joinsite.
      -s oder --siteUrl	Die URL der vorhandenen ArcGIS Notebook Server-Site, mit der Computer verbunden werden sollen, im Format https://notebookserver.domain.com:11443.
      -h oder --help	Die Hilfe für die Befehlszeile wird angezeigt und beendet.

      Ein Beispielbefehl für das Dienstprogramm:

      <ArcGIS Notebook Server install directory>/tools/JoinSiteUtility/joinsite.sh -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443

      Wenn die Kontoanmeldeinformationen und die Site-URL richtig eingegeben werden, verbindet das Dienstprogramm den Computer mit der ArcGIS Notebook Server-Site. Wiederholen Sie diese Schritte für jeden zusätzlichen Computer.

Wenn alle Computer mit der Site verbunden sind, ist der verbleibende Einrichtungsprozess identisch mit dem für Sites mit einem Computer. Fahren Sie mit der Installation und Konfiguration von ArcGIS Web Adaptor auf Ihrer Site fort. Im nächsten Schritt konfigurieren Sie die Site mit dem ArcGIS Enterprise-Portal.

Verwenden der Befehlszeile zum Verbinden mit einer Site

Sie können den Computer einer joinSite-Site auch mithilfe des Befehlszeilendienstprogramms ArcGIS Notebook Server hinzufügen. Dieses Dienstprogramm erfordert, dass Sie den Speicherort des Konfigurationsspeichers für die vorhandene Site angeben, nicht deren URL. Das Dienstprogramm eignet sich daher für Fälle, in denen die Verwendung der URL die Warteschlange der Netzwerkanfragen für die Site verstopfen würde. Sie sollten die Verwendung dieses Dienstprogramms in Erwägung ziehen, wenn die Computer Ihrer ArcGIS Notebook Server-Site bereits mit Netzwerkanfragen überlastet sind oder wenn Sie zahlreiche Computer auf einmal mit Ihrer Site verbinden möchten.

Das Dienstprogramm join-site ist im Verzeichnis \tools\JoinSiteUtility des ArcGIS Notebook Server-Installationsverzeichnisses installiert. Führen Sie das Dienstprogramm für Site-Verbindungen auf dem ArcGIS Notebook Server-Computer aus, der einer vorhandenen Site hinzugefügt werden soll, wobei Sie das Run As-Konto für ArcGIS Notebook Server verwenden.

1. Erteilen Sie dem Netzwerkkonto, mit dem der ArcGIS Notebook Server-Service auf den Computern ausgeführt wird, die der Site hinzugefügt werden sollen, Lese- und Schreibzugriff auf den Konfigurationsspeicherordner der vorhandenen Site.
2. Erstellen Sie eine JSON-Datei (JavaScript Object Notation) namens connection.json.
3. Fügen Sie der Datei die folgende Zeile hinzu, und ersetzen Sie dabei <path to the configuration store> durch den Speicherort des Konfigurationsspeichers der vorhandenen ArcGIS Server-Site:

   {"configPersistenceType": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

   In diesem Beispiel lautet der Pfad zum Konfigurationsspeicher der vorhandenen Site /net/mymachine/data/arcgisnotebookserver/usr/config-store:

   {"connectionString": "/net/mymachine/data/arcgisnotebookserver/usr/config-store", " configPersistenceType": "FILESYSTEM" }

4. Speichern und schließen Sie die connection.json-Datei.
5. Speichern Sie die connection.json-Datei auf dem Computer, der der Site hinzugefügt werden soll, oder in einem freigegebenen Verzeichnis, auf das Sie von dem betreffenden Computer aus zugreifen können.
6. Öffnen Sie eine Eingabeaufforderung, und führen Sie join-site aus.
Folgende Syntax wird verwendet:
joinSite -f <The file path to the configuration store JSON file>
In diesem Beispiel wird angenommen, dass sich die Konfigurationsspeicher-JSON-Datei (connection.json) in demselben Verzeichnis befindet wie das Werkzeug join-site (\tools\JoinSiteUtility).
joinsite.bat -f connection.json

Der Computer wird der ArcGIS Notebook Server-Site hinzugefügt.