Jede Anwendung als TRS-Anbieter für Lifecycle Query Engine konfigurieren: Mehrere JTS-Server

Damit die Lifecycle Query Engine für jede Anwendung eine Indexierung vornehmen kann, müssen Sie den TRS-Anbieter (Tracked Resource Set, TRS) jedes Tools für die Lifecycle Query Engine registrieren.

CLM TRS konfigurieren

  1. Starten Sie den CLM-Server
  2. Öffnen Sie in einem Web-Browser https://Hostname:9444/jts/admin.
  3. Optional: Installieren Sie die TRS-Lizenz (nicht erforderlich, wenn Rational Engineering Lifecycle Manager (RELM) auf demselben JTS installiert ist).
  4. Wählen Sie in der Menüleiste "Users" und dann "Create User" aus, um den für LQE erforderlichen funktionalen Benutzer zu erstellen.
    Anmerkung: Wenn Rational Engineering Lifecycle Manager (RELM) auf demselben JTS installiert ist, müssen Sie dem Benutzer "lqe_user" lediglich die Lizenz für "TRS Consumer-Internal" zuweisen.
  5. Geben Sie die folgenden Informationen ein und klicken Sie auf "Save":
    • Geben Sie einen Namen für den Benutzer ein.
    • Geben Sie eine Benutzer-ID ein.
    • Geben Sie eine E-Mail-Adresse für den Benutzer ein.
    • Aktivieren Sie das Kästchen neben "TRS Consumer-Internal".
  6. Öffnen Sie die RTC-Verwaltungskonsole unter https://Hostname:9444/ccm/admin.
  7. Wählen Sie im linken Bereich "Consumers (Inbound)" aus und erstellen Sie einen neuen Konsumentenschlüssel für LQE. Wählen Sie dabei die Option für die Eingabe eines eigenen Schlüssels aus, geben Sie die folgenden Informationen ein und klicken Sie auf "Register":
    • Konsumentenschlüssel
    • Name: LQE
    • Geheimer Schlüssel
    • Vertrauenswürdig: ja
  8. Blättern Sie abwärts zur Liste "Authorized Keys" und bearbeiten Sie den LQE-Eintrag. Klicken Sie anschließend auf den Link "Select User", fügen Sie den Benutzer "lqe_user" hinzu und klicken Sie auf "Add" und dann auf "Close". Klicken Sie im Bearbeitungsdialogfeld auf "Finish".
  9. 9. Erstellen Sie mit der RQM-Verwaltungsanwendung unter https://Hostname:9444/qm/admin einen Schlüssel für LQE (siehe Schritte 6>8 oben).
  10. Starten Sie den RELM-Server
  11. Öffnen Sie iin einem Browser https://Hostname:9444/lqe/web.
  12. Wählen Sie "Administration" im Symbolleistenmenü aus. Wählen Sie anschließend "Data Sources" im linken Bereich aus und klicken Sie auf "Add Data Source".
  13. Wenn RELM auf demselben JTS installiert ist, sollten Sie RTC und RQM in der Liste der erkannten Anbieter auswählen können. Führen Sie andernfalls die folgenden Schritte aus:
  14. Wählen Sie "Root Services" aus und geben Sie die Root-Services-URL für RTC ein. Wählen Sie die TRS-URL aus und geben Sie eine Bezeichnung ein. Wählen Sie anschließend "Specify Authentication" aus und klicken Sie auf "Next".
    • Root-Services-URL: https://Hostname:9444/ccm/rootservices
    • Wählen Sie https://Hostname:9444/jazz/oslc/workitems/trs aus.
    • Bezeichnung: RTC
  15. Geben Sie den Konsumentenschlüssel und den geheimen Schlüssel ein und klicken Sie auf "Next".
  16. Übernehmen Sie die Standardeinstellungen und klicken Sie auf "Finish".
  17. Warten Sie, bis die Meldung angezeigt wird, dass die Indexierung der Datenquelle durchgeführt wurde.
  18. Führen Sie die Schritte 14>16 für RQM durch:
    • Root-Services-URL: https://Hostname:9444/qm/rootservices
    • Wählen Sie https://Hostname:9444/jazz/qm/trs aus.
    • Bezeichnung: RQM
    • Schlüssel:
    • Geheimer Schlüssel: wie oben eingegeben
  19. Warten Sie, bis die Meldung angezeigt wird, dass die Indexierung der Datenquelle durchgeführt wurde.
  20. Wählen Sie in der Menüleiste "User Authorization" aus und klicken Sie dann für alle neuen Anbieter auf "Authorize". Geben Sie Benutzername und Kennwort ein, wenn Sie dazu aufgefordert werden, und bestätigen Sie die Sicherheitswarnungen.
  21. 22. Rufen Sie die RELM-Abfrageseite https://Hostname:9444/relm/web auf, um die Indexdaten zu testen, und führen Sie die Abfrage "CM – QM Tested by" aus.

