Anwendungen als TRS-Anbieter für Lifecycle Query Engine registrieren

Wenn Sie Rational Engineering Lifecycle Manager verwenden, dann sind verschiedene Konfigurationsschritte erforderlich, um die Produkte als TRS-Provider einzurichten und Lifecycle Query Engine den Zugriff auf die entsprechenden Daten zu ermöglichen.

Nachdem Sie alle Anwendungen installiert und konfiguriert haben und Friend-Beziehungen zwischen Anwendungen auf fernen Servern erstellt haben, müssen Sie alle Anwendungen als TRS-Provider (TRS = Tracked Resource Set) definieren, sodass Lifecycle Query Engine (LQE) auf die entsprechenden Daten zugreifen kann, um den Index zu erstellen.

Voraussetzungen:
Wichtig: Wenn Ihre Anwendung sich auf einem anderen Jazz Team Server als LQE befindet, dann werden die in dieser Task generierten Schlüssel später wiederverwendet, wenn Sie Datenquellen zu Lifecycle Query Engine hinzufügen. Informationen hierzu finden Sie im Abschnitt zum Generieren des LQE-Index. Notieren Sie sich den Namen und den geheimen Schlüssel der einzelnen Schlüssel sorgfältig.

Lizenz für "TRS Consumer-Internal" zuweisen

Weisen Sie den funktionalen Benutzern lqe_user und jts_user die Lizenz für "TRS Consumer-Internal" zu.

  1. Öffnen Sie die JTS-Administrationskonsole unter https://Hostname:port/jts/admin.
  2. Wählen Sie Users > Active Users aus.
  3. Klicken Sie auf den Link lqe_user. Wechseln Sie auf der Seite lqe_user zum Bereich Client Access License und wählen Sie TRS Consumer-Internal aus. Klicken Sie dann auf Save.
    Lizenz 'TRS Consumer-Internal' für LQE-Hauptbenutzer auswählen
  4. Kehren Sie zur Seite Active Users zurück. Klicken Sie auf den Link jts_user. Wechseln Sie auf der Seite jts_user zum Bereich Client Access License und wählen Sie TRS Consumer-Internal aus.
  5. Klicken Sie auf Save.

TRS für CLM-Anwendungen konfigurieren

Wenn diese Anwendungen auf demselben Jazz Team Server wie LQE implementiert werden, müssen keine eingehenden Konsumenten erstellt werden. Führen Sie diese Schritte nur aus, wenn die Anwendungen CCM, QM und RM sich auf einem separaten Jazz Team Server-System befinden.

  1. Erstellen Sie den eingehenden LQE-Konsumentenschlüssel für CCM. Öffnen Sie die CCM-Verwaltungsseite unter https://Hostname:port/ccm/admin.
  2. Wählen Sie auf der Seite Application die Option Communication >Consumers (Inbound) aus und erstellen Sie dann einen neuen OAuth-Konsumentenschlüssel für LQE:
    • Name: LQE
    • Secret: xyz
    • Trusted: ja
    Klicken Sie auf Register.
  3. Wechseln Sie zur Liste Authorized Keys und bearbeiten Sie den LQE-Eintrag, indem Sie auf das Stiftsymbol klicken.
  4. Klicken Sie im Dialog Edit Consumer Key Properties auf den Link Select User....
  5. Geben Sie lqe in das Feld "Filter" ein und wählen Sie lqe_user aus der Liste der übereinstimmenden Benutzer aus. Klicken Sie auf Add and Close und dann auf Finish.
  6. Erstellen Sie den eingehenden LQE-Konsumentenschlüssel für QM. Öffnen Sie die QM-Verwaltungsseite unter https://Hostname:port/qm/admin und führen Sie dann die Schritte 7 bis 10 erneut aus.
  7. Erstellen Sie den eingehenden LQE-Konsumentenschlüssel für DOORS Next Generation, wenn dies Ihre RM-Anwendung ist. Öffnen Sie die RM-Verwaltungsseite unter https://Hostname:port/rm/admin und führen Sie dann die Schritte 7 bis 10 erneut aus.
  8. Registrieren Sie die Anwendungen als TRS-Anbieter und generieren Sie anschließend den zugehörigen Index. Öffnen Sie die Lifecycle Query Engine-Verwaltungsseite unter https://Hostname:port/lqe/web.
  9. Klicken Sie auf Administration > Data Sources > Add Data Source.
  10. Wählen Sie im Dialogfeld Add Data Source die Adresse https://Hostname:port/ccm/oslc/workitem/trs aus und fügen Sie die Bezeichnung RTC hinzu. Übernehmen Sie die restlichen Standardwerte (wenn ein großes Datenvolumen indexiert werden muss, dann erhöhen Sie die Anzahl der Threads für die Erstindexierung auf '4') und klicken Sie dann auf Finish.
  11. Registrieren Sie QM als TRS-Anbieter und generieren Sie anschließend den zugehörigen Index. Klicken Sie auf der Seite Data Sources auf Add Data Source.
  12. Wählen Sie im Dialogfeld Add Data Source die Adresse https://Hostname:port/qm/trs aus und fügen Sie die Bezeichnung RQM hinzu. Akzeptieren Sie die restlichen Standardwerte und klicken Sie auf Finish.
  13. Registrieren Sie RM als TRS-Anbieter und generieren Sie anschließend den zugehörigen Index. Klicken Sie auf der Seite Data Sources auf Add Data Source.
  14. Wählen Sie im Dialogfeld Add Data Source die Adresse https://Hostname:port/rm/trs aus und fügen Sie die Bezeichnung DNG hinzu. Akzeptieren Sie die restlichen Standardwerte und klicken Sie auf Finish.

