Konfigurieren von Microsoft Internet Information Services 7.x oder 8.x

In diesem Thema wird vorausgesetzt, dass IBM Cognos Business Intelligence bereits für Microsoft Internet Information Services (IIS) 7.x oder 8.x eingerichtet wurde. Die folgenden Schritte sollten auf jedem EM4C Gateway-Computer in Ihrer Umgebung und von einem Benutzer ausgeführt werden, der Mitglied der Administratorgruppe auf dem IIS-Computer ist.

Hinweis:

In der Beschreibung in diesem Abschnitt wird vorausgesetzt, dass IBM Cognos auf der Standard-Website ausgeführt wird und das virtuelle Verzeichnis von IBM Cognos den Namen ibmcognos hat. Ändern Sie die Schritte wie für Ihre Konfiguration erforderlich.

MIME-Typen

Multi-Purpose Internet Mail Extension (MIME)-Typen identifizieren die Art des Inhalts, die über einen Webserver für einen Browser bereitgestellt werden können. Esri Maps for IBM Cognos erfordert die folgenden MIME-Typen, die bereits in der Standardliste globaler MIME-Typen in IIS konfiguriert sind:

• application/octet-stream
• application/pdf
• application/x-javascript
• image/gif
• image/jpeg
• image/png
• image/svg+xml
• text/css
• text/html
• text/plain
• text/xml

Konfigurieren eines Anwendungspools

Die Esri Maps for IBM Cognos EM4C Gateway-Module müssen im Kontext eines IIS 7.x- oder 8.x-Anwendungspools ausgeführt werden. Auch wenn die Verwendung des Standardanwendungspools am einfachsten ist, empfiehlt es sich, einen zusätzlichen Anwendungspool zu definieren.

In den folgenden Schritten wird ein Anwendungspool namens "EM4CAppPool" erstellt.

1. Öffnen Sie Internet Information Services Manager.
   1. Klicken Sie auf Start > Alle > Zubehör > Ausführen.
   2. Geben Sie im Feld Öffnen die Zeichenfolge inetmgr ein, und klicken Sie auf OK.
2. Erweitern Sie <Servername>.
3. Klicken Sie mit der rechten Maustaste auf Anwendungspools, und wählen Sie Anwendungspool hinzufügen aus.
4. Stellen Sie die erforderlichen Details im Dialogfeld Anwendungspool hinzufügen bereit.
   1. Name: EM4CAppPool
   2. .NET Framework-Version: NET Framework v2.0.50727.
   3. Verwaltetes Pipeline-Modell: Integriert
   4. Anwendungspool sofort starten: Aktivieren Sie diese Option.
5. Klicken Sie auf OK.

Erstellen der virtuellen Verzeichnisse

Microsoft IIS stellt Clients eigene Inhalte über einen virtuellen Verzeichnisbaum zur Verfügung. Sowohl Esri Maps for IBM Cognos- als auch IBM Cognos-Inhalt muss in Form von Unterverzeichnissen des virtuellen IBM Cognos-Verzeichnisses zur Verfügung gestellt werden.

