Configuration des indicateurs d'exécution et de formatage de l'application Web Services

Vous pouvez ajouter des propriétés appelées indicateurs aux fichiers de l'application Web Services afin de spécifier certains paramètres pour vos applications.

Avant de commencer

Examinez la liste des indicateurs d'exécution et de formatage pouvant être utilisés pour l'application Web Services, puis sélectionnez celui à utiliser pour effectuer cette tâche.
Tableau 1. Indicateurs d'exécution et de formatage
Indicateur Valeur Description
-Dcom.ibm.rational.rpe.disablecommands true, false

Exemple : -Dcom.ibm.rational.rpe.disablecommands=true

Pour plus de sécurité, vous pouvez définir cet indicateur afin de désactiver l'exécution des précommandes et postcommandes par l'application Web Services.
-Dcom.ibm.rational.rpe.mc.maxerrorcount Nombre.

Exemple : -Dcom.ibm.rational.rpe.mc.maxerrorcount=

Nombre de fois que le client tente de se connecter au composant Surveillance et contrôle pour afficher un travail de génération de documents. Le nombre de fois par défaut est de 3. En général, si le serveur ne peut pas être contacté après six tentatives consécutives, le serveur est probablement arrêté et l'administrateur doit le redémarrer.
-Dcom.ibm.rational.rpe.mc.url URL.

Exemple : -Dcom.ibm.rational.rpe.mc.url=http://hôte:port/rpemc/service

URL de connexion au composant Surveillance et contrôle pour gérer les travaux de génération de documents.
-Dcom.ibm.rational.rpe.mc.user ID d'un utilisateur.

Exemple : -Dcom.ibm.rational.rpe.mc.user=client_rpe

ID utilisateur de connexion au composant Surveillance et contrôle pour gérer les travaux de génération de documents.
-Dcom.ibm.rational.rpe.mc.password Mot de passe de l'ID utilisateur.

Exemple : -Dcom.ibm.rational.rpe.mc.password=mot_de_passe

Mot de passe de connexion au composant Surveillance et contrôle pour gérer les travaux de génération de documents.
-Dcom.ibm.rational.rpe.console.limit Nombre de caractères.

Exemple : -Dcom.ibm.rational.rpe.console.limit=90000

Vous pouvez contrôler la taille des informations de journalisation conservées dans la vue de la console. Par défaut, la taille maximale est fixée à 100000 caractères.
-Dcom.ibm.rational.rpe.doors.data Argument de données à transmettre à la ligne de commande Rational DOORS

Exemple : -Dcom.ibm.rational.rpe.doors.data=36677@localhost

Vous pouvez inclure cet indicateur pour permettre à Rational Publishing Engine d'identifier votre base de données Rational DOORS. La définition de cette valeur améliore les performances lorsque Rational DOORS est stable ou que la génération de document est configurée sur une machine virtuelle sur laquelle l'exécution de la commande reg.exe est interdite.
-Dcom.ibm.rational.rpe.doors.home Chemin d'accès vers le fichier exécutable Rational DOORS

Exemple : -Dcom.ibm.rational.rpe.doors.home=C:\Program Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe

Vous pouvez inclure cet indicateur pour permettre à Rational Publishing Engine d'identifier votre version Rational DOORS. La définition de cette valeur améliore les performances lorsque Rational DOORS est stable ou que la génération de document est configurée sur une machine virtuelle sur laquelle l'exécution de la commande reg.exe est interdite.
-Dcom.ibm.rational.rpe.nonunicodefonts Noms de police non Unicode séparés par des points-virgules.

Exemple : -Dcom.ibm.rational.rpe.nonunicodefonts=Akshar

Vous pouvez spécifier des polices à utiliser dans Rational Publishing Engine qui ne correspondent pas à des polices Unicode. Les polices non Unicode que vous spécifiez doivent être installées sur l'ordinateur sur lequel les applications client sont exécutées.

Les polices non Unicode ne sont pas toujours générées correctement dans une sortie Microsoft Word. Comme police, spécifiez Arial Unicode MS ou toute autre police en mesure d'afficher ce caractère pour que la sortie soit correctement générée.

-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory Un ou plusieurs répertoires séparés par des points-virgules.

Exemple : -Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=C:\Windows\Fonts;d:\fontlib

Si des polices supplémentaires sont installées dans un répertoire autre que le répertoire par défaut du système, vous pouvez spécifier ces répertoires de polices.
-Dcom.ibm.rational.rpe.word.multipart STATIC ou DYNAMIC

Exemple : -Dcom.ibm.rational.rpe.word.multipart=DYNAMIC

Fractionnez les documents Microsoft Word en blocs pour réduire la taille de la mémoire utilisée pour générer le document. Si la valeur est STATIC, la sortie est générée lorsqu'elle est sérialisée et convertie dans un format stockable sur un réseau ou sur le disque. Les documents de grande taille peuvent être générés si la taille de segment est assez grande pour satisfaire la quantité de mémoire utilisée.