Die Anwendungen Rational Team Concert, Rational Quality Manager und Rational DOORS Next Generation sind nun indexiert und stehen Rational Engineering Lifecycle Manager zur Verfügung. Weitere Informationen zu den Vorgaben für die kontinuierliche Indexierung finden Sie im Abschnitt zur Indexierung von Daten mit Lifecycle Query Engine.

DOORS und DOORS Web Access als TRS-Anbieter konfigurieren

Zum Lieferumfang von Rational DOORS Web Access gehören verschiedene Standardbenutzer und Kennwörter für die TRS-Aktivierung. Sie müssen die Konfigurationsparameter, die diesen Benutzern zugeordnet sind, wie im Folgenden 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.
  • 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 ein Kennwort für diesen Benutzer in der Derby-Eigenschaftendatei definieren.
  1. Öffnen Sie [DWA_Pfad]\server\festival\config\festival.xml.
    1. Suchen Sie nach dem Abschnitt Configurable system properties.
    2. Fügen Sie die Eigenschaften hinzu, die in der folgenden Tabelle aufgelistet sind.
      Formatierung von Eigenschaften:
      <f:property name="property_listed_in_table" value="appropriate_value_or_default_listed_in_table" />
    Tabelle 1. Eigenschaften der Datei Festival.xml für TRS und LQE
    Eigenschaft Beschreibung/Wert
    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.
    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.
    functional.user.name Der Benutzername des funktionalen LQE-Benutzers. Dieser Benutzername muss ein gültiger Rational DOORS-Benutzer sein. Vergewissern Sie sich, dass die DOORS-Benutzer-ID, die Sie in der Datei festival.xml verwenden, bereits vorhanden ist und über vollständige Zugriffsberechtigungen für die Projekte und Artefakte verfügt, die Sie im Arbeitsbereich zur Verfügung stellen.
    functional.user.password Das Kennwort des funktionalen LQE-Benutzers.
    trs.db.user Ein Benutzername für die TRS-Unterstützung. Aus Gründen der Einfachheit sollten Sie den Standardbenutzernamen trs.db.user verwenden. Wenn diese Eigenschaft nicht angegeben wird, dann verwendet das System die Standardwerte.
    trs.db.password Das Kennwort für trs.db.user. Sie müssen dieses Kennwort zusätzlich in der Derby-Eigenschaftendatei angeben. Der Standardwert lautet dwaTrsPa11word. Wenn diese Eigenschaft nicht angegeben wird, dann verwendet das System die Standardwerte.
    trs.page.size Die Anzahl der TRS-Ressourcen auf einer Seite. Der Standardwert lautet 250. Wenn diese Eigenschaft nicht angegeben wird, dann verwendet das System die Standardwerte.
    trs.enable Setzen Sie diesen Wert auf die Einstellung true.
    Der folgende Auszug auf der Datei festival.xml zeigt ein Beispiel für die Eigenschaften, die TRS zugeordnet sind:
    <f:property name="functional.user.consumer.key" value="xyz"/> 
    <f:property name="functional.user.consumer.secret" value="xyz" />
    <f:property name="functional.user.name" value="Administrator" /> 
    <f:property name="functional.user.password" value="qwert6" /> 
    <f:property name="trs.enable" value="true" />
  2. Optional: Öffnen Sie die Datei derby.properties in einem Editor. Diese Datei befindet sich im Verzeichnis dwa_install/derby.
  3. Optional: 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. Initialisieren Sie die TRS-Datenbank. Führen Sie die folgenden Scripts aus:
    • Für Windows.:
      dwa_install/derby.start.bat
      dwa_install/derby/scripts/init_trs.bat
    • Für Linux.:
      dwa_install/derby.start.sh
      dwa_install/derby/scripts/init_trs.sh
  5. Melden Sie sich beim Rational DOORS-Client als Benutzer vom Typ 'Datenbankmanager' oder 'Administrator' an.
  6. Wählen Sie File > OSLC > Local Keys aus. Klicken Sie im Fenster Local Keys auf Add. Verwenden Sie die Werte, die in der Datei festival.xml angegeben sind.
    • Consumer name: Ein beliebiger Name. Es wird die Verwendung von LQE empfohlen.
    • Consumer key: Der Wert, der für die Eigenschaft functional.user.consumer.key festgelegt wird.
    • Consumer secret: Der Wert, der für die Eigenschaft functional.user.consumer.secret festgelegt wird.
    Klicken Sie auf Register und dann auf OK.
  7. Wählen Sie File > OSLC > Working Sets aus. Wählen Sie im Fenster Select Project die Projekte, Ordner und Module aus, die für LQE zur Verfügung gestellt werden sollen.
  8. Wählen Sie alle erforderlichen Module im Teilfenster Select Modules aus. Klicken Sie auf Apply.

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

  1. Navigieren Sie zu https://hostname:port/lqe/web.
  2. Wählen Sie im Symbolleistenmenü Administration aus.
  3. Wählen Sie anschließend auf der Seite Data Sources die Option Add Data Source aus.
  4. Wählen Sie im Dialogfeld Add Data Source die Option für die URL des Root Services-Dokuments aus. Geben Sie die Root-Services-URL für DOORS ein. Wählen Sie die TRS-URL aus. Geben Sie eine Bezeichnung ein und wählen Sie dann Specify authentication details aus.
    • Root-Services-URL: https://DOORS-Server:Port/dwa/public/rootservices
    • Wählen Sie https://DOORS-Server:Port/dwa/rm/trs
    • aus. Bezeichnung: DOORS
    Screenshot der Werte für Data Source für DOORS, die zu LQE hinzugefügt werden
  5. Geben Sie den Konsumentenschlüssel und den geheimen Schlüssel ein.
    Anmerkung: Der Konsumentenschlüssel und das Konsumentengeheimnis müssen mit den Werten in der Datei festival.XML für den DOORS-Webzugriff übereinstimmen. Im folgenden Beispiel stellt der Wert xyz ein Beispiel dar.
    <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. Gelegentlich können Fehler auftreten, wenn für die Indexierung mehr als ein Thread verwendet wird.

