Nach der Bereitstellung von ArcGIS Enterprise on Kubernetes in Ihrem Kubernetes-Cluster müssen Sie eine ArcGIS Enterprise-Organisation erstellen. Für die Erstellung von Organisationen gibt es zwei Möglichkeiten:
- Ausführung des Setup-Assistenten in einem Browser
- Erstellung der Organisation im Hintergrund über das configure.sh-Skript
Das Konfigurationsskript ist im Bereitstellungspaket enthalten; dieses steht als .tar.gz-Datei auf My Esri zum Download zur Verfügung.
Bei beiden Erstellungsmöglichkeiten passiert Folgendes:
- Herunterladen der Esri Docker-Bilder für ArcGIS Enterprise on Kubernetes
- Bereitstellen von ArcGIS Enterprise on Kubernetes-Containern im ArcGIS Enterprise on Kubernetes-Cluster
- Erstellen einer ArcGIS Enterprise-Organisation
Verwenden des Setup-Assistenten
Führen Sie nach der Bereitstellung von ArcGIS Enterprise on Kubernetes die folgenden Schritte mit dem Konfigurationsassistenten aus, um die Erstellung Ihrer Organisation abzuschließen:
Öffnen Sie den Link Create New Organization in einem Webbrowser. Navigieren Sie zur Load-Balancer-URL, und hängen Sie an die URL den Zusatz /manager an. Wenn der Load Balancer beispielsweise den Kontext arcgis aufweist, öffnen Sie die URL https://organization.example.com/arcgis/manager.
Sie werden dann zum Setup-Assistenten für ArcGIS Enterprise on Kubernetes umgeleitet. Klicken Sie auf Continue, um zu beginnen. Gehen Sie folgendermaßen vor, um den Assistenten abzuschließen:
- Wählen Sie auf der Seite Architecture profiles das Profil aus, das den Anforderungen Ihrer Organisation entspricht, und klicken Sie auf Next.
- Laden Sie auf der Seite Provide license eine ArcGIS Enterprise on Kubernetes-Lizenzdatei hoch, und geben Sie einen Benutzertyp für das primäre Administratorkonto an:
- Wählen Sie die Lizenzdatei aus (eine .json-Datei), die die Benutzertypen und Apps Ihrer Organisation lizenziert. Diese Datei wird von My Esri abgerufen.
- Wählen Sie den Benutzertyp für das primäre Administratorkonto aus, das Sie im nächsten Schritt erstellen werden. Sie können den Benutzertyp des Administrators nach der Erstellung der Organisation im Portal ändern.
- Klicken Sie auf Weiter.
- Erstellen Sie auf der Seite Create administrator account ein primäres Administratorkonto für Ihre ArcGIS Enterprise-Organisation. Geben Sie dabei Benutzername, Kennwort, E-Mail-Adresse, Vor- und Nachname sowie eine Sicherheitsfrage samt Antwort an, und klicken Sie auf Next.
Der Benutzername sollte mindestens aus sechs Zeichen bestehen. Als Sonderzeichen sind nur at-Zeichen (@), Bindestriche (-), Punkte (.) und Unterstriche (_) zulässig.
Das Kennwort sollte mindestens aus acht Zeichen bestehen. Es muss mindestens einen Buchstaben (Groß- oder Kleinschreibung) und eine Ziffer enthalten. Daneben sind sämtliche Sonderzeichen zulässig.
- Geben Sie auf der Registerkarte Set storage information die Speicherinformationen für Ihre Organisation an.
- Wählen Sie für die Bereitstellung persistenter Volumes (PVs) die Option Dynamic oder Static aus.
- Machen Sie bei Auswahl von Dynamic folgende Angaben für die einzelnen Speicherdatenträger:
- Size (required): Geben Sie die erforderliche minimale Größe an. Sollten Sie größere Speicherdatenträger benötigen, können Sie den Wert entsprechend erhöhen.
- Storage class name (required): Geben Sie Ihre eigenen Speicherklassennamen an. Aktivieren Sie optional das Kontrollkästchen, wenn für alle Speicherdatenträger derselbe Speicherklassenname verwendet werden soll.
- Label selector (optional): Wenn Sie die persistenten Volumes beschriften möchten, geben Sie entsprechende Schlüssel-Wert-Paare an.
- Machen Sie bei Auswahl von Static folgende Angaben für die einzelnen Speicherdatenträger:
Hinweis:
Wenn die Bindung an ein vorhandenes PV erfolgt, für das keine Speicherklasse definiert wurde, lassen Sie den Namen der Speicherklasse leer. Wenn eine Standardspeicherklasse im Cluster konfiguriert wurde, fügt der Admission Controller DefaultStorageClass die Standardspeicherklasse hinzu und verhindert die Bindung des PVC. In diesem Fall sollten Administratoren entweder eine Speicherklassenspezifikation zum PV hinzufügen oder die Standardkonfiguration der Speicherklasse entfernen.
- Size (required): Geben Sie die erforderliche minimale Größe an. Sollten Sie Ihren Speicher auf größeren Datenträgern bereitgestellt haben, können Sie den Wert entsprechend erhöhen.
- Storage class name (optional): Wenn Sie eine Speicherklasse festgelegt haben, geben Sie für jeden Datenträger den Speicherklassennamen an. Aktivieren Sie optional das Kontrollkästchen, wenn für alle Speicherdatenträger derselbe Speicherklassenname verwendet werden soll.
- Label selector (required): Definieren Sie Beschriftungen, indem Sie die entsprechenden Schlüssel-Wert-Paare eingeben. Beispiele für Beschriftungen finden Sie in den Systemanforderungen.
- Machen Sie bei Auswahl von Dynamic folgende Angaben für die einzelnen Speicherdatenträger:
- Auf der Registerkarte Set user managed storage können Sie optional einen registrierten Datenordner oder mehrere Ordner für Ihre Organisation angeben. Sobald die Organisation verwendet wird, können Mitglieder mit Berechtigungen zum Veröffentlichen Elemente erstellen, die die Daten innerhalb dieser registrierten Speicherorte direkt referenzieren.
- File server host name : Geben Sie den Namen des Computers an, auf dem freigegebene Daten gespeichert und über einen NFS-Pfad (Network File System) aufgerufen werden.
- File server shared path: Geben Sie einen NFS-Pfad auf dem Hostcomputer an, auf dem freigegebene Daten gespeichert und innerhalb der Organisation abgerufen werden können.
- Client path: Geben Sie einzelne (Laufwerke oder freigegebene) Speicherorte an, über die Clients wie ArcGIS Pro Quelldaten abrufen und veröffentlichen können.
Wenn Sie mehrere Pfade registrieren möchten, klicken Sie auf Add more paths, geben Sie den Hostnamen, den freigegebenen Pfad und den Client-Pfad an, und wiederholen Sie den Vorgang gegebenenfalls.
Hinweis:
Es wird dringend empfohlen, Ordner in diesem Schritt zu registrieren, da eine Registrierung zu einem späteren Zeitpunkt mit Systemausfällen verbunden sein kann.
- Klicken Sie auf Weiter.
Auf der Seite Configuration summary sehen Sie eine Zusammenfassung der Konfigurationsdetails.
- Wählen Sie für die Bereitstellung persistenter Volumes (PVs) die Option Dynamic oder Static aus.
- Sehen Sie sich die einzelnen Elemente an, und klicken Sie auf Finish, um das Setup zu starten.
Während der Ausführung des Assistenten wird der aktuelle Konfigurationsstatus angezeigt.
Verwenden des Konfigurationsskripts
Als Alternative zur Erstellung mit dem Assistenten können Sie eine Organisation auch im Hintergrund erstellen. Führen Sie dazu nach der Bereitstellung von ArcGIS Enterprise on Kubernetes das configure.sh-Skript aus.
Hinweis:
Es wird empfohlen, das Werkzeug password-encrypt.sh auszuführen, um verschlüsselte Kennwörter für die Verwendung in der configure.properties-Datei zu generieren.Ausführen des Skripts
Das configure.sh-Skript steht unter My Esri als .tar.gz-Datei zum Download bereit. Es wird gebündelt mit einer configure.properties-Datei, die einen Satz von Parametern bereitstellt, welche zu eindeutigen Eingaben für die ArcGIS Enterprise-Organisation auffordern, sowie einem password-encrypt.sh-Werkzeug, das zum Generieren AES-256-verschlüsselter Kennwörter verwendet wird.
Das Skript configure.sh führt die folgenden Aktionen aus:
- Überprüfen der Parameter in der configure.properties-Datei auf Gültigkeit
- Erstellen eines Speicher-JSON basierend auf den in der configure.properties-Datei bereitgestellten Speichereigenschaften
- Erstellen einer ArcGIS Enterprise-Organisation
Hinweis:
Die zur Werkzeugausführung verwendete Client-Workstation muss Zugriff auf https://<FQDN>/<context>/admin haben.
Gehen Sie wie folgt vor, um das Skript auszuführen:
- Öffnen Sie auf dem Kubernetes-Client-Computer eine Terminalsitzung als Administrator.
- Navigieren Sie zu <ArcGIS Enterprise on Kubernetes install directory>/tools/configure.
- Öffnen Sie die Datei configure.properties.
- Geben Sie Werte für jeden in der Datei aufgeführten Parameter an. Die Datei ist in die folgenden Abschnitte unterteilt:
- Architekturprofil
- Organisation
- Lizenz
- Verschlüsselungs-Schlüsseldatei
- Administratorkonto
- Protokolleinstellungen
- Speicher
- Speichern Sie die Datei. Benennen Sie die Datei bei Bedarf um.
- Führen Sie im Terminal das Konfigurationsskript mit dem folgenden Befehlsformat aus:
./configure.sh [options] -f <user_properties>
- Sie haben die Möglichkeit, im Rahmen des Konfigurationsskripts optionale Schritte auszuführen, beispielsweise die Registrierung benutzerverwalteter Data Stores. Wenn Sie sich für die Registrierung eines benutzerverwalteten Data Store entscheiden, müssen Sie für Ihre Organisation einen oder mehrere Datenordner in einer .json-Datei angeben, die das folgende Format hat:
Hinweis:
Die unten stehende Beispiel-JSON-Datei enthält die Details für eine Netzwerkdateifreigabe mit einem Client-Pfad, der auf eine Netzwerkfreigabe verweist, sowie für eine Netzwerkdateifreigabe mit einem Client-Pfad, der auf ein lokales Laufwerk verweist.
[ { "clientPath": "\\\\sample_server\\SharedPath\\Data", "type": "folder", "info": { "fileServerHost": "nfsHost.domain.com", "fileServerType": "nfs", "fileServerPath": "/SharedPath/Data" } }, { "clientPath": "C:\\data", "type": "folder", "info": { "fileServerHost": "nfsHost.domain.com", "fileServerType": "nfs", "fileServerPath": "/data", "hostName": "yourclienthost.domain.com" } } ]
- Sie müssen den Pfad ebenfalls an das Befehlsformat in der .json-Datei anhängen. Gehen Sie dazu folgendermaßen vor:
% ./configure.sh -f my.properties -u /path/to/my_data_stores.json
- Sie haben die Möglichkeit, im Rahmen des Konfigurationsskripts optionale Schritte auszuführen, beispielsweise die Registrierung benutzerverwalteter Data Stores. Wenn Sie sich für die Registrierung eines benutzerverwalteten Data Store entscheiden, müssen Sie für Ihre Organisation einen oder mehrere Datenordner in einer .json-Datei angeben, die das folgende Format hat:
Der Inhalt von <user properties> wird aus der configure.properties-Datei abgeleitet.
Wenn das Skript ausgeführt wurde, sehen Sie eine Zusammenfassung der Konfigurationsdetails, und Sie werden gefragt, ob Sie die Ausführung des Skripts fortsetzen möchten.
- Wenn Sie "y" für "Ja" angeben, wird die Ausführung des Skripts fortgesetzt, und es wird eine Organisation erstellt. Dies ist die Standardeingabe, die vom Skript vorausgesetzt wird.
- Wenn Sie "n" für "Nein" angeben, wird die Ausführung des Skripts sofort beendet, und es wird keine Organisation erstellt.