Die Datei festival.xml ist die Basiskonfigurationsdatei für IBM®
Engineering Requirements Management DOORS - Web
Access
(DWA).
Ändern
Sie die Einträge für f:broker, f:repository-mapping und f:properties,
sodass Sie Ihrer Broker-, Repository- und Lizenzserverkonfiguration entsprechen.
Vorgehensweise
- Die Datei festival.xml enthält drei f:broker-Einträge, die
die Position des Brokers beschreiben. Bearbeiten Sie diese Einträge so, dass sie auf die URL des Systems
verweisen, auf dem Sie den Broker mit dem Standardport (61616) installiert haben. Wenn sich der Broker auf demselben System wie der
DWA-Server
befindet, müssen Sie diese Einträge nicht bearbeiten.
<!-- Brokers we know about -->
<f:endpoints>
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
<f:broker
.
url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&wireFormat.maxInactivityDuration=0"
.
.
</f:endpoints>
- Der Eintrag f:repository-mapping definiert den URN des Repositorys.
- Das Attribut name ist der Name, der auf der Anmeldeseite von
DWA
angezeigt wird. Sie können dieses Attribut ändern. Der Standardwert ist DOORS
ERS Repository.
- Das Attribut repositoryUrn muss mit dem Uniform Resource Name (URN) des Datenbankservers von
IBM Engineering Requirements
Management DOORS
(DOORS)
übereinstimmen, den Sie ermittelt haben (siehe Uniform Resource Name der Datenbank ermitteln).
Sie müssen dieses Attribut ändern.
<!-- Mapping from Repository IDs to the broker we use to reach the repository -->
<f:mappings>
<f:repository-mapping
.
.
name="DOORS ERS Repository"
repositoryUrn="urn:rational:ers-46dd5d7806b96973:" />
</f:mappings>
- Sie müssen den Abschnitt f:properties der Datei ändern.
- Erforderlich, wenn ein Lizenzserver nicht anders konfiguriert wurde, wie beispielsweise über das
Windows-Registry: Geben Sie die Position des Lizenzservers ein. Aktualisieren Sie den Wert in der folgenden Zeile:
<f:properties>
<f:property name="licence.server.location" value="19353@localhost"/>
Diese Speicherposition wird zur Liste der Lizenzspeicherpositionen hinzugefügt, die auf Ihrem System abgelegt sind.
- Optional: Sie können DWA so
einrichten, dass die URL des aktuellen Moduls in der Schnittstelle angezeigt wird. Zum Anzeigen der URLs ändern Sie value="false" in value="true" in der folgenden Zeile:
<f:property name="display.redirector.urls" value="false"/>
- Optional: Wenn die DOORS-Datenbank
ein unternehmenseigenes LDAP-Verzeichnis für die Benutzerauthentifizierung verwendet, müssen Sie eine Zeile hinzufügen,
um die Option Kennwort ändern aus der Eingangsanzeige zu entfernen. Fügen Sie die folgende Zeile hinzu:
<f:property name="change.password.enabled" value="false"/>
- Erforderlich: Setzen Sie ForceHttpsForAuthenticationForOAuth auf false:
<f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
Anmerkung: Wenn Tomcat zur Verwendung von SSL konfiguriert ist, setzen Sie
ForceHttpsForAuthenticationForOAuth auf true.
- Optional: Zum Schutz gegen CSRF-Sicherheitsattacken (cross-site
request forgery) setzen Sie disable.csrf.token auf false.
Fügen Sie die folgende Zeile hinzu:
<f:property name="disable.csrf.token" value="false"/>
- Optional: Zum Verbessern der Leistung bei alleiniger Verwendung von DOORS-Clientlizenzen
legen Sie für use.doors.client.license.only die Einstellung
true (wahr) fest. In diesem Fall überprüft die Anwendung das System nicht auf das
Vorhandensein von DWA-Reviewer- und -Editorlizenzen. Der Standardwert für diese Einstellung ist false (falsch) und hat zur Folge, dass die Anwendung nach allen Lizenztypen sucht. Fügen Sie die folgende Zeile hinzu:
<f:property name="use.doors.client.license.only" value="true"/>
- Optional: Zum Ändern des des Abschneidungsgrenzwerts für die Anzahl der Zeichen in einem Objekttitel (wie durch den
OSLC-Link gemeldet) legen Sie den Wert für dcterms.title.truncation.limit in der
Datei festival.xml fest. Standardmäßig wird das OSLC-Feld dcterms:title auf
100 Zeichen verkürzt, wenn ein DOORS-Objekt
durch einen externen OSLC-Link referenziert wird. Die verbleibenden Zeichen im Titel
werden durch Auslassungspunkte ersetzt (...). Sie können entweder diese Wert auf
0 setzten, um die Abschneidung komplett zu entfernen, oder den Wert wie gewünscht ändern. Diese Einstellung kontrolliert den Abschneidungsgrenzwert
für alle Objekttitel in allen OSLC-Integrationen. Um den Wert auf 0 zu setzen, fügen Sie die folgenden Zeile hinzu:
<f:property name="dcterms.title.truncation.limit" value="0"/>
- Die Eigenschaft rrtl.fail.on.error wirkt sich auf Berichtsservices aus, die
den ETL-Prozess (ETL = Extract, Transform and Load) nutzen. Der Wert true führt zum
Fehlschlagen der Translation Layer Reportable Rest-Ausgabe, wenn beim Empfang von Daten aus
DWA ein
Fehler auftritt. Der Fehler erleichtert der aufrufenden Anwendung das Ermitteln und Beheben von ETL-Problemen.
<f:property name="rrtl.fail.on.error" value="true" />
- Speichern und schließen Sie die Datei.