Si la valeur est DYNAMIC, la sortie est générée lorsque Rational Publishing Engine traite l'entrée de chaque section divisée par un élément de saut de section. Les sections qui contiennent des éléments de région sont sérialisées sur le disque à la fin de la génération de documents.

-Dcom.ibm.rational.rpews.url URL

Exemple : -Dcom.ibm.rational.rpews.url=http://serveur:port/rpews/

URL de connexion à l'application Web Services. Il se peut que cette URL ne soit pas éditable si l'administrateur n'autorise pas les utilisateurs à modifier l'emplacement.
-Dosgi.configuration.area Chemin d'accès au fichier

Exemple : -Dosgi.configuration.area=@user.home/Application Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

Pour modifier l'emplacement de sortie par défaut de vos générations de documents, vous pouvez modifier le chemin de ce paramètre. Spécifiez la même valeur pour les paramètres -Dosgi.instance.area et -Dosgi.configuration.area.
-Dosgi.instance.area Chemin d'accès au fichier

Exemple : -Dosgi.instance.area=@user.home/Application Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

Pour modifier l'emplacement de sortie par défaut de vos générations de documents, vous pouvez modifier le chemin de ce paramètre. Spécifiez la même valeur pour les paramètres -Dosgi.configuration.area et -Dosgi.instance.area.
-Duser.country Code pays

Exemple pour le brésilien : -Duser.country=BR -Duser.language=pt

Utilisez le code pays abrégé pour définir l'environnement local de vos générations de document. Vous devez inclure -Duser.country uniquement lorsque des traductions sont disponibles pour la langue référencée lorsque -Duser.language est utilisé.
-Duser.language Code langue

Exemple pour le japonais : -Duser.language=ja

Utilisez le code langue abrégé pour définir l'environnement local de vos générations de document. Pour plus d'exemples de codes langue, voir HTML Language Code Reference.
-Duser.timezone GMT+offset

Exemple : -Duser.timezone=GMT+02:00

Rational Publishing Engine convertit la date et l'heure en fonction du fuseau horaire de l'ordinateur sur lequel Rational Publishing Engine est installé et non du fuseau horaire du serveur sur lequel le document est généré à distance. Pour spécifier la date et l'heure du serveur, entrez GMT et le décalage horaire en heures de l'emplacement du serveur par rapport au temps moyen de Greenwich.
–Xmx<valeur>m Paramètre du segment de mémoire Java

Exemple : –Xmx512m

Diminuez la valeur de ce paramètre dans les fichiers de configuration du produit afin de permettre le démarrage de Rational Publishing Engine sur les machines virtuelles.

Augmentez la valeur afin d'améliorer les performances lors de la génération de documents de grand taille dans d'autres environnements, et non sur des machines virtuelles.

–Xmx est un paramètre Java standard qui n'est pas unique à Rational Publishing Engine.

TELELOGIC_LICENSE_FILE Valeur du serveur de licences indiquée dans la variable système TELELOGIC_LICENSE_FILE au format port@nomhôte_serveur_licences_ou_adresse_IP.

Exemple : 19353@LicenseServer2

Variable système qui indique l'adresse du serveur de licences.

Pourquoi et quand exécuter cette tâche

Vous pouvez configurer un ou plusieurs des indicateurs d'exécution et de formatage de ces serveurs d'applications :

WebSphere Application Server

Procédure

  1. Ouvrez la console d'administration dans un navigateur. Exemple : http://serveur:port/ibm/console/logon.jsp
  2. Développez Serveurs > Types de serveurs.
  3. Cliquez sur Serveurs d'applications WebSphere.
  4. Ouvrez les propriétés du serveur en cliquant sur nom_serveur.
  5. Dans la section Infrastructure du serveur, développez Gestion Java et des processus.
  6. Cliquez sur Définition de processus.
  7. Dans la section Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
  8. Dans la section Propriétés supplémentaires, cliquez sur Propriétés personnalisées.
  9. Cliquez sur Nouveau pour ajouter l'indicateur.
  10. Dans la zone Nom, entrez le nom de l'indicateur que vous avez sélectionné.
  11. Supprimez le -D au début du nom de l'indicateur que vous avez copié. Par exemple, -Dcom.ibm.rational.rpe.indicateur devient com.ibm.rational.rpe.indicateur.
  12. Dans la zone Valeur, entrez le paramètre de l'indicateur.
  13. Facultatif : Entrez une description indiquant à quoi sert l'indicateur.
  14. Cliquez sur OK.
  15. Redémarrez le serveur.

Apache Tomcat

Procédure

  1. Dans les fichiers d'applications Apache Tomcat, cliquez à l'aide du bouton droit de la souris sur le fichier startup que vous utilisez pour démarrer le serveur.
  2. Cliquez sur Propriétés.
  3. Sélectionnez l'onglet Java.
  4. Dans la zone Options Java™, entrez l'indicateur que vous avez sélectionné et sa valeur correspondante. Exemple :
    -Dcom.ibm.rational.rpe.indicateur=valeur
  5. Cliquez sur OK.
  6. Redémarrez Apache Tomcat.

Commentaires