Rational ClearQuest-Adapter in Apache Tomcat konfigurieren

Sie können die gemeinsam genutzten Bibliotheken von IBM® Rational ClearQuest für die Anwendung "Data Services" von IBM Rational Publishing Engine verfügbar machen, sodass die Rational ClearQuest-API aus Rational Publishing Engine verwendet werden kann.

Vorbereitende Schritte

  • Rational ClearQuest muss auf demselben Computer installiert sein wie Ihr Anwendungsserver.
  • Implementieren Sie die Rational Publishing Engine Anwendung "Reporting Data Services" und die Adapter für Reporting Data Services.
  • Beheben Sie alle Probleme im Zusammenhang mit Firewall-Warnungen oder der Lizenzierung, bevor Sie die gemeinsam genutzten Bibliotheken von Rational ClearQuest konfigurieren.

Vorgehensweise

  1. Kopieren Sie die gemeinsam genutzten Bibliotheken von Rational ClearQuest aus den Anwendungsdateien von Rational ClearQuest:

    Anwendungsdateien\IBM\RationalSDLC\ClearQuest\cqjni.jar
    Anwendungsdateien\IBM\RationalSDLC\ClearQuest\stpcq.jar
    Anwendungsdateien\IBM\RationalSDLC\Common\stpcmmn.jar
    Anwendungsdateien\IBM\RationalSDLC\Common\stpwvcm.jar

    Anmerkung: Die aufgelisteten Standardwerte gelten für Rational ClearQuest 7.1. Die Pfade, die tatsächlich verwendet werden müssen, sind abhängig von der Installationsposition und der installierten Version von Rational ClearQuest. Vergewissern Sie sich, dass Ihr Klassenpfad auf die Dateien in den richtigen Speicherpositionen verweist. Die Installationsposition von Rational ClearQuest kann in IBM Installation Manager angezeigt werden. Klicken Sie dazu auf Start > Alle Programme > IBM Installation Manager > Installierte Pakete anzeigen.
  2. Fügen Sie die gemeinsam genutzten Bibliotheken von Rational ClearQuest in das Apache Tomcat-Verzeichnis %CATALINA_HOME%\lib ein.
  3. Linux-Symbol Bei Verwendung von Linux konfigurieren Sie das generische JVM-Argument:
    1. Öffnen Sie die Datei, die zum Starten des Apache-Tomcat-Servers verwendet wurde. Beispiel: %CATALINA_HOME%/bin/startup.sh
    2. Fügen Sie den folgenden Befehl am Ende der Datei hinzu:
      export JAVA_OPTS="-Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib"
  4. Linux-Symbol Bei Verwendung von Linux konfigurieren Sie die Umgebungsvariable LD_LIBRARY_PATH:
    1. Fügen Sie den folgenden Befehl am Ende der Datei hinzu, die zum Starten des Apache-Tomcat-Servers verwendet wurde:
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
    2. Speichern Sie die Änderungen in der Datei, die zum Starten des Apache Tomcat-Servers verwendet wurde.
  5. Starten Sie die Anwendung "Reporting Data Services" erneut.
  6. Überprüfen Sie, ob der Adapter von IBM Rational ClearQuest und die Bibliotheken ordnungsgemäß konfiguriert sind. Geben Sie einen URL für den Rational ClearQuest-Adapter in einem Browser ein.
    • Geben Sie Folgendes ein: http://Host:Port/DataServices/ClearQuest. Wenn die Installation ordnungsgemäß ausgeführt wurde, sehen Sie eine Liste der Rational ClearQuest-Verbindungen, so wie sie im Rational ClearQuest Maintenance Tool angezeigt werden.
    • Geben Sie Folgendes ein: http://Host:Port/DataServices/ClearQuest/Version. Wenn die Installation ordnungsgemäß ausgeführt wurde, sehen Sie eine Liste mit Rational ClearQuest-Benutzerdatenbanken.
    • Geben Sie Folgendes ein: http://Host:Port/DataServices/ClearQuest/Version/Datenbankname. Wenn die Installation ordnungsgemäß ausgeführt wurde, sehen Sie eine Liste mit Abfragen.

Nächste Schritte

Kopieren Sie eine Abfrage-URL, um sie einer Vorlage oder Dokumentspezifikation hinzuzufügen.
Anmerkung: Die Anwendung "Reporting Data Services" unterstützt nur Abfragen mit statischen Ergebnissätzen. Dynamische Abfragen werden nicht unterstützt.

Beispiel

Mit der URL für die Abfrage All Defects erhalten Sie einen Ergebnissatz mit der Anzahl der Treffer, die eine Abfrage für den Rational ClearQuest-Client zurückgeben würde. Jedes Ergebnis ist eine eindeutige DBID für einen bestimmten Datensatztyp. Sie können diesen Prozess so lange fortsetzen, bis Sie einen Treffer für die Daten eines spezifischen Datensatzes erhalten. Behalten Sie die Abfrage-URL bei, um sie für die Berichterstellung in Rational Publishing Engine zu verwenden.

Entfernen Sie das Fragezeichen und die Argumente nach dem Fragezeichen:

Vorher: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
Nachher: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


Feedback