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:
- LQE Functional User. Dieser Benutzer wird zur Verarbeitung von LQE-Anforderungen von einer integrierten
TRS-Konsumentenanwendung an Rational DOORS Web
Access verwendet. Der Benutzer muss in der Rational DOORS-Datenbank
enthalten 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 zur Verfügung. Sie können für diesen Benutzer in der Derby-Eigenschaftendatei ein Kennwort angeben.
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
- Ö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.
- 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 LQEEigenschaft |
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. |
- Öffnen Sie die Datei derby.properties in einem Editor. Diese Datei befindet sich im Verzeichnis DWA-Installationsverzeichnis/derby.
- 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. |
- Führen Sie die folgende Batchdatei aus: DWA-Installationsverzeichnis/derby.start.bat.
- Führen Sie die folgende Batchdatei aus: DWA-Installationsverzeichnis/derby/scripts/init_trs.bat.
- 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.
- 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).
- Wählen Sie 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)