TRS für Rhapsody Design Manager konfigurieren

  1. Rufen Sie https://hostname:port/jts/admin auf.
    Anmerkung: Eingehende Konsumenten von Design Manager werden in der Administrationskonsole von Jazz Team Server und nicht in der Design Manager-Konsole definiert.
  2. Wählen Sie Server > Consumers (Inbound) aus, geben Sie Folgendes ein und klicken Sie dann auf Register:
    • Name: LQE
    • Secret: xyz
    • Trusted: Ja
  3. Rufen Sie die Liste Authorized Keys auf und bearbeiten Sie den Eintrag LQE, indem Sie auf das Stiftsymbol klicken.
  4. Klicken Sie im Dialog Edit Consumer Key Properties auf den Link Select User....
  5. Geben Sie lqe in das Feld "Filter" ein und wählen Sie lqe_user aus der Liste der übereinstimmenden Benutzer aus. Klicken Sie auf Add and Close und dann auf Finish.
  6. Rufen Sie https://hostname:port/dm/web auf.
  7. Melden Sie sich als Benutzer mit Administratorberechtigung an.
  8. Wählen Sie Ihren Projektbereich und dann im Dropdown-Menü Administration (Symbol mit dem Zahnrad) die Option Manage Project Properties aus. Wählen Sie Default OSLC Context aus und klicken Sie dann auf Select. Klicken Sie auf den Projektnamen, dann auf OK und anschließend auf Save.
    Wählen Sie den Projektbereich aus und stellen Sie sicher, dass der OSLC-Standardkontext zugeordnet wurde.
  9. Registrieren Sie Rhapsody DM als TRS-Anbieter und generieren Sie anschließend den zugehörigen Index. Öffnen Sie die Lifecycle Query Engine-Verwaltungsseite unter https://LQE_Hostname:port/lqe/web.
  10. Klicken Sie auf Administration > Data Sources > Add Data Source.
  11. Wählen Sie im Dialogfeld Add Data Source die Adresse http://RDM_Hostname:9443/dm/trs aus und fügen Sie die Bezeichnung RDM hinzu. Übernehmen Sie die restlichen Standardwerte (wenn ein großes Datenvolumen indexiert werden muss, dann erhöhen Sie die Anzahl der Threads für die Erstindexierung auf '4') und klicken Sie dann auf Finish.

