Le fichier festival.xml est le fichier de configuration principal dans
IBM®
Engineering Requirements Management DOORS - Web
Access
(DWA).
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
- 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
DWA, 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&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>
- L'entrée f:repository-mapping définit le nom URN du référentiel.
- L'attribut name correspond au nom affiché sur la page de connexion de
DWA.
Vous pouvez modifier cet attribut. La valeur par défaut est DOORS ERS Repository.
- L'attribut repositoryUrn doit correspondre au nom URN du serveur de base de données
IBM Engineering Requirements
Management DOORS
(DOORS)
que vous avez identifié dans 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>
- Vous devez changer la section f:properties du fichier.
- 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.
- Facultatif : Vous pouvez configurer DWA
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" />
- Facultatif : Si la base de données 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"/>
- 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.
- 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"/>
- Facultatif : Pour améliorer les performances lorsque seules
des licences client DOORS sont utilisées,
définissez use.doors.client.license.only à true.
Dans ce cas, l'application ne vérifie pas les licences DWA
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"/>
- 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 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"/>
- 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 DWA.
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" />
- Sauvegardez le fichier, puis fermez-le.