DOORS und DOORS Web Access als TRS-Anbieter konfigurieren

Rational DOORS und Derby enthalten im Auslieferungszustand verschiedene Standardbenutzer und -kennwörter für TRS. Sie müssen die Konfigurationsparameter für diese Benutzer wie nachfolgend beschrieben bearbeiten. Für die Integration werden folgende Benutzer verwendet:
  • LQE Functional User. Dieser Benutzer wird zur Verarbeitung von LQE-Anforderungen von einer integrierten TRS-Konsumentenanwendung an Rational DOORS Web Access verwendet. Dieser Benutzer muss in der Rational DOORS-Datenbank vorhanden sein. Sie müssen für diesen Benutzer Parameter in der Datei festival.xml angeben.
  • trs.db.user. Dieser Derby-Datenbankbenutzer hat Zugriff auf die Daten in der TRS-Datenbank. Er wird von Rational DOORS Web Access zum Abrufen von Daten aus der Datenbank verwendet. Sie müssen für diesen Benutzer in der Datei festival.xml und in der Derby-Eigenschaftendatei ein Kennwort angeben.
  • derby.user.admin. Hierbei handelt es sich um einen Derby-Datenbankadministrator. Dieser Benutzer stellt derzeit keine Funktionen für Rational DOORS Web Access oder die Derby-Datenbank zur Verfügung. Sie können für diesen Benutzer in der Derby-Eigenschaftendatei ein Kennwort angeben.
  1. Öffnen Sie [DWA_Pfad]\server\festival\config\festival.xml.
    1. Suchen Sie nach dem Abschnitt Configurable system properties.
    2. Fügen Sie unterhalb der Eigenschaft oauth.domain die in der folgenden Tabelle aufgelisteten Eigenschaften hinzu, wodurch Ihre Verwaltungs-ID und das Kennwort von DOORS ersetzt und ein Konsumentenschlüssel und geheimer Schlüssel ausgewählt werden. Die Formatierung dieser Eigenschaften muss wie folgt aussehen:
      <f:property name="functional.user.consumer.key" value="consumer_key" />
    Tabelle 1. Eigenschaften der Datei "festival.xml" für TRS und LQE.
    Eigenschaft Beschreibung/Wert
    ForceHttpsForAuthenticationForOAuth Legen Sie diesen Wert auf true fest.
    oauth.domain Legen Sie diesen Wert auf https://Server:Port/dwa fest, wobei es sich bei Server um den Domänennamen oder die IP-Adresse eines Servers handelt.
    functional.user.consumer.key Der Konsumentenschlüssel, der dem funktionalen LQE-Benutzer zugeordnet ist. Er wird von Lifecycle Query Engine für den Zugriff auf das DOORS-TRS verwendet. Dieser Schlüssel muss in der Rational DOORS-Konfiguration auf der Registerkarte Lokale Schlüssel vorhanden sein. Der Standardwert lautet LQE Functional User Key.
    functional.user.consumer.secret Der geheime Konsumentenschlüssel, der dem funktionalen LQE-Benutzer zugeordnet ist. Er wird von Lifecycle Query Engine für den Zugriff auf das DOORS-TRS verwendet. Dieser geheime Schlüssel muss in der Rational DOORS-Konfiguration auf der Registerkarte Lokale Schlüssel vorhanden sein. Der Standardwert lautet qwert6.
    functional.user.name Der Benutzername des funktionalen LQE-Benutzers. Dieser Benutzername muss ein gültiger Rational DOORS-Benutzer sein. Der Standardwert lautet LQE Functional User.
    functional.user.password Das Kennwort des funktionalen LQE-Benutzers. Der Standardwert lautet qwert6.
    trs.db.user Ein Benutzername für die TRS-Unterstützung. Aus Gründen der Einfachheit sollten Sie den Standardbenutzernamen trs.db.user verwenden.
    trs.db.password Das Kennwort für trs.db.user. Sie müssen dieses Kennwort zusätzlich in der Derby-Eigenschaftendatei angeben.
    trs.page.size Die Anzahl der TRS-Ressourcen auf einer Seite. Der Standardwert lautet 250.
    trs.enable Legen Sie diesen Wert auf true fest.
  2. Öffnen Sie die Datei derby.properties in einem Editor. Diese Datei befindet sich im Verzeichnis DWA-Installationsverzeichnis/derby.
  3. Ersetzen Sie die Kennwortwerte für die Parameter in der folgenden Tabelle.
    Tabelle 2. Parameter für TRS in der Derby-Eigenschaftendatei.
    Parameter Beschreibung
    derby.user.trs Das Kennwort für trs.db.user gemäß der Angabe in der Datei festival.xml. Der Standardwert lautet dwaTrsPa11word.
    derby.user.admin Das Kennwort für den Derby-Datenbankadministrator. Dieser Benutzer stellt derzeit keine Funktionen für Rational DOORS Web Access oder die Derby-Datenbank zur Verfügung. Der Standardwert lautet dwaTrsPa11word.
  4. Führen Sie die folgende Batchdatei aus: DWA-Installationsverzeichnis/derby.start.bat.
  5. Führen Sie die folgende Batchdatei aus: DWA-Installationsverzeichnis/derby/scripts/init_trs.bat.
  6. Aktivieren Sie die DCN-Parameter (Data Change Notifications), um den Rational DOORS-Datenbankserver für die Kommunikation mit dem Rational DOORS Web Access-Broker und dem Rational DOORS Web Access-Server zu konfigurieren. Weitere Informationen hierzu enthält der Artikel http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp?topic=/com.ibm.rational.dwa.install.doc/topics/c_setupddbs.html.
  7. Starten Sie die DOORS Web Access-Server in der folgenden Reihenfolge erneut:
    1. Broker
    2. Interoperation
    3. Datenbankserver
    4. Webanwendungsserver
  8. Melden Sie sich mit den folgenden Berechtigungsnachweisen bei Rational DOORS an:
    • Benutzername: LQE Functional User (bzw. der Name des funktionalen Benutzers, den Sie in der Datei festival.xml angegeben haben).
    • Kennwort: qwert6 (bzw. das Kennwort des funktionalen Benutzers, das Sie in der Datei festival.xml angegeben haben).
  9. Wählen Sie die zu indexierende DOORS-Datenbank aus, klicken Sie mit der rechten Maustaste auf die Datenbank und wählen Sie dann Properties aus.
  10. Wählen Sie im Dialogfeld Properties die Registerkarte Local Keys aus und klicken Sie dann auf Add.
    • Name: LQE
    • Schlüssel: xyz
    • Geheimer Schlüssel: xyz
    Klicken Sie auf "Register" und anschließend auf OK.
  11. Wählen Sie im DOORS-Client das Menü Tools aus und klicken Sie auf Configure TRS. Wählen Sie die Projekte und Module aus, die für TRS konfiguriert werden sollen. Klicken Sie anschließend auf Anwenden und dann auf Schließen.