TRS für Rational Engineering Lifecycle Manager konfigurieren

Wenn es sich um eine neue Installation handelt, dann sind keine Daten für die Indexierung vorhanden. Sie können ein Beispielprojekt und ein Beispielprodukt erstellen, sodass Sie sicherstellen können, dass der Index erfolgreich erstellt werden kann.

  1. Öffnen Sie die Lifecycle Query Engine-Verwaltungsseite unter https://LQE_Hostname:port/lqe/web.
  2. Klicken Sie auf Administration > Data Sources > Add Data Source.
  3. Wählen Sie im Dialogfeld Add Data Source die Adresse http://RELM_Hostname:port/productdef/resource/tracked aus und fügen Sie die Bezeichnung RELM hinzu. Übernehmen Sie die restlichen Standardwerte (wenn ein großes Datenvolumen indexiert werden muss, dann erhöhen Sie die Anzahl der Threads für die Erstindexierung auf '4') und klicken Sie dann auf Finish.
    Datenquellenliste mit allen indexierten Komponenten.
  4. Zum Testen des Index öffnen Sie Rational Engineering Lifecycle Manager: https://RELM_Hostname:port/relm/web
  5. Wählen Sie ein Beispielprojekt aus. Wählen Sie aus dem Menü Queries die Option Shared Queries aus.
  6. Erweitern Sie den Beispielknoten und wählen Sie All Artifacts aus. Möglicherweise werden Sie dazu aufgefordert, die Berechtigung für alle Anwendungen zu erteilen, für die Sie die Abfrage ausführen. Klicken Sie auf der Seite User Authorization (https://relm_host_name:port/lqe/web/auth) neben jeder Anwendung, die Sie abfragen wollen, auf Authorize.
    Anzeige 'User Authorization'
  7. Im Abfrageergebnis wird das Beispielprodukt angezeigt, das Sie erstellt haben.

TRS für Benutzer von Jazz Team Server konfigurieren

  1. Öffnen Sie die Lifecycle Query Engine-Verwaltungsseite unter https://LQE_Hostname:port/lqe/web.
  2. Klicken Sie auf Administration > Data Sources > Add Data Source.
  3. Wählen Sie im Dialogfeld Add Data Source die Adresse http://Hostname:port/jts/trsUsers aus und fügen Sie die Bezeichnung Users hinzu. Akzeptieren Sie die restlichen Standardwerte und klicken Sie auf Finish.

Weitere Schritte

Nach der Konfiguration Ihrer Anwendungen als TRS-Provider sollten Sie nun die Schritte in Abfrage zu Test- oder Debugzwecken ausführen ausführen, um Ihre Konfiguration zu überprüfen.


Feedback