Berichtsserver konfigurieren: Aufgaben für Oracle Server
Richten Sie die Java Runtime
Environment ein, erstellen Sie einen Oracle Listener- und einen Oracle Net-Service, konfigurieren Sie Oracle als Cognos-Content-Store, konfigurieren Sie die IBM WebSphere Application
Server-Instanz als Host für den Berichtsserver, erstellen und implementieren Sie die EAR-Dateien, installieren Sie die EAR-Dateien und erstellen Sie die Data-Warehouses.
Warum und wann dieser Vorgang ausgeführt wird
So konfigurieren Sie den Berichtsserver:
Anmerkung: Schritt 1 und die Schritte 5 bis 16 sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Erstellen Sie eine Content-Store-Datenbank:
Anmerkung: Vergewissern Sie sich, dass Sie als aktueller Benutzer über die erforderlichen Verwaltungsberechtigungen zum Erstellen von Datenbanken und Tabellenbereichscontainern verfügen. Der aktuelle Benutzer kann während der Ausführung eine Verbindung zum Cognos-Content-Store herstellen. Wenn Sie möchten, dass auch andere Benutzer während der Ausführung eine Verbindung zum Cognos-Content-Store herstellen können, finden Sie entsprechende Anweisungen im IBM Cognos 8 Business Intelligence-Installations- und Konfigurationshandbuch.
- Melden Sie sich als Oracle-Datenbankadministrator-Benutzer an.
- Wechseln Sie in das Verzeichnis /opt/ibm/RationalInsight/reportal/contentstore.
- Wechseln Sie zum Rootbenutzer, indem Sie den Befehl su ausführen.
Wenn Sie dazu aufgefordert werden, geben Sie das Rootkennwort ein.
- Legen Sie die Berechtigungen für die Dateien und Ordner fest, indem Sie den folgenden Befehl ausführen:
chown oinstall.oinstall /opt/ibm/RationalInsight/reportal/contentstore -R
- Kehren Sie zur Datenbankadministratorkonsole zurück und führen Sie das Shell-Script install.sh mithilfe des folgenden Befehls aus:
[oinstall@VEGAVM contentstore]$ ./install.sh
- Wenn Sie dazu aufgefordert werden, geben Sie die Parameter für den Content-Store an. Eine Liste der Parameter und ihrer Erläuterungen können Sie über die zugehörigen Links am unteren Rand dieser Seite aufrufen.
- So erstellen Sie den Listener:
- Legen Sie die Systemvariable ORACLE_SID=$SID fest. Dabei ist $SID die Datenbank, die Sie in Schritt 1 erstellt haben.
- Starten Sie Oracle Net Manager.
- Erweitern Sie die Knoten und wählen Sie Listeners aus.
Klicken Sie auf .
- Geben Sie den Namen des Listeners ein und klicken Sie auf OK.
- Klicken Sie auf Add Address und geben Sie den Host und den Port für Rational Insight
Data Services an.
- Klicken Sie auf Add Database geben Sie den Datenbanknamen, das Ausgangsverzeichnis und die SID ein und klicken Sie auf .
- Starten Sie den Listener mithilfe des folgenden Befehls:
lsnrctl start
- So erstellen Sie den Servicenamen:
- Starten Sie den Konfigurationsassistenten von Oracle Net.
- Wählen Sie die Konfiguration Local Net Service Name aus und klicken Sie auf Weiter.
- Wählen Sie Hinzufügen aus und klicken Sie auf Weiter.
- Geben Sie den Servicenamen ein und klicken Sie auf Weiter.
- Wählen Sie ein Protokoll aus und klicken Sie auf Weiter.
- Geben Sie den Hostnamen und den Port ein. Wählen Sie Yes,
perform a test aus, klicken Sie auf Weiter, ändern Sie ggf. die Anmeldedaten und vergewissern Sie sich, dass der Test für die Verbindung erfolgreich ausgeführt wird.
- Geben Sie den Namen des Netzservices ein und klicken Sie auf Weiter.
- Damit Probleme mit der Verschlüsselung vermieden werden können, richten Sie die Java Runtime Environment (JRE) so ein, dass Cognos und der Berichtsserver auf derselben JRE-Instanz ausgeführt werden:
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Legen Sie die Variable JAVA_HOME so fest, dass sie auf den JRE-Ordner vonWebSphere Application Server zeigt, und fügen Sie am Anfang des Systempfads %JAVA_HOME%\bin ein:
JAVA_HOME=[WAS_VERZ]\java\jre
PATH=%JAVA_HOME%\bin;…
- Kopieren Sie die Datei [Rational_Insight_Installationsverzeichnis]/cognos/bin/jre/1.5.0/lib/ext/bcprov-jdk14-134.jar in das Verzeichnis [WebSphere_Installationsverzeichnis]/java/jre/lib/ext.
- Vergewissern Sie sich, dass die richtigen Oracle-Treiber im Verzeichnis [Rational_Insight_Installationsverzeichnis]/cognos/webapps/p2pd/WEB-INF/lib installiert sind:
- Oracle 10g: ojdbc14.jar
- Oracle 11g: ojdbc5.jar
- Löschen Sie den auf Tomcat basierenden Service IBM Cognos:
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Starten Sie die Cognos-Verwaltungskonsole (führen Sie die Datei cogconfig.sh unter /opt/ibm/RationalInsight/cognos/bin aus).
- Klicken Sie mit der rechten Maustaste auf den Knoten IBM Cognos 8, wählen Sie Löschen aus und klicken Sie auf Ja.
- Klicken Sie auf Sichern und anschließend auf Schließen.
- Erstellen Sie einen neuen Content-Store in Cognos, um auf die Content-Datenbank zu verweisen:
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Starten Sie die Cognos-Verwaltungskonsole (führen Sie die Datei cogconfig.sh unter /opt/ibm/RationalInsight/cognos/bin aus).
- Klicken Sie auf , klicken Sie mit der rechten Maustaste auf Content-Store und wählen Sie aus.
- Geben Sie in das Feld Datenbankname den Namen der Datenbank ein, die in Schritt 1 erstellt wurde.
- Wählen Sie die Zeile User ID and password aus, klicken Sie auf das Bearbeitungssymbol und geben Sie einen Benutzernamen und ein Kennwort für den Zugriff auf den in Schritt 1 erstellten Datenbank-Content-Store ein.
- Wählen Sie Local Configuration aus und klicken Sie auf Save configuration.
- Erstellen Sie eine neue WebSphere Application Server-Instanz als Host für den Berichtsserver. Dieser Schritt ist nicht erforderlich, wenn Sie sich dafür entschieden haben, WebSphere Application Server über das Installationsprogramm von Rational Insight zu installieren.
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Wenn Sie Änderungen an der Cognos-Konfiguration vorgenommen haben, müssen Sie WebSphere Application Server erneut starten.
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Konfigurieren Sie die WebSphere Application Server-Instanz als Host für den Berichtsserver:
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Öffnen Sie die WebSphere Application Server-Verwaltungskonsole (öffnen Sie einen Browser und geben Sie die Adresse http://localhost:9060/ibm/console/ ein).
- Ersetzen Sie Port 9060 durch eine andere Portnummer, wenn sie sich von den Datensätzen des Tools WebSphere Application Server Profile Management unterscheidet.
- Melden Sie sich bei der WebSphere Application Server-Verwaltungskonsole an (geben Sie in den Browser die Adresse http://localhost:portnumber/ibm/console/login.do ein und geben Sie Ihren Benutzernamen und das Kennwort ein).
- Erweitern Sie in der linken Aktionsleiste den Knoten Servers und wählen Sie Application servers aus.
- Klicken Sie auf den Link RationalInsightServer und erweitern Sie den Knoten Java and Process Management.
- Klicken Sie auf die Links Process Definition und Java Virtual Machine.
- Geben Sie als anfängliche und maximale Größe des Heapspeichers der Java Virtual Machine 256 bzw. 768 ein.
- Klicken Sie auf Anwenden (am unteren Rand der Seite) und wählen Sie den Link Sichern aus.
- Klicken Sie auf den Link Environment Entries.
- Klicken Sie auf Neu und fügen Sie die folgende Eigenschaft hinzu:
LD_LIBRARY_PATH=[INSTALLVERZ]\cognos\bin
- Klicken Sie auf OK und auf Neu und fügen Sie die folgende Eigenschaft hinzu:
PATH=[INSTALLVERZ]\cognos\bin
- Klicken Sie auf Anwenden und anschließend auf Sichern.
- EAR-Datei des Berichtsservers erstellen und implementieren:
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Öffnen Sie die WebSphere Application Server-Verwaltungskonsole (öffnen Sie einen Browser und geben Sie die Adresse http://localhost:9060/ibm/console/ ein).
- Wählen Sie Umgebung aus und ändern Sie alle Portnummern von 9300 in die Portnummer des WebSphere Application Server-Profils.
- Wählen Sie Portal Services aus und ändern Sie alle Portnummern von 9300 in die Portnummer des WebSphere Application Server-Profils.
- Klicken Sie auf Sichern und anschließend auf Schließen.
- Wählen Sie aus.
- Klicken Sie auf Weiter, übernehmen Sie die Standardwerte und klicken Sie erneut auf Weiter.
- Klicken Sie auf Fertig stellen und auf Schließen.
- EAR-Datei des Berichtsservers installieren:
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Melden Sie sich an der WebSphere Application Server-Verwaltungskonsole an (geben Sie in den Browser die Adresse http://localhost:port/ibm/console/login.do ein und geben Sie Ihren Benutzernamen und das Kennwort ein).
- Erweitern Sie in der linken Aktionsleiste den Knoten Applications und wählen Sie Install New Application aus.
- Klicken Sie auf Durchsuchen wechseln Sie zum Ordner [Rational_Insight_Installationsverzeichnis]\cognos und wählen Sie die Datei p2pd.ear aus.
- Übernehmen Sie die Standardoptionen und klicken Sie auf Weiter.
Führen Sie diesen Schritt viermal aus.
- Wählen Sie den Link Sichern aus und klicken Sie in der linken Aktionsleiste auf Enterprise Applications. Wenn "Default Application" aufgelistet ist, müssen Sie die Anwendung deinstallieren.
- Kopieren Sie die statischen Dateien mit Cognos-Webinhalten aus dem Verzeichnis [Rational_Insight_Installationsverzeichnis]\cognos\webcontent\*.* in das erweiterte Webarchivverzeichnis der Anwendung. Beispiel für ein Webarchivverzeichnis: [WAS_VERZ]\profiles\RationalInsight\installedApps\vega9Node01Cell\IBM Cognos 8.ear\p2pd.war.
- Wählen Sie die Anwendung IBM Cognos 8 aus und klicken Sie auf Start. Es dauert einige Minuten, bis die Anwendung vollständig geladen ist und gestartet wird.
- Öffnen Sie einen Browser und geben Sie die Adresse http://server:port/insight/servlet ein.
Wenn Cognos Content Manager ordnungsgemäß funktioniert, wird auf der Webseite Text angezeigt, der in etwa wie folgt aussieht:
IBM Cognos 8
Content Manager
Build: 8.4.2519.0
Start time: Tuesday, November 18, 2008 3:00:41 PM PST
Current time: Tuesday, November 18, 2008 3:01:25 PM PST
State: Running.
- Geben Sie in den Web-Browser folgende Adresse ein: http://host:port/insight. Jetzt sollte die Homepage des Rational Insight-Portals angezeigt werden.
- WAR-Datei für Hilfedokumente implementieren:
- Starten Sie die WebSphere Application Server-Verwaltungskonsole (geben Sie in den Browser die Adresse http://localhost:9060/ibm/console/login.do ein).
- Wählen Sie aus.
- Klicken Sie auf Durchsuchen und suchen Sie die WAR-Datei INSIGHThelp.war. Das Standardverzeichnis lautet C:\Program Files\IBM\Rational Insight\UA. Geben Sie als Kontextstammverzeichnis help an und klicken Sie auf Weiter.
- Klicken Sie auf der Seite Select installation options auf Weiter.
- Klicken Sie auf der Seite Map modules to servers auf Weiter.
- Klicken Sie auf der Seite Map virtual hosts for Web modules auf Weiter.
- Klicken Sie auf der Seite Summary auf Fertig stellen.
- Klicken Sie auf Sichern.
- Oberfläche von Rational Insight installieren:
- Öffnen Sie die Cognos-Webanwendung unter http://host/cognos8/cgi-bin/cognos.cgi.
- Öffnen Sie die Cognos-Verwaltungsseite ().
- Klicken Sie auf die Registerkarte Configuration.
- Klicken Sie im Navigationsfenster am linken Bildschirmrand auf Styles.
- Klicken Sie auf New Style.
- Geben Sie in das Feld Name Rational Insight ein und klicken Sie auf Weiter.
- Geben Sie in das Feld Style resource location die Zeichenfolge vega ein.
- Geben Sie in das Feld Preview resource die Zeichenfolge preview.htm ein.
- Klicken Sie auf Fertig stellen.
- Oberfläche von Rational Insight auswählen:
- Öffnen Sie die Cognos-Homepage unter http://host/cognos8/cgi-bin/cognos.cgi.
- Klicken Sie auf My Area und auf My Preferences.
- Wählen Sie im Feld Style die Option Rational Insight aus und klicken Sie auf OK.
- Legen Sie die Oberfläche von Rational Insight als Standardoberfläche fest:
- Öffnen Sie die Cognos-Homepage unter http://host/cognos8/cgi-bin/cognos.cgi. Vergewissern Sie sich, dass Sie über Administratorberechtigungen verfügen.
- Klicken Sie auf Security.
- Klicken Sie auf Cognos.
- Klicken Sie auf das Symbol zum Bearbeiten des Standardbenutzerprofils (links neben der Suchschaltfläche).
- Klicken Sie auf Preferences.
- Wählen Sie im Feld Style die Option Rational Insight aus und klicken Sie auf OK.
- Rational Insight-Musterberichte importieren:
Anmerkung: Diese Schritte sind nicht erforderlich, wenn Sie sich für die automatische Installation des Berichtsservers entschieden haben.
- Kopieren Sie die Datei [Rational_Insight_Installationsverzeichnis]/reportal/deployment/Rational_Example_Reports.zip in das Verzeichnis [Rational_Insight_Installationsverzeichnis]/cognos/deployment/.
- Öffnen Sie die Cognos-Webanwendung unter http://host/cognos8/cgi-bin/cognos.cgi.
- Öffnen Sie die Cognos-Verwaltungsseite ().
- Klicken Sie auf Configuration.
- Klicken Sie auf Content Administration und wählen Sie das Symbol für neuen Import aus.
- Vergewissern Sie sich, dass Rational_Example_Reports als Implementierungsarchiv aufgelistet ist, und klicken Sie auf Weiter.
- Ändern Sie im Feld "Name" den Namen von Rational_Example_Reports in Rational_Reports und klicken Sie auf Weiter.
- Wählen Sie zum Importieren aller Pakete und Ordner das Feld in der Tabellenüberschrift aus und klicken Sie viermal auf Weiter.
- Klicken Sie auf Fertig stellen.
- Klicken Sie auf Ausführen.
- Klicken Sie auf OK.
- Klicken Sie auf das Homepagesymbol.
- Überprüfen Sie, ob alle Pakete und Ordner in Öffentliche Ordner aufgelistet sind.
- XML-Datenkonfigurationsdatei ändern:
Die Konfigurationsdateien für die Musterdaten definieren die Standardzuordnungen für alle Schablonen und Musterdaten aller Produkte. Sichern Sie die Konfigurationsdateien für die XML-Musterdaten und passen Sie anschließend die Dateien an Ihre Umgebung an. Ressourcengruppen werden auf den folgenden Ebenen definiert:
- Rational ClearQuest: Auf der Ebene der Benutzerdatenbank
- Rational ClearCase: Auf der Ansichtsebene
- Rational Quality Manager: Im Stammverzeichnis des REST-Services
- Rational Team
Concert: Auf der Projektebene
- Starten Sie XML Data Configuration.
- Klicken Sie auf , wechseln Sie in das Verzeichnis, in dem sich die Datenkonfigurationsdateien befinden, und öffnen Sie die Konfigurationsdatei für die Produktdaten, z. B. clearcase.xdc. Das Standardverzeichnis lautet C:/Program Files/IBM/Rational Insight/dataconfig/configs.
Wenn Sie dazu aufgefordert werden, ein ETL-Projekt zu erstellen, klicken Sie auf OK.
- Erweitern Sie im XML-Daten-Explorer die Baumstruktur, bis die Ressourcengruppen angezeigt werden (). Die Ressourcengruppen werden durch die Symbole für Datenquellen dargestellt.
- Löschen Sie alle nicht anwendbaren Ressourcengruppendefinitionen.
- Klicken Sie doppelt auf die anwendbare Ressourcengruppe und wählen Sie Bearbeiten aus.
- Geben Sie in das Feld Datenservice die URL der Ressourcengruppe auf dem Server ein, auf dem Rational Insight
Data Services installiert ist.
Die Syntax der URL lautet http://host:port/DataServices/Name des Adapters/Name der Ressource. Dabei ist host der Name des Rational Insight
Data Services-Servers, port der von Rational Insight
Data Services verwendete Port, DataServices das Stammverzeichnis, in dem Rational Insight
Data Services installiert ist, Name des Adapters der Name des Produkts für die Datenquelle und Name der Ressource der Name der Produktressource.
Beispiel: http://host:9080/DataServices/ClearQuest/ALM/SAMPL.
- Klicken Sie auf .
- Wiederholen Sie die Schritte e bis g für alle Ressourcengruppen der Produktdatenquelle.
- Wiederholen Sie die Schritte b bis h für alle anderen Produkte.
- Testen Sie die Cognos-Datenquellenverbindungen für das Data-Warehouse und die unterstützten Produkte:
- Starten Sie die Verwaltungskonsole für WebSphere Application Server. Die Standard-URL lautet http://localhost:9060/ibm/console/login.do.
- Öffnen Sie die Cognos-Verwaltungsseite (klicken Sie hierzu auf oder, wenn Sie sich auf der Rational Insight-Einführungsseite befinden, klicken Sie im Banner auf den Link "Administration").
- Klicken Sie auf .
- Klicken Sie auf die Aktion Set properties für die Datenquelle RIDW.
- Klicken Sie auf Connection, wählen Sie das Feld Connection string aus und klicken Sie auf das Bearbeitungssymbol (das Stiftsymbol rechts neben dem Feld).
- Vergewissern Sie sich, dass im Feld Connection string die Zeichenfolge SAMPLEDW als Datenbankname angegeben wurde.
- Testen Sie die Verbindung.
- Klicken Sie zweimal auf OK.
- Klicken Sie auf .
- Klicken Sie für die Produktdatenquelle auf die Aktion Set properties, z. B. für ClearQuest.
- Klicken Sie auf Connection, wählen Sie das Feld Connection string aus und klicken Sie auf das Bearbeitungssymbol (das Stiftsymbol rechts neben dem Feld).
- Klicken Sie zweimal auf OK.
- Führen Sie einen Testlauf für die Rational Insight-Musterberichte aus:
- Öffnen Sie die Cognos-Webanwendung unter http://server:port/insight.
- Klicken Sie auf den Ordner Sample Report Definitions.
- Führen Sie die Berichte aus.
- Erstellen Sie einen Benutzer für den Zugriff auf die Datenquelle:
- Öffnen Sie die Cognos-Verwaltungsseite (klicken Sie auf IBM Cognos Administration oder, wenn Sie sich auf der Standardhomepage von IBM Cognos befinden, klicken Sie auf ).
- Klicken Sie auf .
- Klicken Sie auf RIDW.
- Klicken Sie auf New Signon, geben Sie einen Namen ein und klicken Sie auf Weiter.
- Geben Sie die Benutzer-ID und das Kennwort für den Zugriff auf die Datenquelle ein.
Zum Ausführen von Berichten muss ein Benutzer mindestens über Leseberechtigungen für die Datenquelle verfügen.