Automatisches Installieren von Portal for ArcGIS unter Linux

Die folgenden Schritte führen Sie durch die automatische Installation von Portal for ArcGIS.

Hinweis:

Wenn Sie ein Upgrade auf 10.9 durchführen, finden Sie weitere Informationen unter Upgrade des ArcGIS Enterprise-Portals.

Vorbereiten der Installation von Portal for ArcGIS

1. Überprüfen Sie, ob Ihre Site die minimalen Systemanforderungen erfüllt.
2. Melden Sie sich am Computer als Benutzer mit Administratorberechtigungen an. Sie können Portal for ArcGIS nicht als Root-Benutzer installieren.
3. Öffnen Sie die Ports, wie unter Von Portal for ArcGIS verwendete Ports beschrieben.
4. Schließen Sie alle nicht kritischen Anwendungen auf dem Server.
5. Navigieren Sie zu dem heruntergeladenen Ordner, der das Installationsprogramm für Portal for ArcGIS enthält, oder legen Sie das Portal for ArcGIS-Medium in das entsprechende Laufwerk ein, um das Installationsprogramm automatisch zu starten.

Jetzt können Sie mit der Installation von Portal for ArcGIS beginnen.

Automatisches Installieren von Portal for ArcGIS unter Linux

1. Lesen Sie die Lizenzvereinbarung unter <CD_ROOT or untar directory>/Documentation/EULA.pdf, und stimmen Sie den Bedingungen zu.
2. Führen Sie das Setup-Programm automatisch über die Eingabeaufforderung aus. Siehe Syntaxbeispiel unten:

   <CD_ROOT or untar directory>/Setup -m silent -l yes

   Verwendung: Installation [Optionen]

   Option	Beschreibung
   -m; --mode MODE	Optional. Standard: GUI. MODE ist eine der folgenden Optionen: silent, console oder gui.
   -l; --license-agreement CHOICE	Für automatischen Modus erforderlich. CHOICE kann "Yes" oder "No" sein. "Yes" gibt an, dass Sie die Esri Lizenzvereinbarung gelesen haben und ihr zustimmen (E204, E300). Rufen Sie http://www.esri.com/legal/licensing-translations auf, um die Vereinbarung zu lesen.
   -d; --directory DIRECTORY	Optional. Standardmäßig wird Portal for ArcGIS im Verzeichnis "$HOME" des Benutzers installiert. DIRECTORY steht für ein anderes Installationsverzeichnis. Der Pfad "/arcgis/portal" wird an das Installationsverzeichnis angehängt. Wenn Sie die Installation auf ein vorheriges Installationsverzeichnis verweisen, wird der Inhalt in diesem Verzeichnis automatisch in der neuen Installation verwendet. Inhalte aus Installationen vor Version 10.2 werden nicht unterstützt.
   -v; --verbose	Das Installationsprogramm wird im ausführlichen Modus ausgeführt.
   -h; --help	Die Hilfe für die Befehlszeile wird angezeigt und beendet.
   -e; --examples	Verwendungsbeispiele für diese Optionen werden angezeigt und beendet.

   Hinweis:

   Sie können ebenfalls das Befehlszeilendienstprogramm createportal verwenden, um ein neues Portal zu erstellen, nachdem Portal for ArcGIS installiert wurde.

Verwenden des Befehlszeilendienstprogramms "createportal" zum Erstellen eines Portals

Sie können das Dienstprogramm createportal auf folgende Arten verwenden:

• Führen Sie das Dienstprogramm createportal als Administrator über die Befehlszeile aus, wobei Sie den Vornamen, den Nachnamen, den Benutzernamen, das Kennwort, die E-Mail-Adresse, die geheime Frage, die Antwort und die Parameter für das Inhaltsverzeichnis angeben.
• Geben Sie eine createportal.properties-Datei an, die die festgelegten Parameter enthält.

Für die Verwendung des Befehlszeilendienstprogramms createportal führen Sie das Skript createportal.sh mit -h oder -help aus, wie unten dargestellt:

<Portal for ArcGIS Installation Directory>/tools/createportal/createportal.sh -help

