Konfigurieren von ArcGIS Web Adaptor

Nach der Installation von ArcGIS Web Adaptor müssen Sie ihn für die Zusammenarbeit mit einer Server-Site und Ihrem ArcGIS Enterprise-Portal konfigurieren. Dazu verwenden Sie die mit dem Web Adaptor installierte Konfigurations-Webseite bzw. das Befehlszeilendienstprogramm.

Wenn Sie die Konfigurationsseite öffnen, wird der aktuelle Status von ArcGIS Web Adaptor angezeigt. Dies gibt an, ob ArcGIS Web Adaptor zuvor konfiguriert wurde. Um den Plattformtyp und die Versionsnummer des Web Adaptor anzuzeigen, klicken Sie auf der Konfigurationsseite auf Info.

Hinweis:

Ab ArcGIS Enterprise 11.5 ist der administrative Zugriff auf die ArcGIS-Server-Site über Web Adaptor standardmäßig aktiviert und kann nicht deaktiviert werden Für ArcGIS Enterprise-Bereitstellungen mit Internetverbindung sollten Sie anstelle von Web Adaptor einen produktionsreifen Load Balancer mit Web Application Firewall (WAF) als Front-End in Betracht ziehen. Weitere Informationen finden Sie im ArcGIS Enterprise Hardening Guide.

Wenn Sie bereits eine Web Adaptor-Instanz mit Ihrem ArcGIS Enterprise-Portal konfiguriert haben und das Portal für die Verwendung mit einer anderen Web Adaptor-Instanz aktualisieren möchten, müssen Sie die Registrierung der aktuellen Web Adaptor-Instanz zuerst aufheben. Dies kann nur über das Portalverzeichnis erfolgen. Die Funktion zum Aufheben der Registrierung ist auf der Konfigurationsseite bzw. auf der Portal-Website nicht verfügbar. Vollständige Anweisungen finden Sie unter Aufheben der Registrierung mit Portal for ArcGIS.

Achtung:

Sie können die Web Adaptor-Instanz für ein Portal ändern, indem Sie eine neue Web Adaptor-Instanz registrieren. Dies kann Einfluss auf Benutzerinhalte im Portal (z. B. Kartennotizen oder andere Elemente) haben.

Hinweis:

Der Standard-Port für HTTPS-Verbindungen 443 ist für die meisten Benutzer geeignet. In einigen seltenen Fällen kann Port 443 auf dem Webserver aus organisationsspezifischen Gründen von der ArcGIS Web Adaptor-Instanz nicht verwendet werden. Sollte dies für Ihre Organisation zutreffen, erfahren Sie unter Verwenden von Nicht-Standard-Ports für ArcGIS Web Adaptor im Portal, mit welchen zusätzlichen Schritten ein Workaround konfiguriert werden kann.

Konfigurieren von ArcGIS Web Adaptor mit einer Serverseite

In den folgenden Abschnitten wird beschrieben, wie Sie ArcGIS Web Adaptor mit einer Server-Site über die Konfigurationsseite und das Befehlszeilendienstprogramm konfigurieren.

Konfigurieren über die Konfigurations-Webseite

Um ArcGIS Web Adaptor mit einer Server-Site über die Konfigurations-Website zu konfigurieren, die mit der Software installiert wurde, führen Sie die folgenden Schritte aus.

Hinweis:

Für ArcGIS Mission Server, ArcGIS Notebook Server und ArcGIS Video Server sind an dieser Stelle weitere Aspekte zu berücksichtigen.

Öffnen Sie die Konfigurationsseite in einem Webbrowser.

Die URL hat das Format https://webadaptorhost.example.com/webadaptorname/webadaptor.

Hinweis:

Wenn der Webserver, auf dem Sie ArcGIS Web Adaptor installiert haben, für die Verwendung eines Forward-Proxys konfiguriert ist, deaktivieren Sie ihn bei der Registrierung des Web Adaptor. Andernfalls können Sie nicht auf die Konfigurationsseite des Web Adaptor zugreifen.
Wählen Sie den Server-Typ aus, den Sie für Web Adaptor konfigurieren möchten. Klicken Sie auf Weiter.
Geben Sie den Computernamen für einen der Server ein, die Sie für Ihre Site registrieren.

