Rational DOORS als TRS-Provider konfigurieren

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

Vorbereitende Schritte

Um TRS und LQE verwenden zu können, benötigen Sie einen Rational DOORS Datenbankserver der Version 9.4.0.1 (oder höher) und die Konfiguration des Servers darf keine Rational DOORS-Clients vor Version 9.4.0.1 beinhalten. Um diese Clients auszuschließen, setzen Sie die Mindestversion des Clients auf der Registerkarte Anmelderichtlinie der Datenbankeigenschaften auf 9.4.0.1.

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:
Anmerkung: Administratoren müssen Maßnahmen ergreifen, um die Integrität der Derby-Datenbank sicherzustellen und eine Beschädigung der Datenbank zu vermeiden. Informationen finden Sie im Abschnitt zur Erhaltung der Datenbankintegrität ("Maintaining database integrity") im Handbuch Derby Server and Administration Guide.

Vorgehensweise

  1. Öffnen Sie die Datei festival.xml von Rational DOORS Web Access in einem Editor. Diese Datei befindet sich im Verzeichnis 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.
    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 Tracked Resource Set (TRS). Dieser Schlüssel muss in der Rational DOORS-Konfiguration im Fenster 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 Tracked Resource Set (TRS). Dieser geheime Schlüssel in der Rational DOORS-Konfiguration im Fenster 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 verwenden.
    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.
    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. Diese Datei befindet sich im Verzeichnis 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, das Sie in der Datei festival.xml angegeben haben. Der Standardwert lautet dwaTrsPa11word.
    derby.user.admin Das Kennwort des Derby-Datenbankadministrators. Dieser Benutzer stellt derzeit keine Funktionen für Rational DOORS Web Access zur Verfügung. Der Standardwert lautet 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 (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.
  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. das Kennwort des funktionalen Benutzers, das Sie in der Datei festival.xml angegeben haben).
  9. Wählen Sie Datei > Lokale Schlüssel aus und beachten Sie, dass das Fenster den Konsumentenschlüssel und den geheimen Schlüssel enthält, die Sie in der Datei festival.xml angegeben haben.

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="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

Wenn die Integration mit TRS-Konsumentenanwendungen mit OSLC-Friend-Beziehungen konfiguriert ist, müssen Sie Rational DOORS als TRS-Provider in der Konsumentenanwendung registrieren. Lesen Sie zum Beispiel im Information Center von IBM Rational Engineering Lifecycle Management den Abschnitt Register applications as TRS providers for the Lifecycle Query Engines.

Die Lifecycle Query Engine (LQE), die von einer TRS-Konsumentenanwendung wie Rational Engineering Lifecycle Management verwendet wird, erstellt einen Masterindex (in Form einer Datenbank) von Daten verschiedener 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:
  • Anzahl der Threads für erstmalige Indexierung: 1
  • Anzahl der Threads für inkrementelle Indexierung: 1
  • Aktualisierungsrate: 60
Legen Sie auf der Registerkarte Administration > Konfiguration > Erweiterte Eigenschaften die folgenden HTTP-Zeitlimitwerte fest. Der Standardwert beträgt 60 Sekunden. Setzen Sie beide Werte höher:
  • Verbindungszeitlimit (Minimum): 5 Minuten (300 Sekunden)
  • Socketzeitlimit (Minimum): 15 Minuten (900 Sekunden)

Feedback