LQE so konfigurieren, dass DOORS Web Access als Datenquelle verwendet wird

  1. Navigieren Sie zu https://JTS-Hostname:Port/lqe/web
  2. Wählen Sie im Symbolleistenmenü Administration aus.
  3. Wählen Sie anschließend auf der Seite Datenquellen die Option Datenquelle hinzufügen aus.
  4. Wählen Sie im Dialogfeld Datenquelle hinzufügen die Option für die URL des Root-Services-Dokuments aus und geben Sie die Root-Services-URL für DOORS ein. Wählen Sie die TRS-URL aus und geben Sie eine Bezeichnung ein. Wählen Sie Authentifizierungsdetails angeben aus.
    • Root-Services-URL: https://DOORS-Server:Port/dwa/rdm/discovery/rootservices
    • Wählen Sie https://DOORS-Server:Port/dwa/rm/trs aus.
    • Kennzeichnung: DOORS
    Screenshot der Datenquellenwerte für DOORS, die LQE hinzugefügt werden
  5. Geben Sie den Konsumentenschlüssel und den geheimen Schlüssel ein.
    Anmerkung: Der Konsumentenschlüssel und der geheime Schlüssel müssen mit den Werten in der Datei Festival.XML von DOORS Web Access übereinstimmen.
    <f:property name="functional.user.consumer.key" value="xyz"/>
    <f:property name="functional.user.consumer.secret" value="xyz"/>
    Screenshot des Konsumentenschlüssels und des geheimen Schlüssels
  6. Legen Sie die Anzahl der Threads für die erste und inkrementelle Indexierung auf "1" fest und klicken Sie auf Fertigstellen. Wenn zum Indexieren mehrere Threads verwendet werden, können gelegentlich Fehler auftreten.