Esri Maps for IBM Cognos-Inhalt muss über dieselbe Domäne (und denselben Port) bereitgestellt werden wie IBM Cognos-Inhalt. Die folgenden Schritte skizzieren die Erstellung eines virtuellen Verzeichnisses: em4c. Diese Verzeichnisnamen können nicht geändert werden, da Esri Maps for IBM Cognos sonst nicht ordnungsgemäß funktioniert. In diesem Abschnitt wird vorausgesetzt, dass IBM Cognos auf der Standard-Website ausgeführt wird und das virtuelle Verzeichnis von IBM Cognos den Namen ibmcognos hat (z. B. http://cognosserver/ibmcognos).

1. Öffnen Sie Internet Information Services Manager.
   1. Klicken Sie auf Start > Alle > Zubehör > Ausführen.
   2. Geben Sie im Feld Öffnen die Zeichenfolge inetmgr ein, und klicken Sie auf OK.
2. Erweitern Sie im linken Explorer-Bereich "IIS Manager", Sites und Standard-Website.
3. Klicken Sie mit der rechten Maustaste auf das virtuelle Verzeichnis ibmcognos, und wählen Sie Virtuelles Verzeichnis hinzufügen aus.
4. Stellen Sie die erforderlichen Details für das Dialogfeld Virtuelles Verzeichnis hinzufügen bereit.
   1. Alias: em4c
   2. Physischer Pfad: <em4c_location>\webcontent
5. Klicken Sie auf OK.

Hinweis:

Wenn die Windows-Authentifizierung in Ihrer Umgebung aktiviert ist, stellen Sie sicher, dass für die folgenden virtuellen Verzeichnisordner Anonyme Authentifizierung aktiviert und die Windows-Authentifizierung deaktiviert ist:

• <em4c virtualdirectory>\emf\3.16\esri\
• <em4c virtualdirectory>\emf\3.16\esri-maps\
• <em4c virtualdirectory>\esrimap\
• <em4c virtualdirectory>\emf\3.16\esriMapsX\

Erstellen einer Anwendung für "cgi-bin"

Beim Erstellen einer IIS-Anwendung für "cgi-bin" werden die EM4C Gateway-Module dem Anwendungspool zugeordnet, in dem die IBM Cognos-Website ausgeführt wird (beispielsweise "Standard-Website").

1. Im linken Explorer-Bereich von IIS Manager finden Sie das zuvor erstellte virtuelle Verzeichnis von em4c.
2. Klicken Sie mit der rechten Maustaste auf das virtuelle Verzeichnis von em4c, und wählen Sie Anwendung hinzufügen aus.
3. Stellen Sie die erforderlichen Details im Dialogfeld Anwendung hinzufügen bereit.
   1. Alias: cgi-bin
   2. Anwendungspool: EM4CAppPool
   3. Physischer Pfad: <em4c_location>\cgi-bin oder <em4c_location>\cgi-bin-64bit
4. Klicken Sie auf OK, um die Änderungen zu speichern.

Konfigurieren von IIS für EM4C CGI Gateway

Damit EM4C CGI Gateway ordnungsgemäß funktioniert, müssen Sie die folgenden Schritte ausführen:

1. Fügen Sie das neue Modul als zulässige Erweiterung hinzu, damit IIS dessen Ausführung nicht blockiert (d. h., legen Sie die CGI-Einschränkungen fest).
2. Fügen Sie eine Modulzuordnung hinzu, um Anforderungen für das EM4C CGI-Modul zu verarbeiten.
3. Konfigurieren Sie Eigenschaften für CGI-Anwendungen.
4. Legen Sie bei Bedarf anonyme Authentifizierungsinformationen fest.
5. Legen Sie Dateizugriffsberechtigungen fest.

Weitere Informationen zu diesen Schritten erhalten Sie in den folgenden Abschnitten.

Festlegen der CGI-Einschränkungen

Die Common Gateway Interface (CGI)-Rolle ist nicht in der Standardinstallation von IIS 7.x oder 8.x enthalten. Um die folgenden Schritte auszuführen, müssen Sie zunächst den CGI-Rollendienst installieren. Wechseln Sie hierzu unter Windows Server 2008 zu Server Manager > Rollen > Rollendienste hinzufügen.

1. Wählen Sie links im Bereich für Verbindungen des IIS-Managers <web server name> aus.
2. Klicken Sie im unteren Bereich des Inhaltsbereichs auf die Registerkarte Features View.
3. Doppelklicken Sie auf ISAPI- und CGI-Einschränkungen (dadurch wird die Liste der definierten Einschränkungen im mittleren Bereich von IIS Manager aufgerufen).
4. Klicken Sie im Bereich Aktionen oben rechts auf Hinzufügen.
5. Stellen Sie die erforderlichen Details im Dialogfeld ISAPI hinzufügen oder CGI-Einschränkung bereit.
   1. ISAPI- oder CGI-Pfad: <em4c_location>\cgi-bin\em4c.cgi oder <em4c_location>\cgi-bin-64bit\em4c.cgi

      Hinweis:

      Ändern Sie beim Suchen nach em4c.cgiden Dateityp in Alle Dateien (*.*), da ".cgi" kein Standard-Suffix ist.

   2. Beschreibung: EM4C-CGI (beispielsweise)
   3. Ausführung des Erweiterungspfads zulassen: Aktivieren Sie diese Option.
6. Klicken Sie auf OK.

Hinzufügen einer Modulzuordnung für CGI

1. Klicken Sie im linken Bereich Verbindungen von IIS-Manager auf Standard-Website > ibmcognos > em4c > cgi-bin.
2. Wählen Sie Features View aus der unteren Leiste im Inhaltsbereich aus.
3. Doppelklicken Sie im mittleren Bereich auf Händlerzuordnungen.
4. Klicken Sie im Bereich Aktionen oben rechts auf Add Module Mapping.
5. Stellen Sie die erforderlichen Details für das Dialogfeld Add Module Mapping bereit:
   1. Anforderungspfad: *.cgi
   2. Modul: CgiModule (fastCGIModule wird nicht unterstützt)
   3. Ausführbare Datei (optional): <leer lassen>.
   4. Name: EM4C-CGI
6. Klicken Sie auf OK.

   Auf der Seite "Handler Mapping" wird EM4C-CGI als Aktiviert angezeigt.

7. Klicken Sie bei ausgewählter EM4C-CGI-Zuordnung rechts oben im Bereich Aktionen auf Edit Feature Permissions .
8. Aktivieren Sie im Dialogfeld Edit Feature Permissions das Kontrollkästchen Ausführen, um die CGI-Ausführung zu aktivieren.
9. Klicken Sie auf OK.

Festlegen von Eigenschaften für CGI-Anwendungen

1. Klicken Sie im linken Bereich Verbindungen von IIS-Manager auf Standard-Website > ibmcognos > em4c > cgi-bin.
2. Wählen Sie Features View aus der unteren Leiste im Inhaltsbereich aus.
3. Doppelklicken Sie im mittleren Bereich auf CGI.
4. Legen Sie Identität des Benutzers annehmen [createProcessAsUser] auf False fest.
5. Klicken Sie im Bereich Aktionen oben rechts auf Übernehmen.
6. Wählen Sie im Bereich Verbindungen von IIS-Manager die Website aus, in der IBM Cognos und Esri Maps for IBM Cognos ausgeführt werden (beispielsweise Standard-Website).
7. Klicken Sie im rechten Bereich Aktionen unter der Kategorie Manage Web Site auf Neu starten.
8. Schließen Sie IIS-Manager.

Festlegen von anonymen Authentifizierungsinformationen

Beim Konfigurieren von IIS 8.0 oder 8.5 müssen Sie anonyme Authentifizierungsinformationen für die cgi-bin-Anwendung festlegen.

1. Klicken Sie im linken Bereich Verbindungen von IIS-Manager auf Standard-Website > ibmcognos > em4c > cgi-bin.
2. Wählen Sie Features View aus der unteren Leiste im Inhaltsbereich aus.
3. Doppelklicken Sie im mittleren Bereich auf Authentifizierung.
4. Klicken Sie mit der rechten Maustaste auf Anonyme Authentifizierung, und klicken Sie dann auf Bearbeiten.
5. Wählen Sie im Dialogfeld Edit Anonymous Authentication Credentials die Option Application pool identity als anonyme Benutzeridentität aus. Klicken Sie auf OK.
6. Wählen Sie im Bereich Verbindungen von IIS-Manager die Website aus, in der IBM Cognos und Esri Maps for IBM Cognos ausgeführt werden (beispielsweise Standard-Website).
7. Klicken Sie im rechten Bereich Aktionen unter der Kategorie Manage Web Site auf Neu starten.
8. Schließen Sie IIS-Manager.

Festlegen der Dateizugriffsberechtigungen

Die EM4C-Technologiekomponenten benötigen Zugriff, um den Inhalt des temporären EM4C-Verzeichnisses lesen und ändern zu können. Dazu müssen Sie bestimmte Berechtigungen für den Zugriff auf die Identität gewähren, mit der EM4CAppPool ausgeführt wird. Wenn EM4CAppPool oben konfiguriert wurde, wurden die Standardeinstellungen akzeptiert. Dies bedeutet, dass der Anwendungspool als IIS-AppPool\EM4CAppPool ausgeführt wird. Wenn der Anwendungspool nicht mit diesem Konto ausgeführt wird (wenn er beispielsweise ein integriertes Konto wie Network Service, Local System oder Local Service verwendet oder eine bestimmte lokale Identität oder Identität eines Domänenbenutzers verwendet), ändern Sie nach Bedarf die folgenden Schritte.

1. Klicken Sie im Windows-Explorer mit der rechten Maustaste auf das Esri Maps for IBM Cognos-Verzeichnis "temp", und klicken Sie auf Eigenschaften.
2. Klicken Sie im Dialogfeld Eigenschaften von "temp" auf die Registerkarte Sicherheit.
3. Klicken Sie auf der Registerkarte Sicherheit auf Bearbeiten.
4. Klicken Sie im Dialogfeld Berechtigungen für "temp" auf Hinzufügen.
5. Klicken Sie im Dialogfeld Benutzer, Computer, Dienstkonten oder Gruppen auswählen auf Speicherorte.
6. Wählen Sie im Dialogfeld Speicherorte den <lokalen Server, auf dem Sie arbeiten> aus, und klicken Sie auf OK.
7. Geben Sie im Textbereich Geben Sie die Namen der auszuwählenden Objekte ein IIS-AppPool\EM4CAppPool ein, und klicken Sie auf Namen überprüfen.
8. Klicken Sie auf OK, um das Dialogfeld Benutzer oder Gruppen auswählen zu schließen.
9. Wählen Sie im Dialogfeld Eigenschaften für "temp" die Option EM4CAppPool im Bereich Gruppen- oder Benutzernamen aus, und aktivieren Sie Zulassen neben Ändern im Bereich Berechtigungen für EM4CAppPool.
10. Klicken Sie auf OK, um das Dialogfeld Berechtigungen für "temp" zu schließen.
11. Klicken Sie auf OK, um das Dialogfeld Eigenschaften für "temp" zu schließen.

Hinweis:

Bei einigen früheren Versionen von Windows 2008 funktioniert dieses Verfahren möglicherweise nicht so wie beschrieben. Sollte diese der Fall in Ihrer Umgebung sein, können Sie die Zugriffssteuerungsliste für die Identität des Anwendungspools bearbeiten. Der folgende Befehl kann über die Eingabeaufforderung (cmd.exe) als Administrator ausgeführt werden. Ändern Sie den Speicherort des temporären Verzeichnisses und den Namen des Anwendungspools entsprechend Ihrer Umgebung.

ICACLS "C:\Program Files (x86)\EsriMaps\em4c\temp" /grant "IIS AppPool\EM4CAppPool":F /t