Installieren und Konfigurieren von EM4C Gateway

EM4C Gateway muss auf jedem IBM Cognos Gateway-Computer in Ihrer Umgebung installiert sein.

EM4C Gateway kann eigenständig oder in Kombination mit EM4C Server und EM4C Dispatcher installiert und konfiguriert werden. Weitere Informationen finden Sie unter Installationsabfolge für Serverkomponenten. Ein Beispiel einer Bereitstellung von Esri Maps for IBM Cognos finden Sie unter Esri Maps for IBM Cognos-Architektur.

Installieren von EM4C Gateway

Bitte stellen Sie vor Beginn der Installation sicher, dass sich auf jedem Computer, auf dem Sie EM4C Gateway installieren, ein IBM Cognos Gateway-Verzeichnis befindet.

Folgende Schritte sollten als Administrator durchgeführt werden.

1. Starten Sie im em4c-Verzeichnis der Installationsmedien die Batch-Datei (.bat) des Installationsprogramms. Beispiel:

   G:\em4c\launchInstaller.bat

2. Klicken Sie auf der Seite Willkommen auf Weiter.
3. Wenn Sie den Bedingungen der Lizenzvereinbarung zustimmen, klicken Sie auf Weiter; andernfalls klicken Sie auf Beenden, um den Vorgang zu beenden.
4. Wählen Sie den Installationspfad aus, und klicken Sie auf Weiter.
5. Wählen Sie die Version von IBM Cognos aus, auf der Esri Maps for IBM Cognos installiert wird, und klicken Sie auf Weiter.
6. Stellen Sie sicher, dass nur die EM4C Gateway-Komponente ausgewählt ist, und klicken Sie auf Weiter.
7. Geben Sie das webcontent-Verzeichnis von IBM Cognos Gateway an, und klicken Sie auf Weiter.
8. Klicken Sie auf Weiter, um mit der Installation fortzufahren.
9. Warten Sie, bis die Dateien in das angegebene Verzeichnis kopiert wurden, und klicken Sie auf Weiter.
10. Sie können optional auf Automatisches Installationsskript erstellen klicken, um eine XML-Datei mit allen Parametern zu speichern, die Sie auf den vorherigen Seiten festgelegt haben.
11. Klicken Sie auf Fertig.

Konfigurieren von EM4C Gateway

Die Konfiguration eines EM4C Gateway benötigt eine sortierte, durch Trennzeichen (Kommas) getrennte Liste von EM4C Server-Computern in Ihrer Umgebung. Weitere Informationen finden Sie unter Konfiguration.

Führen Sie die Esri Maps for IBM Cognos-Konfiguration als Benutzer mit Administratorberechtigungen aus.

1. Navigieren Sie zum Verzeichnis <em4c_location>\bin, und führen Sie configure.bat aus.
2. Klicken Sie im Explorer-Fenster des Konfigurationsanwendungwerkzeugs auf Lokale Konfiguration.
3. Ändern Sie die Einstellungen für die lokale Konfiguration entsprechend Ihrer Umgebung. (So sollte beispielsweise derHostname innerhalb einer URI von localhost in eine IP-Adresse oder den Namen eines Netzwerk-Hosts geändert werden.) Die Esri Maps for IBM Cognos-Konfigurationsanwendung erkennt, welche EM4C-Komponenten installiert sind und listet nur die Konfigurationseinstellungen auf, die festgelegt werden müssen.
4. Klicken Sie auf Übernehmen.
5. Klicken Sie im Menü Datei auf Beenden.

Konfigurieren des Webservers

Damit Esri Maps for IBM Cognos und IBM Cognos kommunizieren können, müssen Sie die virtuellen Verzeichnisse (Aliase) erstellen, die in der folgenden Tabelle aufgeführt sind. Beachten Sie, dass angenommen wird, dass IBM Cognos als Virtuelles Verzeichnis namens "ibmcognos" (kann je nach Umgebung geändert werden) auf Ihrem Webserver erstellt wurde.

Alias	Speicherort
ibmcognos\em4c	<em4c_location>\webcontent
ibmcognos\em4c\cgi-bin	<em4c_location>\cgi-bin or <em4c_location>\cgi-bin-64bit, je nach Umgebung (x86 oder x64)

Virtuelle Verzeichnisse von Esri Maps for IBM Cognos

Weitere Informationen zur Webserverkonfiguration finden Sie unter Webserverkonfiguration.

Testen der Konfiguration

Nachdem Esri Maps for IBM Cognos installiert und konfiguriert wurde, löschen Sie den Cache des Webbrowsers (bei den meisten Browsern STRG+UMSCHALT+ENTF), falls dies noch nicht erfolgt ist. Anschließend können Sie verschiedene Aspekte des Installations- und Konfigurationsprozesses testen.

In den folgenden Beispielen wird vorausgesetzt, dass in IBM Cognos ein ibmcognos-Alias existiert.

1. Führen Sie die folgenden Tests durch, um zu überprüfen, ob EM4C Gateway wie erwartet funktioniert:
   1. Testen Sie, ob das virtuelle Verzeichnis des EM4C-Webservers (Alias) ordnungsgemäß eingerichtet wurde (dabei wird außerdem überprüft, ob Übernehmen in der Esri Maps for IBM Cognos-Konfiguration ausgewählt wurde):

      http://<cognos_gateway>/ibmcognos/em4c/version.txt

   2. Testen Sie, ob das CGI-Skript von EM4C Gateway ordnungsgemäß funktioniert (Verbindung mit EM4C Server). Sollte dies der Fall sein, führt die folgende URL zu einer Meldung mit einem Zeitstempel, die im Browser angezeigt wird:

      http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi

   3. Testen Sie, ob das CGI-Skript von EM4C Gateway auf externe Ressourcen zugreifen kann. So sollte beispielsweise jede der folgenden URLs ein JSON-Objekt zurückgeben, aus dem die Version der auf dem Server installierten Software hervorgeht.

      ArcGIS Online:

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://www.arcgis.com/sharing?f=pjson

      Portal for ArcGIS-Instanz:

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://myPortal/gis/sharing/?f=pjson

      Wenn der Test erfolgreich ist, wird die aktuelle Version zurückgegeben, z. B. "currentVersion":"x.x".

   Hinweis:

   Wenn die oben erwähnten Tests nicht zu den erwarteten Ergebnissen führen, gibt es zwei mögliche Gründe: Die Esri Maps for IBM Cognos-Konfiguration wurde nicht ausgeführt (Änderungen an der Konfiguration wurden weder gespeichert noch übernommen) oder der Webserver wurde nicht ordnungsgemäß konfiguriert.