Dieser Computername wird verwendet, um alle Computer der Server-Site zu ermitteln und sie beim Web Adaptor zu registrieren. Der Computername muss das Format server.example.com aufweisen.
Geben Sie einen Benutzernamen und ein Kennwort für ein Konto ein, dem Administratorberechtigungen für die Server-Site zugewiesen wurden. In der Regel geben Sie den bei der Erstellung der Site festgelegten Benutzernamen und das entsprechende Kennwort für das primäre Site-Administratorkonto an. Falls Sie das primäre Site-Administratorkonto deaktiviert haben, müssen Sie ein Konto mit administrativem Zugriff auf die Site angeben.
Klicken Sie auf Konfigurieren, um die Einstellungen auf den Web Adaptor anzuwenden.

Wenn die Konfiguration erfolgreich war, werden am unteren Rand der Konfigurationsseite (grün hervorgehoben) die von Web Adaptor erkannten Computer angezeigt. Sie können jederzeit zu dieser Seite zurückkehren, um die Liste erkannter Computer anzuzeigen und die Web Adaptor-Einstellungen anzupassen.

Konfigurieren über die Befehlszeile

Sie können ArcGIS Web Adaptor mit einer Server-Site über das Befehlszeilendienstprogramm (ConfigureWebAdaptor.exe) in C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Toolskonfigurieren.

Folgende Parameter stehen zur Verfügung:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password>

Sie können ArcGIS Web Adaptor mit einer Server-Site über das Befehlszeilendienstprogramm (ConfigureWebAdaptor.bat) in <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\toolskonfigurieren.

Folgende Parameter stehen zur Verfügung:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

Sie können ArcGIS Web Adaptor mit einer Server-Site über das Befehlszeilendienstprogramm (configurewebadaptor.sh) in <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/toolskonfigurieren. Dies ist besonders vorteilhaft, wenn der Computer, auf dem der Web Adaptor gehostet wird, über keine grafische Bedienoberfläche verfügt.

Folgende Parameter stehen zur Verfügung:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password>

<Mode>: Die Komponente, mit der Web Adaptor konfiguriert wird. Dieser Parameter ist standardmäßig auf server festgelegt, was bedeutet, dass Web Adaptor für die Verwendung mit der Server-Site konfiguriert werden kann. Nachfolgend sind die Parameter aufgeführt, die Sie zur Konfiguration anderer Komponenten verwenden können.
- Portal for ArcGIS: portal
- ArcGIS Mission Server: mission
- Notebook Server: notebook
- Video Server: video
- ArcGIS Monitor: monitor
- ArcGIS Data Pipelines: datapipelines
<WebAdaptorURL>: Die URL des Web Adaptor, der über die Befehlszeile konfiguriert werden soll. Dies ist dieselbe URL, die Sie verwenden, als wenn Sie die Konfigurationsseite des Web Adaptor in einem Webbrowser aufrufen. Wenn Web Adaptor an einem anderen Port als dem Standardport 80 installiert wurde, geben Sie den Port in der URL an.
<MachineName|URL>: Der Computername für einen der Computer in der Server-Site, z. B. server.example.com. Sie können statt des Computernamens auch die URL des Servercomputers angeben. Wenn Sie Web Adaptor mit ArcGIS Server konfigurieren, wird der Computername oder die Computer-URL verwendet, um alle Computer in der Site zu ermitteln.
<Username>: Der Benutzername eines Kontos, dem Administratorberechtigungen für die Server-Site zugewiesen wurden. Für ArcGIS Server kann es sich bei diesem Konto um das primäre Site-Administratorkonto handeln, das beim Erstellen der Site eingegeben wurde, oder um ein Konto, dem Administratorberechtigungen zugewiesen wurden. Geben Sie für ArcGIS Server Mission Server, Notebook Server und Video Server den Benutzernamen für das beim Erstellen der Site verwendete primäre Site-Administratorkonto ein.
<Password>: Das Kennwort des Kontos, das über Administratorberechtigungen für die Server-Site verfügt.

Beispiel: ConfigureWebAdaptor.exe /m server /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g server.example.com /u siteadmin /p secret

Beispiel: ConfigureWebAdaptor.bat -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

Beispiel: $ ./configurewebadaptor.sh -m server -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g server.example.com -u siteadmin -p secret