Beispiel für die Verwendung mit dem Dienstprogramm: createportal.sh [-fn <arg>] [-ln <arg>] [-u <arg>] [-p <arg>] [-e <arg>] [-qi <arg>] [-qa <arg>] [-d <arg>] [ -lf <arg>] [ -ut <arg>]

Beispiel für die Verwendung mit einer Datei: createportal.sh [-f <FILE>]

Hinweis:

Wenn Sie auf einen Pfad in der Datei createportal.properties verweisen, müssen Sie umgekehrte Schrägstriche mit Escape-Zeichen umgeben, z. B. C:\\arcgisportal oder \\\\<Absolute path to>\\<portal arcgisportal>.

Option	Beschreibung
-fn; --firstname	Vorname für ein initiales Administratorkonto zum Konfigurieren des Portals. Einträge mit mehreren Wörtern müssen in Anführungszeichen gesetzt werden.
-ln; --lastname	Nachname für ein initiales Administratorkonto zum Konfigurieren des Portals. Einträge mit mehreren Wörtern müssen in Anführungszeichen gesetzt werden.
-u; --username	Benutzername für ein initiales Administratorkonto zum Konfigurieren des Portals. Der Benutzernamen kann die Zahlen 0 bis 9, die ASCII-Buchstaben A bis Z (Groß- und Kleinschreibung) und das Punktzeichen (.) enthalten.
-p; --password	Kennwort für das initiale Administratorkonto zum Konfigurieren des Portals. Das Kennwort kann die Zahlen 0 bis 9, die ASCII-Buchstaben A bis Z (Groß- und Kleinschreibung) und das Punktzeichen (.) enthalten.
-e; --email	E-Mail-Adresse für ein initiales Administratorkonto zum Konfigurieren des Portals.
-qi; --question	Index der geheimen Fragen, um ein vergessenes Kennwort abzurufen. Im Folgenden werden die verfügbaren Fragen mit den entsprechenden Indexnummern aufgelistet: 1. In welcher Stadt wurden Sie geboren? 2. Welches Maskottchen hatte Ihre Schule? 3. Wie lautet der Mädchenname Ihrer Mutter? 4. Von welchem Hersteller war Ihr erstes Auto? 5. Welche Schule haben Sie besucht? 6. Wie lautet der Nachname Ihres besten Freundes/Ihrer besten Freundin? 7. Wie lautet der zweite Vorname Ihres jüngsten Bruders/Ihrer jüngsten Schwester? 8. Wie lautet der Name der Straße, in der Sie aufgewachsen sind? 9. Wie lautet der Name Ihrer Lieblingsromanfigur? 10. Wie lautet der Name Ihres Lieblingshaustiers? 11. Wie lautet der Name Ihres Lieblingsrestaurants? 12. Welchen Titel hat Ihr Lieblingsbuch? 13. Was ist Ihr Traumberuf? 14. Wo fand Ihre erste Verabredung statt?
-qa; --answer	Antwort auf die geheime Frage, die Sie für den Parameter -qi ausgewählt haben. Einträge mit mehreren Wörtern müssen in Anführungszeichen gesetzt werden.
-d; --contentDirectory	Absoluter Pfad und Name des Inhaltsverzeichnisses, das verwendet wird, um die im Portal gehosteten Daten zu speichern. Standardmäßig wird das Verzeichnis mit den Inhalten des Portals lokal in diesem Verzeichnis erstellt: <Portal for ArcGIS Installation Directory>/usr/arcgisportal
-f; --file	Die Eigenschaftendatei für das Dienstprogramm createportal. Standardmäßig befindet sich die createportal.properties-Datei in diesem Verzeichnis: <Portal for ArcGIS Installation Directory>\tools\createportal
-lf; --licenseFile	Dies ist der Pfad zur Portal-Lizenzdatei.
-ut; --userTypeID	Dies ist die ID des Benutzertyps für den initialen Administrator. Dieser Parameter ist optional. Um eine Liste kompatibler Benutzertypen zu generieren, die für Ihre Organisation für den Parameter -ut verfügbar sind, führen Sie das Dienstprogramm listadministratorusertypes aus. Wird keine Benutzertyp-ID angegeben und enthält die Portal-Lizenzdatei nur einen kompatiblen Benutzertyp, wird dieser Benutzertyp zugewiesen. Enthält die Lizenzdatei mehrere kompatible Benutzertypen, wird ein temporärer Benutzertyp zugewiesen und der initiale Administrator muss nach dem Anmelden einen Benutzertyp auswählen.
-h; --help	Die Hilfe für die Befehlszeile wird angezeigt und beendet.

