Installieren und Konfigurieren auf einem einzelnen Computer

Installieren von Esri Maps for IBM Cognos

Eine vollständige Installation von Esri Maps for IBM Cognos beinhaltet die Installation von Komponenten auf Ihrem Server und deren Konfiguration für Ihre Umgebung. Bevor Sie beginnen, müssen Sie sicherstellen, dass Sie mit den Installationsoptionen vertraut sind und über das richtige Installationsprogramm für das Betriebssystem verfügen, auf dem die Installation ausgeführt wird.

Folgende Schritte sollten als Administrator durchgeführt werden:

1. Führen Sie im em4c-Verzeichnis der Installationsmedien die Batch-Datei (.bat) des Installationsprogramms aus. 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 EM4C Gateway, EM4C Dispatcher und EM4C Server ausgewählt sind, und klicken Sie auf Weiter.
7. Geben Sie das webcontent-Verzeichnis von IBM Cognos Gateway an, und klicken Sie auf Weiter.
8. Geben Sie das IBM Cognos Dispatcher-Verzeichnis an, und klicken Sie auf Weiter.
9. Klicken Sie auf Weiter, um mit der Installation fortzufahren.
10. Warten Sie, bis die Dateien in das angegebene Verzeichnis kopiert wurden, und klicken Sie auf Weiter.
11. 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.
12. Klicken Sie auf Fertig.

Konfigurieren von Esri Maps for IBM Cognos

Bevor Sie die folgenden Schritte ausführen, müssen Sie sicherstellen, dass Sie mit den verfügbaren Konfigurationseinstellungen vertraut sind.

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.

Starten von EM4C Server

EM4C Server für Esri Maps for IBM Cognos muss für alle Speicherorte gestartet werden, an denen die EM4C Server-Komponente installiert wurde.

EM4C Server wird als Service ausgeführt und ist so konfiguriert, dass es standardmäßig automatisch gestartet wird (es kann mit der Microsoft Management Console manuell neu gestartet werden).

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.

Neustarten des IBM Cognos-Service

Für Änderungen, die auf die Esri Maps for IBM Cognos-Konfiguration angewendet wurden, muss der IBM Cognos-Service auf jedem IBM Cognos Dispatcher-Computer neu gestartet werden, auf dem der Report Service und/oder Presentation Service ausgeführt wird.

Weitere Informationen zum Neustarten des IBM Cognos-Service finden Sie im Installations- und Konfigurationshandbuch von IBM Cognos für Ihre IBM Cognos-Version.

Nun sollten alle Berichtsautoren und Endbenutzer von Esri Maps for IBM Cognos ihren Webbrowser-Cache löschen. Die Anweisungen hierzu sind je nach Browser unterschiedlich, STRG+UMSCHALT+ENTF funktioniert jedoch in den meisten Browsern.

Erstellen der Esri Maps for IBM Cognos-Funktion

Esri Maps for IBM Cognos kann erst aktiviert werden, nachdem die Esri Maps-Funktion erstellt wurde. Benutzer, die nicht über die erforderlichen Berechtigungen für diese Funktion verfügen, können weder Esri Maps Designer verwenden noch Esri Maps in Berichten mit Kartenaktivierung anzeigen.

Der IBM Cognos-Systemadministrator erstellt diese Funktion, indem er Esri Maps Designer über das Menü Starten in Cognos Connection öffnet. Wenn Sie die Esri Maps-Funktion erstellen, werden Benutzer und Gruppen anhand der Standardeinstellungen für Cognos-Funktionen hinzugefügt. Diese Standardbenutzer und -gruppen erhalten Transit- und Ausführungsberechtigungen für Esri Maps for IBM Cognos. Um die Verwendung von Esri Maps for IBM Cognos zu deaktivieren, entfernen Sie die Ausführungsberechtigungen für den entsprechenden Benutzer oder die Gruppe. Berechtigungen können in Cognos Administration geändert werden.

Hinweis:

Die Esri Maps-Funktion sollte nicht umbenannt werden.

1. Um die Esri Maps-Funktion zu erstellen, führen Sie die folgenden Schritte aus:
   1. Melden Sie sich als Systemadministrator bei IBM Cognos an.
   2. Öffnen Sie Cognos Connection.
   3. Wählen Sie im Menü Starten die Option Esri Maps Designer aus.

   Die Funktion wird erstellt.

2. Um die Berechtigungen für Benutzer und Gruppen zu verwalten, führen Sie die folgenden Schritte aus:
   1. Öffnen Sie Cognos Administration.
   2. Fügen Sie Benutzer und Gruppen wie gewünscht hinzu oder entfernen Sie sie oder ändern Sie die Berechtigungen ggf.

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. Testen Sie wie folgt, ob der EM4C Server den angegebenen Port abhört. Beachten Sie, dass in diesem Fall der Standard-Port 9896 verwendet wird (kann bei Bedarf geändert werden):

   http://<em4c_server>:9896/em4c/version.txt

   Wenn dieser Test fehlschlägt, stellen Sie sicher, dass EM4C Server an allen Installationsorten gestartet wurde.

2. 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.

3. EM4C Dispatcher wird im Prozessbereich von IBM Cognos ausgeführt und manuelle Tests können nur beschränkt durchgeführt werden. Eine Möglichkeit, zu testen, ob EM4C Dispatcher ordnungsgemäß installiert und konfiguriert ist, besteht darin, Cognos Connection zu starten und zu überprüfen, ob Esri Maps Designer im Menü Start angezeigt wird.