Modification du fichier de configuration principal

Le fichier festival.xml est le fichier de configuration principal dans Rational DOORS Web Access. Modifiez les valeurs de f:broker, f:repository-mapping et f:properties pour qu'elles correspondent aux configurations de votre courtier, de votre référentiel et de votre serveur de licences.

Procédure

  1. Le fichier festival.xml comporte trois entrées f:broker qui décrivent où se trouve le courtier. Editez ces entrées pour pointer sur l'adresse URL du système sur lequel vous avez installé le courtier avec le port par défaut (61616). Si le courtier se trouve sur le même système que le serveur Rational DOORS Web Access, il n'est pas nécessaire d'éditer ces entrées.
    <!-- 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. L'entrée f:repository-mapping définit le nom URN du référentiel.
    1. L'attribut name correspond au nom qui est affiché sur la page de connexion de Rational DOORS Web Access. Vous pouvez modifier cet attribut. La valeur par défaut est DOORS ERS Repository.
    2. L'attribut repositoryUrn doit correspondre au nom URN du serveur de base de données Rational DOORS que vous avez identifié dans la rubrique Identification du nom URN de la base de données. Vous devez modifier cet attribut.
    <!-- 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. Vous devez changer la section f:properties du fichier.
    1. Obligatoire si aucun serveur de licences n'a été configuré par d'autres moyens, tels que le registre Windows. Entrez l'emplacement du serveur de licences. Mettez à jour la valeur sur cette ligne :
      <f:properties>
        <f:property name="licence.server.location" value="19353@localhost"/>
      Cet emplacement s'ajoute dans la liste des emplacements de licence stockés sur votre système.
    2. Facultatif : Vous pouvez configurer Rational DOORS Web Access pour afficher l'adresse URL du module en cours dans l'interface. Pour afficher les adresses URL, changez value="false" en value="true" sur cette ligne :
       <f:property name="display.redirector.urls" value="false"/>
    3. Facultatif : Si la base de données Rational DOORS utilise un protocole LDAP d'entreprise pour authentifier les utilisateurs, vous devez ajouter une ligne pour supprimer l'option Changer le mot de passe de l'écran d'accueil. Ajoutez cette ligne :
       <f:property name="change.password.enabled" value="false"/>
    4. Obligatoire : Affectez la valeur false à ForceHttpsForAuthenticationForOAuth :
       <f:property name="ForceHttpsForAuthenticationForOAuth" value="false" />
      Remarque : Si Tomcat est configuré pour utiliser SSL, affectez la valeur true à ForceHttpsForAuthenticationForOAuth.
    5. Facultatif : Pour vous protéger contre les attaques de sécurité CSRF, définissez disable.csrf.token sur false. Ajoutez cette ligne :
       <f:property name="disable.csrf.token" value="false"/>
    6. Facultatif : Pour améliorer les performances lorsque seules les licences client IBM Rational DOORS sont utilisées, définissez use.doors.client.license.only surtrue. Dans ce cas, l'application ne vérifie pas les licences IBM Rational DOORS Web Access Reviewer et Editor. La valeur par défaut de ce paramètre est false. Dans ce cas, l'application vérifie tous les types de licence. Ajoutez cette ligne :
       <f:property name="use.doors.client.license.only" value="true"/>
  4. Sauvegardez le fichier, puis fermez-le.

Commentaires en retour