Nachfolgend finden Sie ein Beispiel für die createportal.properties-Datei:

#
#
# Portal for ArcGIS site creation properties
#
# First name for initial administrator account
PORTAL_ADMIN_FIRSTNAME =
# Last name for initial administrator account
PORTAL_ADMIN_LASTNAME =
# User name for initial administrator account
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_USERNAME =
# Password for primary site administrator.
# Can only have the numbers 0-9, the ASCII letters a-z, A-Z and the dot character (.)
PORTAL_ADMIN_PASSWORD =
# Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
# E-mail address for initial administrator account
# e.g [e-mail]
PORTAL_ADMIN_EMAIL =
#This is the index of the secret question to retrieve a forgotten password.
#The list of questions with their respective index numbers is as follows:
#1, What city were you born in ?"
#2, What was your high school mascot?"
#3, What is your mother's maiden name?"
#4, What was the make of your first car?"
#5, What high school did you go to?"
#6, What is the last name of your best friend?"
#7, What is the middle name of your youngest sibling?"
#8, What is the name of the street on which you grew up?"
#9, What is the name of your favorite fictional character?"
#10, What is the name of your favorite pet?"
#11, What is the name of your favorite restaurant?"
#12, What is the title of your favorite book?"
#13, What is your dream job?"
#14, Where did you go on your first date?");
PORTAL_ADMIN_SECURITY_QUESTION_INDEX =
# Answer to the secret question
# e.g \"My Answer\"
PORTAL_ADMIN_SECURITY_QUESTION_ANSWER =
# Portal content directory where portal will store default and user-generated content.
# By default, the portal content directory will be created locally,
# e.g./<Portal for ArcGIS installation directory>/usr/arcgisportal.
PORTAL_CONTENT_DIRECTORY =
# The path to the portal license file
PORTAL_LICENSE_FILE =
# The ID of the user type for the Initial Administrator
PORTAL_USER_TYPE_ID =

Bevor das Werkzeug beendet wird, erhalten Sie die Meldung, dass das Portal erfolgreich erstellt wurde.

Verwenden des Befehlszeilendienstprogramms listadministratorusertypes zum Identifizieren kompatibler Benutzertypen

Um eine Liste mit Benutzertyp-IDs zu identifizieren, die für Ihre Organisation lizenziert sind und mit der Rolle "Administrator" kompatibel sind, führen Sie das Befehlszeilendienstprogramm listadministratorusertypes aus. Es wird eine Liste mit Eingaben für den Parameter -ut im Werkzeug createportal generiert. Führen Sie das Werkzeug mit der Portal-Lizenzdatei als Eingabe mit -la aus, wie unten gezeigt:

<Portal for ArcGIS Installation Directory>/tools/createportal/listadministratorusertypes.sh

Beispiel für die Verwendung mit dem Dienstprogramm: listadministratorusertypes.sh [-la <arg>] oder listadministratorusertypes.sh [--listadministratorusertypes <arg>]

Postinstallation und Konfiguration

Wenn Portal for ArcGIS mit dem Betriebssystem gestartet werden soll, führen Sie die für Ihr Betriebssystem spezifischen Schritte unten aus.

Betriebssysteme, die "systemd" unterstützen

Wenn das Betriebssystem die Verwendung von "systemd" für den Boot-Vorgang und die Verwaltung von Prozessen unterstützt (wenn Sie beispielsweise Red Hat 7.x verwenden), führen Sie die folgenden Schritte aus, um Portal for ArcGIS so zu konfigurieren, dass es mit dem Betriebssystem gestartet wird.

