Rational DOORS als TRS-Provider konfigurieren

Sie können IBM® Rational DOORS als Provider für Tracked Resource Sets (TRS) konfigurieren. Hierzu müssen Sie die entsprechenden Konfigurationsdateien bearbeiten und Derby-Batchdateien ausführen.

Informationen zu diesem Vorgang

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:

Vorgehensweise

  1. Öffnen Sie die Datei festival.xml von Rational DOORS Web Access in einem Editor. Die Datei befindet sich unter DWA-Installationsverzeichnis\server\festival\config.
  2. Geben Sie die Eigenschaftswerte für den funktionalen LQE-Benutzer und den TRS-Benutzer wie in der folgenden Tabelle beschrieben an. Am Ende dieses Abschnitts finden Sie Beispiele für diese Eigenschaften.
    Tabelle 1. Eigenschaften der Datei 'festival.xml' für TRS und LQE.
    Eigenschaft Beschreibung/Wert
    ForceHttpsForAuthenticationForOAuth Setzen Sie diesen Wert auf true.
    oauth.domain Setzen Sie diesen Wert auf https://server:port/dwa, wobei server ein Serverdomänenname oder eine Server-IP-Adresse ist.
    functional.user.consumer.key Der Konsumentenschlüssel, der dem funktionalen LQE-Benutzer zugeordnet ist. Er wird von der 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 der 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 Setzen Sie diesen Wert auf true.
  3. Öffnen Sie die Datei derby.properties in einem Editor. Die Datei befindet sich unter DWA-Installationsverzeichnis/derby.
  4. 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 ist dwaTrsPa11word.
    derby.user.admin Das Kennwort des Derby-Datenbankadministrators. Dieser Benutzer stellt derzeit keine Funktionen für Rational DOORS Web Access oder die Derby-Datenbank zur Verfügung. Der Standardwert ist dwaTrsPa11word.
  5. Führen Sie die folgende Batchdatei aus: DWA-Installationsverzeichnis/derby.start.bat.
  6. Führen Sie die folgende Batchdatei aus: DWA-Installationsverzeichnis/derby/scripts/init_trs.bat.
  7. Aktivieren Sie die DCN-Parameter, 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.
  8. Melden Sie sich bei Rational DOORS mit folgenden Berechtigungsnachweisen an:
    • Benutzername: LQE Functional User (bzw. der Name des funktionalen Benutzers, den Sie in der Datei festival.xml angegeben haben).
    • Kennwort: qwert6 (bzw. der Kennwort des funktionalen Benutzers, das Sie in der Datei festival.xml angegeben haben).
  9. Öffnen Sie die Datenbankeigenschaften und vergewissern Sie sich, dass die Registerkarte Lokale Schlüssel der Rational DOORS-Konfiguration den Konsumentenschlüssel und den geheimen Schlüssel enthält, die sie in der Datei festival.xml angegeben haben.
  10. Registrieren Sie Rational DOORS Web Access auf der Seite Registrierte Jazz-Anwendungen, indem Sie folgende Rational DOORS Web Access-URL verwenden: Installationspfad/dwa/public/scr.

Beispiel

Der folgende Auszug aus der Datei festival.xml dient als Beispiel für die TRS-bezogenen Eigenschaften:
<f:property name="ForceHttpsForAuthenticationForOAuth" value="true"/> 
<f:property name="oauth.domain" value="https://[server]:[port]/dwa"/>
<f:property name="functional.user.consumer.key" value="LQE Functional User Key"/> 
<f:property name="functional.user.consumer.secret" value=qwert6"/> 
<f:property name="functional.user.name" value="LQE Functional User"/> 
<f:property name="functional.user.password" value="qwert6"/> 
<f:property name="trs.enable" value="true"/>

Nächste Schritte

Die Lifecycle Query Engine (LQE), die von einer TRS-Konsumentenanwendung wie Rational Engineering Lifecycle Management (RELM) verwendet wird, erstellt einen Masterindex (in Form einer Datenbank) der Daten von verschiedenen Lebenszyklustools. Jedes TRS-Provider-Tool publiziert seine Daten über ein Tracked Resource Set. LQE kann die Daten der einzelnen Tools erfassen (oder 'indexieren'). Teams können für die indexierten Daten Abfragen (Berichte) in der Sprache SPARQL schreiben. Wenn Sie eine Datenquelle für Rational DOORS in der LQE-Verwaltungsanwendung hinzufügen, müssen Sie folgende Werte festlegen:
Legen Sie auf der Registerkarte Administration > Konfiguration > Erweiterte Eigenschaften die folgenden HTTP-Zeitlimitwerte fest. Der Standardwert beträgt 60 Sekunden. Beide Werte sollten auf 10 Minuten (600 Sekunden) erhöht werden.
  • Verbindungszeitlimit (Minimum): 10 Minuten (600 Sekunden)
  • Socketzeitlimit (Minimum): 10 Minuten (600 Sekunden)

Feedback