Aufgaben für den Rational-ClearQuest-Adapter in Apache Tomcat

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 Anwendung "Data Services" und die Data-Services-Adapter für Berichterstellung von Rational Publishing Engine.
  • 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 "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 einen Abfrage-URL, um ihn einer Vorlage oder Dokumentspezifikation hinzuzufügen.
Anmerkung: Die Anwendung "Data Services" unterstützt nur Abfragen mit statischen Ergebnissätzen. Dynamische Abfragen werden nicht unterstützt.

Beispiel

Mit dem 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 den Abfrage-URL bei, um ihn 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