Hinweis:

Um das Befehlszeilenprogramm auszuführen, muss eine Java Runtime Environment (JRE) auf dem Computer vorhanden sein, der den Web Adaptor hostet. Wenn die JRE nicht auf Ihrem Computer vorhanden ist, tritt ein Fehler beim Ausführen des Dienstprogramms auf. Weitere Anweisungen zum Herunterladen und Installieren einer JRE auf dem Computer finden Sie unter Java SE-Downloads.

Konfigurieren von ArcGIS Web Adaptor mit einem Portal

In den folgenden Abschnitten wird beschrieben, wie Sie ArcGIS Web Adaptor mit Ihrem ArcGIS Enterprise-Portal über die Konfigurationsseite und das Befehlszeilendienstprogramm konfigurieren.

Konfigurieren über die Konfigurations-Webseite

Um ArcGIS Web Adaptor mit Ihrem Portal über die Konfigurations-Website zu konfigurieren, die mit der Software installiert wurde, führen Sie die folgenden Schritte aus:

Achtung:

Informationen zum Hinzufügen eines DNS-Alias oder Reverseproxys nachdem eine ArcGIS-Server-Site mit Ihrem Portal verbunden wurde, finden Sie unter Aktualisieren der Organisations-URL.

Aktivieren Sie HTTPS auf dem Webserver, falls dies noch nicht erfolgt ist.
Öffnen Sie die Konfigurationsseite in einem Webbrowser über eine HTTPS-URL wie https://webadaptorhost.example.com/webadaptorname/webadaptor. Wenn ein DNS-Alias mit dem Portal verwendet wird, sollte der Web Adaptor stattdessen mit einer URL wie https://<dnsalias.example.com>/<webadaptorname>/webadaptor über den DNS-Alias konfiguriert werden.

Hinweis:

Wenn auf dem Webserver, auf dem Sie ArcGIS Web Adaptor installiert haben, ein Forward-Proxy ausgeführt wird, deaktivieren Sie ihn bei der Registrierung des Web Adaptor. Andernfalls können Sie nicht auf die Konfigurationsseite des Web Adaptor zugreifen.
Wählen Sie Portal for ArcGIS, und klicken Sie auf Weiter.
Geben Sie den Namen des Computers ein, der Portal for ArcGIS hostet. Schließen Sie den vollständig qualifizierten Domänennamen mit ein, z. B. portal.example.com.
Geben Sie einen Benutzernamen und ein Kennwort für ein Konto ein, dem Administratorberechtigungen für Portal for ArcGIS zugewiesen wurden. In der Regel geben Sie den bei der Einrichtung des Portals festgelegten Benutzernamen und das entsprechende Kennwort für das initiale Administratorkonto an. Falls Sie das initiale Administratorkonto herabgestuft oder gelöscht haben, müssen Sie ein Konto mit administrativem Zugriff auf die Site angeben.
Klicken Sie auf Konfigurieren.

ArcGIS Web Adaptor ist für die Nutzung mit dem Computer konfiguriert, der Portal for ArcGIS hostet. Nun rufen Sie das Portal über die ArcGIS Web Adaptor-URL statt über den Port 7443 auf. Die URL hat das folgende Format: https://webadaptorhost.example.com/webadaptorname/home.

Wenn Sie die Verwendung von HTTPS für die gesamte Kommunikation im Portal konfiguriert haben, sollten Sie die installierte Portal-Website und die Verknüpfungs-URLs der Hilfe zur Verwendung von https anstelle von http aktualisieren. Andernfalls wird im Browser ein Fehler angezeigt, wenn Sie versuchen, auf die ursprünglichen Verknüpfungs-URLs zuzugreifen.

Wenn Sie Portal for ArcGIS mit dem Reverse-Proxyserver Ihrer Organisation konfigurieren, müssen Sie einige Informationen zu dem Proxyserver im Portal bereitstellen. Vollständige Anweisungen finden Sie unter Integrieren des Portals in einem Reverse-Proxy oder Load Balancer.

Konfigurieren über die Befehlszeile

Sie können ArcGIS Web Adaptor mit Ihrem Portal über das Befehlszeilendienstprogramm (ConfigureWebAdaptor.exe) in C:\Program Files\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools konfigurieren.