Rhapsody DM als TRS-Anbieter konfigurieren

  1. Vergewissern Sie sich, dass der RDM-Server gestartet wurde. Installieren Sie die TRS-Lizenz und weisen Sie sie dem Benutzer "lqe_user" zu. Wenn RDM auf demselben JTS installiert ist wie RELM, ist die Lizenz bereits vorhanden.
  2. Navigieren Sie zu https://Hostname:9444/jts/admin.
  3. Wählen Sie in der Menüleiste "Users" und dann "Create User" aus, um den für LQE erforderlichen funktionalen Benutzer zu erstellen.
    Anmerkung: Wenn RELM auf demselben JTS installiert ist, müssen Sie dem Benutzer "lqe_user" lediglich die Lizenz für "TRS Consumer-Internal" zuweisen (sofern noch nicht in einem früheren Schritt erfolgt).
  4. Navigieren Sie zu https://Hostname:9444/jts/admin.
  5. Wählen Sie "Consumers (Inbound)" aus, geben Sie die folgenden LQE-Daten ein und klicken Sie auf "Register":
    • Schlüssel
    • Name: LQE
    • Geheimer Schlüssel
    • Vertrauenswürdig
    • Weisen Sie den funktionalen Benutzer "lqe_user" zu.
    Blättern Sie abwärts und bearbeiten Sie den LQE-Konsumenten, indem Sie auf das Stiftsymbol klicken. Wählen Sie den Benutzer mit Verwaltungsaufgaben in der generierten Liste der LQE-Benutzer aus.
  6. Navigieren Sie zu https://Hostname:9444/dm/web.
  7. Melden Sie sich als Benutzer mit Verwaltungsaufgaben (Schritt 5) an.
  8. Wählen Sie Ihren Projektbereich und dann "Manage Project Properties" aus. Wählen Sie "Default OSLC Context" aus und klicken Sie auf "Select". Klicken Sie anschließend auf "Default Workspace", auf "OK" und dann auf "Save".
  9. Starten Sie den RELM-Server und rufen Sie https://Hostname:9444/lqe/web auf.
  10. Melden Sie sich als Benutzer mit Verwaltungsaufgaben an und wählen Sie "Administration", "Data Sources" und "Add Data Source" aus.
  11. Wenn RELM auf demselben JTS installiert ist, sollten Sie RDM in der Liste der erkannten Anbieter auswählen können. Führen Sie andernfalls die folgenden Schritte aus.
  12. Geben Sie https://Hostname:9444/dm/rootservices ein und wählen Sie https://Hostname:9444/dm/trs aus. Geben Sie eine Bezeichnung für RDM ein, aktivieren Sie "Specify Authentication" und klicken Sie auf "Next".
  13. Geben Sie die Authentifizierungsdaten ein und klicken Sie auf "Next". Übernehmen Sie die Standardeinstellungen und klicken Sie auf "Finish".
  14. Aktualisieren Sie die Seite "Data Sources", bis "Up to Date" angezeigt wird.
  15. Wechseln Sie zu "User Authorization" und wählen Sie "Action Authorize" für DM TRS aus.
  16. Rufen Sie die RELM-Abfrageseite https://Hostname:9444/relm/web auf, um die Indexdaten zu testen, und führen Sie die Abfrage "AM Resources" aus.

