Basiskonfigurationsdatei ändern

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

  1. 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&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
       <f:broker 
          .
          url="tcp://127.0.0.1:61616?wireFormat.tcpNoDelayEnabled=true&amp;wireFormat.maxInactivityDuration=0" 
          .
          .
             
    </f:endpoints>
  2. Der Eintrag f:repository-mapping definiert den URN des Repositorys.
    1. 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.
    2. 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>
  3. Sie müssen den Abschnitt f:properties der Datei ändern.
    1. 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.
    2. 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"/>
    3. 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"/>
    4. 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.
    5. 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"/>
    6. 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"/>
    7. 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"/>
    8. 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" />
  4. Speichern und schließen Sie die Datei.

Videosymbol Video

Jazz.net-Kanal
Software Education-Kanal

Lernsymbol Kurse

IoT Academy
Skill-Gateway

Fragesymbol Community

Jazz.net
Jazz.net-Foren
Jazz.net-Bibliothek

Supportsymbol Support

IBM Support-Community
Bereitstellungs-Wiki