Folgende Parameter stehen zur Verfügung:

ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <MachineName|URL> /u <Username> /p <Password> -r <ReindexPortal>

Sie können ArcGIS Web Adaptor mit Ihrem Portal über das Befehlszeilendienstprogramm (ConfigureWebAdaptor.bat) in <ArcGIS Web Adaptor (Java Platform) installation directory>\WebAdaptor\<current version>\java\tools konfigurieren.

Folgende Parameter stehen zur Verfügung:

ConfigureWebAdaptor.bat -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

Sie können ArcGIS Web Adaptor mit Ihrem Portal über das Befehlszeilendienstprogramm (configurewebadaptor.sh) in <ArcGIS Web Adaptor installation directory>/webadaptor/<current version>/java/tools konfigurieren. Dies ist besonders vorteilhaft, wenn der Computer, auf dem der Web Adaptor gehostet wird, über keine grafische Bedienoberfläche verfügt.

Folgende Parameter stehen zur Verfügung:

configurewebadaptor.sh -m <Mode> -w <WebAdaptorURL> -g <MachineName|URL> -u <Username> -p <Password> -r <ReindexPortal>

<Mode>: Die Komponente, mit der Web Adaptor konfiguriert wird. Dieser Parameter ist standardmäßig auf server festgelegt, was bedeutet, dass Web Adaptor für die Verwendung mit GIS Server, Image Server oder GeoAnalytics Server konfiguriert werden kann. Da Sie Web Adaptor für die Verwendung mit Portal for ArcGIS konfigurieren, geben Sie diesen Parameter als portal ein.
<WebAdaptorURL>: Die URL des Web Adaptor, der über die Befehlszeile konfiguriert werden soll. Dies ist dieselbe URL, die Sie verwenden, als wenn Sie die Konfigurationsseite des Web Adaptor in einem Webbrowser aufrufen. Sie müssen die HTTPS-URL von Web Adaptor angeben, beispielsweise https://webadaptorhost.example.com/webadaptorname/webadaptor. Wenn ein DNS-Alias mit dem Portal verwendet wird, sollte der Web Adaptor stattdessen mit einer URL wie https://<dnsalias.example.com>/<webadaptorname>/webadaptor über den DNS-Alias konfiguriert werden.
<MachineName|URL>: Der Computername für einen der Computer, der Portal for ArcGIS hostet. Schließen Sie den vollständig qualifizierten Domänennamen des Computers mit ein, z. B. portal.example.com. Sie können statt des Computernamens auch die URL des Computers verwenden, auf dem Portal for ArcGIS gehostet wird.
<Username>: Der Benutzername eines Kontos mit Administratorberechtigungen für Portal for ArcGIS. Bei diesem Konto kann es sich um das initiale Administratorkonto handeln, das bei der Erstkonfiguration des Portals eingegeben wurde, oder um ein Konto, dem Administratorberechtigungen zugewiesen wurden.
<Password>: Das Kennwort des Kontos mit Administratorberechtigungen für Portal for ArcGIS.
<ReindexPortal>: Gibt an, ob der Standardinhalt im Portal beim Registrieren der Web Adaptor-Instanz neu indiziert wird. Diese Option ist nützlich, wenn Sie die Bereitstellung mit einem Reverse-Proxy oder Load Balancer konfigurieren möchten. Ohne Indizierung nimmt die Registrierung des Web Adaptor weniger Zeit in Anspruch. Nach der Konfiguration der webContextURL referenziert der integrierte Inhalt die webContextURL.

Beispiel: ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.example.com/webadaptorname/webadaptor /g portal.example.com /u initialadmin /p secret -r true

Beispiel: ConfigureWebAdaptor.bat -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

Beispiel: ConfigureWebAdaptor.sh -m portal -w https://webadaptorhost.example.com/webadaptorname/webadaptor -g portal.example.com -u initialadmin -p secret -r true

Nach Ausführung des Befehls wird ArcGIS Web Adaptor für die Nutzung mit dem Computer konfiguriert, der Portal for ArcGIS hostet. Nun rufen Sie das Portal über die ArcGIS Web Adaptor-URL statt über den Port 7443 auf. Die URL hat das folgende Format: https://webadaptorhost.example.com/webadaptorname/home.

