Modification du fichier de configuration principal

Le fichier festival.xml est le fichier de configuration principal dans IBM® 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 sur true. Dans ce cas, l'application ne vérifie pas les licences 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"/>
    7. Facultatif : Pour modifier la limite de troncature du nombre de caractères d'un titre d'objet tel qu'indiqué dans un lien OSLC, définissez la valeur dcterms.title.truncation.limit dans le fichier festival.xml. Par défaut, la zone OSLC dcterms:title est tronquée à 100 caractères lorsqu'un objet Rational DOORS est référencé par un lien OSLC externe. Les caractères restants du titre sont remplacés par des points de suspension (...). Vous pouvez définir cette valeur sur 0 pour supprimer complètement la troncature ou modifier la valeur comme vous le souhaitez. Ce paramètre permet de contrôler la limite de troncature de tous les titres d'objet dans toutes les intégrations OSLC. Pour définir cette valeur sur zéro, ajoutez la ligne suivante :
       <f:property name="dcterms.title.truncation.limit" value="0"/>
    8. La propriété rrtl.fail.on.error affecte les services de génération de rapports qui utilisent le processus d'extraction, de transformation et de chargement (ETL). La valeur true entraîne l'échec de la sortie REST de la couche de conversion utilisable dans un rapport si une erreur se produit lors de la réception de données de Rational DOORS Web Access. L'incident facilite la détection, l'identification et la résolution des problèmes ETL par l'application appelante.
       <f:property name="rrtl.fail.on.error" value="true" />
  4. Sauvegardez le fichier, puis fermez-le.

Commentaires en retour