Esri Maps for IBM Cognos (6.1, archiviert)

In diesem Thema
  1. Installieren von Esri Maps for IBM Cognos
  2. Konfigurieren von Esri Maps for IBM Cognos
  3. Starten von EM4C Server
  4. Konfigurieren des Webservers
  5. Neustarten des IBM Cognos-Service
  6. Einrichten der Esri Maps for IBM Cognos-Funktion
  7. Testen der Konfiguration

Dies ist die archivierte Dokumentation einer früheren Version von Esri Maps for IBM Cognos. Die aktuelle Dokumentation finden Sie unter http://doc.arcgis.com/de/maps-for-cognos/.

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 anschließende 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.

Es wird empfohlen, die folgenden Schritte als Benutzer auszuführen, der den IBM Cognos-Installationsordner besitzt.

Installieren Sie die Esri Maps for IBM Cognos-Komponenten in einem Verzeichnis, dessen Pfad nur ASCII-Zeichen enthält.

Auf Linux- und UNIX-Plattformen werden interaktive Installationen und Konfigurationen normalerweise von einer X Window System (X11)-Workstation, einem X-Terminal oder einem PC mit installierter X-Serversoftware ausgeführt. Stellen Sie sicher, dass die X11-Weiterleitung ordnungsgemäß eingerichtet ist, bevor Sie die Installation ausführen.

  1. Navigieren Sie im Terminal zum em4c-Verzeichnis auf den Installationsmedien und führen Sie das Shellskript des Installationsprogramms (.sh) aus. Beispiel:

    [cognosuser@server1]$ ./launchInstaller.sh

  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.
  13. Navigieren Sie zu <em4c_location>/bin, und geben Sie Folgendes ein:
    [cognosuser@server1]$ chmod +x setPermissions.sh
[cognosuser@server1]$ ./setPermissions.sh

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.

Auf Linux- und UNIX-Plattformen werden interaktive Installationen und Konfigurationen normalerweise von einer X Window System (X11)-Workstation, einem X-Terminal oder einem PC mit installierter X-Serversoftware ausgeführt. Stellen Sie sicher, dass die X11-Weiterleitung ordnungsgemäß eingerichtet ist, bevor Sie die Installation ausführen.

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.sh aus.
  2. Klicken Sie im Explorer-Fenster 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.

Der EM4C Server-Prozess wird mit den folgenden Shellskripten gestartet und beendet.

  • Starten: start-em4c.sh
  • Beenden: stop-em4c.sh

Beispiel:

[cognosuser@server1]$ cd /opt/em4c/bin 
[cognosuser@server1]$ ./start-em4c.sh

oder

[cognosuser@server1]$ /opt/em4c/bin/start-em4c.sh

Diese Skripte befinden sich unter <em4c_location>/bin und sollten als der Benutzer ausgeführt werden, der Besitzer des Esri Maps for IBM Cognos-Installationsordners ist.

Um den Esri Maps for IBM Cognos-Prozess automatisch unter Linux und UNIX zu starten, müssen Sie den Prozess als Daemon erstellen. Weitere Informationen finden Sie in der Dokumentation des Betriebssystems.

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

Position

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.

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

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

  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.