Wenn Sie Portal for ArcGIS mit dem Proxyserver Ihrer Organisation konfigurieren, müssen Sie einige Informationen zu dem Proxy Server im Portal bereitstellen. Vollständige Anweisungen finden Sie unter Integrieren des Portals in einem Reverse-Proxy oder Load Balancer.

Konfigurieren von mehreren ArcGIS Web Adaptor-Instanzen

Für die Konfiguration eines Portals mit hoher Verfügbarkeit, das die Authentifizierung auf Webebene verwendet, sind mehrere ArcGIS Web Adaptors erforderlich. Um mehrere Web Adaptor-Instanzen mit Portal for ArcGIS zu konfigurieren, muss ein einzelner Endpunkt für den Zugriff auf das Portal verwendet werden. Diese URL muss in der WebContextURL-Eigenschaft definiert sein. Mehrere Web Adaptors können dann durch Ausführung der nachfolgenden Schritte konfiguriert werden.

Konfigurieren Sie den ersten ArcGIS Web Adaptor für das Portal.
Fügen Sie Portal for ArcGIS zum Reverseproxyserver hinzu. Legen Sie die WebContextURL-Eigenschaft wie folgt fest:
1. Öffnen Sie einen Webbrowser, und melden Sie sich als Administrator Ihrer Organisation beim Portal-Administratorverzeichnis an.
  
  Die URL hat das Format https://portal.example.com:7443/arcgis/portaladmin.
2. Klicken Sie auf System > Properties > Update Properties.
  
  Der Portal for ArcGIS-Service wird automatisch neu gestartet. Warten Sie, bis der Neustart abgeschlossen wurde, bevor Sie den Vorgang fortsetzen.
3. Geben Sie im Dialogfeld Systemeigenschaften aktualisieren den folgenden JSON-Code ein, wobei Sie die URL Ihres eigenen Reverse-Proxyservers bzw. DNS-Alias so angeben, wie sie Benutzern außerhalb der Firewall der Organisation angezeigt wird:
```
   {
      "WebContextURL": "https://reverseproxy.example.com/myorg"
   }
```
1. Klicken Sie auf Update Properties.
Konfigurieren Sie weitere Web Adaptor.

Alle mit dem Portal konfigurierten Web Adaptors werden auf der Seite mit der Zusammenfassung der Konfiguration aufgeführt. Benutzer greifen über den Reverse-Proxyserver oder die DNA-Alias-URL auf das Portal zu.

Hinweis:

Portal for ArcGIS unterstützt nur eine einzige Organisations-URL.

Nach dem Konfigurieren von ArcGIS Web Adaptor

Nachdem ArcGIS Web Adaptor zur Verwendung konfiguriert wurde, beachten Sie die folgenden Punkte.

Hinzufügen oder Entfernen von Servercomputern

Wenn Sie der Site Servercomputer hinzufügen bzw. aus ihr entfernen, dauert es eine Minute, bis der Web Adaptor die Änderungen an der Site erkennt. Falls der Web Adaptor die hinzugefügten bzw. entfernten Computer sofort erkennen soll, können Sie ihn unter Befolgung der oben aufgeführten Anweisungen entsprechend neu konfigurieren.

Installieren mehrerer Web Adaptors

Sie können verschiedene Web-Einstiegspunkte in Ihrer Server-Site bereitstellen, indem Sie mehrere Web Adaptors installieren. Dadurch wird die Verfügbarkeit der Site für Clients erhöht, ältere Anwendungen werden unterstützt, und der Zugriff auf Veröffentlichungsfunktionen für bestimmte Benutzer in einer umfassend geschützten Umgebung wird ermöglicht. Weitere Informationen finden Sie unter Bereitstellungsszenarien.

Auf einem Computer können mehrere Web Adaptors-Instanzen gleichzeitig installiert werden oder die Installation kann über mehrere getrennte Computer verteilt werden. Um mehrere Web Adaptor-Instanzen in derselben Website (an demselben Port), zu installieren, verwenden Sie unterschiedliche Namen für die Instanzen. Beispielsweise können zwei Web Adaptor-Instanzen mit dem Namen "arcgis" nicht auf derselben Website vorhanden sein. Wenn Sie mehrere Web Adaptor-Instanzen mit demselben Namen installieren möchten, müssen diese auf getrennten Websites (Ports) installiert werden.