Die Datei festival.xml ist die Basiskonfigurationsdatei in
IBM®
Rational
DOORS Web Access.
Ä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. Befindet sich der Broker auf demselben System wie der
Rational DOORS Web
Access-Server, 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
Rational DOORS Web Access
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
Rational DOORS-Datenbankservers
ü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 Rational DOORS Web
Access 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 Rational 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
IBM Rational 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 Rational DOORS
Web Access 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 ist das OSLC-Feld dcterms:title
auf 100 Zeichen verkürzt, wenn ein Rational
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 zu einem Fehlschlagen der Translation
Layer Reportable Rest-Ausgabe, sofern beim Empfang von Daten aus Rational DOORS
Web Access ein Fehler auftritt. Der Fehler macht es der aufrufende Anwendung einfacher, ETL-Probleme
zu ermitteln und zu beheben.
<f:property name="rrtl.fail.on.error" value="true" />
- Speichern und schließen Sie die Datei.