Basiskonfigurationsdatei ändern

Die Datei festival.xml ist die Basiskonfigurationsdatei in 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

  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. 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&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 Rational DOORS Web Access 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 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>
  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 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"/>
    3. 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"/>
    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 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 IBM 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"/>
  4. Speichern und schließen Sie die Datei.

Feedback