Rational ClearQuest-Adapter unter WebSphere Application Server 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. Nehmen Sie die Pfade der gemeinsam genutzten Bibliotheken in Ihre Installation von Rational ClearQuest in den Knoten von WebSphere Application Server auf, in dem die Anwendung "Data Services" von Rational Publishing Engine implementiert ist:
    1. Klicken Sie in WebSphere Application Server auf Umgebung > Gemeinsam genutzte Bibliotheken.
    2. Um den Geltungsbereich festzulegen, wählen Sie den Eintrag Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer aus. RationalPublishingEngineNode01 ist der Standardname des Knotens, und RationalPublishingEngineServer ist der Standardname des Servers.
    3. Klicken Sie auf Neu, um die Referenz auf die gemeinsam genutzte Bibliothek zu erstellen.
    4. Geben Sie die Werte für Name, Beschreibung und Klassenpfad an. Vergewissern Sie sich, dass Ihr Klassenpfad auf die Dateien in den richtigen Speicherpositionen verweist.
      Tabelle 1. Felder zur Referenz auf die gemeinsam genutzte Bibliothek
      Beschreibung Werte
      Name ClearQuest CM API
      Beschreibung Gemeinsam genutzte Bibliothek für den ClearQuest-Adapter.
      Klassenpfad

      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.
    5. Klicken Sie auf OK und Speichern.
  2. Ordnen Sie die gemeinsam genutzten Bibliotheken von Rational ClearQuest dem Profil der Anwendung "Reporting Data Services" zu:
    1. Klicken Sie auf Server > Anwendungsserver.
    2. Klicken Sie auf den Server, auf dem Sie die Anwendung "Data Services" implementiert haben. Der Standardservername ist RationalPublishingEngineServer.
    3. Klicken Sie auf Serverinfrastruktur > Java- und Prozessverwaltung > Klassenlader.
    4. Klicken Sie auf Neu > OK, um ein Klassenladeprogramm für die gemeinsam genutzten Bibliotheken zu erstellen.
    5. Damit die Referenzen auf gemeinsam genutzte Bibliotheken dem Klassenladeprogramm zugeordnet werden, klicken Sie auf den Hyperlink des in Teilschritt 2.d erstellten neuen Klassenladeprogramms (Klassenlader).
    6. Klicken Sie für jede Bibliothek, die zugeordnet werden soll, auf Hinzufügen, wählen Sie die Bibliothek aus und klicken Sie auf OK.
    7. Klicken Sie auf Referenzen auf gemeinsam genutzte Bibliotheken.
    8. Zum Zuordnen der einzelnen Bibliotheken klicken Sie auf Hinzufügen, wählen Sie die Bibliothek aus und klicken Sie auf OK.
    9. Klicken Sie auf Speichern.
  3. Linux-Symbol Bei Verwendung von Linux konfigurieren Sie das generische JVM-Argument:
    1. Klicken Sie auf Server > Servertypen > WebSphere-Anwendungsserver.
    2. Klicken Sie auf den Servernamen.
    3. Blenden Sie im Abschnitt "Serverinfrastruktur" den Eintrag Java- und Prozessverwaltung ein und klicken Sie auf Prozessdefinition.
    4. Klicken Sie auf Java Virtual Machine.
    5. Geben Sie im Feld "Generische JVM-Argumente" Folgendes ein: Generic JVM arguments -Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib
    6. Klicken Sie auf OK.
  4. Linux-Symbol Bei Verwendung von Linux konfigurieren Sie die Umgebungsvariable LD_LIBRARY_PATH:
    1. Klicken Sie auf der Seite "Prozessdefinition" auf Umgebungseinträge und klicken Sie dann auf LD_LIBRARY_PATH.
    2. Geben Sie einen Namen ein und geben Sie den Bibliothekspfad ein. Beispiel: /opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
  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