Rational Engineering Lifecycle Manager als TRS-Anbieter konfigurieren

  1. Starten Sie den RELM-Server und rufen Sie https://Hostname:9444/jts/admin auf.
  2. Wählen Sie in der Menüleiste "Users" und dann "Active Users" aus, um dem Benutzer "lqe_user" die TRS-Lizenz zuzuweisen.
    Anmerkung: Dieser Schritt ist bei Installation auf demselben JTS wie RDM und CLM nicht notwendig.
  3. Wählen Sie in der Liste "Active Users" den Benutzer "lqe_user" aus.
  4. Weisen Sie dem Benutzer "lqe_user" die Lizenz für "TRS Consumer-Internal" zu.
  5. Wechseln Sie zu https://Hostname:9444/jts/admin.
    Anmerkung: Eingehende RELM-Konsumenten müssen in "jts/admin" und nicht in "relm/admin" definiert werden. Wenn RELM und RDM auf demselben JTS installiert sind, sollte dies bereits in einem früheren Schritt erledigt worden sein.
  6. Wählen Sie im linken Bereich "Consumers (Inbound)" aus und erstellen Sie einen neuen Konsumentenschlüssel für LQE mit den folgenden Angaben. Klicken Sie anschließend auf "Register" und notieren Sie sich den generierten Schlüssel:
    • Name: LQE
    • Geheimer Schlüssel
    • Vertrauenswürdig: ja
    • Generierter Schlüssel
  7. Blättern Sie abwärts zur Liste "Authorized Keys" und bearbeiten Sie den LQE-Eintrag. Klicken Sie anschließend auf den Link "Select User", fügen Sie den Benutzer "lqe_user" hinzu und klicken Sie auf "Add" und dann auf "Close". Klicken Sie im Bearbeitungsdialogfeld auf "Finish".
  8. Wechseln Sie zu https://Hostname:9444/lqe/web.
  9. Wählen Sie "Administration" im Symbolleistenmenü aus. Wählen Sie anschließend "Data Sources" im linken Bereich aus und klicken Sie auf "Add Data Source".
  10. Wenn RELM mit LQE installiert wurde, sollten Sie den Anbieter in der Liste der Datenquellen auswählen können. Wenn RELM auf dem CLM JTS installiert wurde, lautet die Quelle https://Hostname:9444/relm/rootservices.
  11. Geben Sie den Schlüssel und den geheimen Schlüssel ein. Übernehmen Sie die Standardeinstellungen und klicken Sie auf "Finish".
  12. Warten Sie, bis die Indexierung durchgeführt wurde.
  13. Wählen Sie in der Menüleiste "User Authorization" aus und klicken Sie dann für den neuen Anbieter auf "Authorize". Geben Sie Benutzername und Kennwort ein, wenn Sie dazu aufgefordert werden, und bestätigen Sie die Sicherheitswarnungen.
  14. Rufen Sie die RELM-Abfrageseite https://Hostname:9444/relm/web auf, um die Indexdaten zu testen, und führen Sie die Abfrage "All Artifacts" aus.

Benutzer in LQE berechtigen

  1. 1. Klicken Sie auf der Seite "LQE Authorization" für jeden Anbieter auf "Authorize". Melden Sie sich als "rational/rational" an, wenn Sie dazu aufgefordert werden.

Feedback