1. Wechseln Sie in einer Befehlsshell zum Root-Benutzer.
2. Kopieren Sie die Einheitendatei <Portal for ArcGIS installation directory>/framework/etc/arcgisportal.service nach /etc/systemd/system. Stellen Sie nach dem Kopieren sicher, dass die Dateiberechtigungen für /etc/systemd/system/arcgisportal.service auf 600 festgelegt sind.

   Hinweis:

   Diese Datei wird mit Portal for ArcGIS 10.9 installiert.

3. Führen Sie weiterhin als Root-Benutzer den folgenden Befehl aus, um die Links in /etc/systemd/system/multi-user.target.wants automatisch auszuführen:

   # systemctl enable arcgisportal.service

4. Um zu überprüfen, ob der systemd-Service ordnungsgemäß konfiguriert ist, starten Sie den Service neu und überprüfen dessen Status.

   # systemctl stop arcgisportal.service
   # systemctl start arcgisportal.service
   # systemctl status arcgisportal.service

   Hinweis:

   Um zu verhindern, dass ein Service zu viele Threads erzeugt und sämtliche Serverressourcen verbraucht, ist die maximale Thread-Anzahl ab "systemd v228" (enthalten in SLES12 SP2 und höher) auf 512 begrenzt. Unter SLES12 muss dieser Grenzwert in stark genutzten Systemen ggf. aktiviert und heraufgesetzt werden. Um diesen Grenzwert zu aktivieren und zu erhöhen, müssen Root-Benutzer die Auskommentierung der folgenden Zeile im Unit-File "arcgisportal.service" aufheben und diese vor der Bereitstellung im Ordner "/etc/systemd/system" bearbeiten: # TasksMax=512

5. Beenden Sie die Sitzung als Root-Benutzer.
6. Starten Sie das Betriebssystem neu, und stellen Sie sicher, dass Portal for ArcGIS ordnungsgemäß neu gestartet wird.

Betriebssysteme, die SysV unterstützen

Wenn das Betriebssystem die Verwendung von "SysV" für den Boot-Vorgang und die Verwaltung von Prozessen unterstützt, führen Sie die folgenden Schritte aus, um Portal for ArcGIS so zu konfigurieren, dass es mit dem Betriebssystem gestartet wird.

1. Wechseln Sie in einer Befehlsshell zum Root-Benutzer.
2. Kopieren Sie das Shell-Skript <Portal for ArcGIS installation directory>/framework/etc/arcgisportal an die unten angegebenen, entsprechend unterstützten verteilungsbasierten Linux-Speicherorte:
   • RHEL: /etc/rc.d/init.d/
   • SUSE: /etc/init.d/
3. Ändern Sie das Verzeichnis in den entsprechenden init.d-Ordner, und überprüfen Sie das Skript arcgisportal, um sicherzustellen, dass der Root-Benutzer mindestens über Lese- und Ausführungsberechtigungen verfügt.
4. Bearbeiten Sie das Skript wie folgt:

   1. Aktualisieren Sie die portalhome-Variable so, dass sie auf das Portal for ArcGIS-Installationsverzeichnis verweist, z. B. /home/username/arcgis/portal.

   2. Nur für RHEL – Fügen Sie die unten aufgeführte Zeile vor # Description: Portal for ArcGIS Service ein:

      # chkconfig: 35 99 01

   3. Speichern Sie die Änderungen im arcgisportal-Skript.

5. Führen Sie weiterhin als Root-Benutzer die folgenden Befehle aus, um die Links in /etc/rc*.d automatisch mit den entsprechenden Ausführungsebenen auszuführen:
   • RHEL:

     $ chkconfig --add arcgisportal
     $ chkconfig arcgisportal on

   • SUSE:

     $ insserv arcgisportal
     $ chkconfig arcgisportal on

6. Beenden Sie die Sitzung als Root-Benutzer.
7. Starten Sie das Betriebssystem neu, und stellen Sie sicher, dass Portal for ArcGIS ordnungsgemäß neu gestartet wird.