Configuration des indicateurs d'exécution et des indicateurs de formatage pour l'application Services distants sur WebSphere Application Server

Vous pouvez ajouter des propriétés appelées indicateurs aux fichiers d'application Services distants 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 Services distants, puis sélectionnez celui à utiliser pour effectuer cette tâche.
Tableau 1. Indicateurs d'exécution et de formatage
Indicateur Valeur Type Description
-Dcom.ibm.rational.rpe.config.oslcServiceProviders Chemin de fichier complet, chemin UNC ou emplacement HTTP
Exemple :

-Dcom.ibm.rational.rpe.config.oslcServiceProviders=
C:\rpe\oslcServiceProviders.xml

Indicateur Rational Publishing Engine Pour configurer la méthode d'authentification OAuth-OSLC pour les sources de données Rational DOORS Web Access. Vous devez entrer des valeurs de propriété base_url, consumer_key et secret correctes dans le fichier oslcServiceProviders.xml spécifié pour cet indicateur. Pour plus d'informations, voir Création du fichier oslcServiceProviders.xml pour l'authentification OAuth-OSLC et consultez l'exemple figurant dans le répertoire d'installation de Rational Publishing Engine : RPE_HOME/config/oslcServiceProviders-sample.xml
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd Chaîne

Exemple : -Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd=password

Indicateur Rational Publishing Engine Mot de passe requis pour l'exécution de l'authentification OAuth-OSLC avec l'indicateur -Dcom.ibm.rational.rpe.config.oslcServiceProviders.
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr Chaîne

Exemple : -Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr=user

Indicateur Rational Publishing Engine Nom d'utilisateur requis pour l'exécution de l'authentification OAuth-OSLC avec l'indicateur -Dcom.ibm.rational.rpe.config.oslcServiceProviders.
-Dcom.ibm.rational.rpe.enable_commands true, false

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

Indicateur Rational Publishing Engine Associez cet indicateur à la valeur true afin d'activer l'exécution des précommandes et des postcommandes pour l'application des services distants.
-Dcom.ibm.rational.rpe.mc.maxerrorcount Un nombre

Valeur par défaut : 3

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

Indicateur Rational Publishing Engine 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. 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.console.limit Nombre de caractères.

Valeur par défaut : 100000 caractères

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

Indicateur Rational Publishing Engine Vous pouvez contrôler la taille des informations de journalisation conservées dans la vue Console.
-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

Indicateur Rational Publishing Engine Vous pouvez inclure cet indicateur pour identifier votre base de données Rational DOORS de sorte que Rational Publishing Engine n'ait pas à l'identifier. 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 un ordinateur sur lequel l'exécution de la commande reg.exe est interdite. Lorsque cet indicateur est configuré, il remplace la valeur spécifiée pour la propriété doors_param dans une spécification de document. Vous pouvez indiquer cet indicateur en tant que variable système ou en tant que variable Java™ Runtime. Les variables Java sont prioritaires sur les variables système.

Vous devez définir la propriété new_instance sur true lors de la configuration de cet indicateur.

-Dcom.ibm.rational.rpe.doors.flags Options de ligne de commande Rational DOORS

Exemple : -Dcom.ibm.rational.rpe.doors.flags="-addins file path"

Indicateur Rational Publishing Engine Vous pouvez indiquer des options de ligne de commande pour Rational DOORS. Vous pouvez indiquer cet indicateur en tant que variable système ou en tant que variable Java Runtime. Les variables Java sont prioritaires sur les variables système.
-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

Indicateur Rational Publishing Engine Vous pouvez inclure cet indicateur pour identifier votre version de Rational DOORS de sorte que Rational Publishing Engine n'ait pas à l'identifier. 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. Lorsque cet indicateur est configuré, il remplace la valeur spécifiée pour la propriété doors_home dans une spécification de document. Vous pouvez indiquer cet indicateur en tant que variable système ou en tant que variable Java Runtime. Les variables Java sont prioritaires sur les variables système.

Vous devez définir la propriété new_instance sur true lors de la configuration de cet indicateur.

-Dcom.ibm.rational.rpe.dxl.enable.memory.management true, false

Valeur par défaut : false

Exemple : -Dcom.ibm.rational.rpe.dxl.enable.memory.management=true

Indicateur Rational Publishing Engine

Lorsqu'un module Rational DOORS est lié à d'autres modules, Rational Publishing Engine doit ouvrir ces modules liés en arrière-plan lors de la génération d'un document. En outre, lorsque du code DXL de présentation est utilisé, les modules sont ouverts en arrière-plan jusqu'à la fin de l'exécution du code DXL.

Dans tous les cas, la mémoire du client Rational DOORS est utilisée pour l'ouverture et la fermeture des modules en arrière-plan. Vous pouvez configurer une clé de registre lorsque la limite de mémoire est atteinte, de sorte que les processus en arrière-plan se ferment lorsqu'ils ont terminé de lire l'objet en cours et ils ne rouvrent l'objet que si nécessaire.

Lorsque -Dcom.ibm.rational.rpe.dxl.enable.memory.management est défini sur true, les utilisateurs peuvent définir une clé de registre pour définir cette limite de mémoire, sinon la limite de mémoire par défaut de 2 Go du code DXL est utilisée. Pour plus d'informations sur la clé de registre, voir Traitement des incidents de génération de document Rational DOORS.

La valeur par défaut est false et la clé de registre n'a pas d'effet sur le processus de génération de document.

-Dcom.ibm.rational.rpe.enable.surrogate.char.processing true, false

Valeur par défaut : false

Exemple : -Dcom.ibm.rational.rpe.enable.surrogate.char.processing=true

Indicateur Rational Publishing Engine Dans les sorties Microsoft Word et PDF, les substitutions Unicode (généralement des caractères asiatiques) sont retirés de la sortie. Vous pouvez activer le -Dcom.ibm.rational.rpe.enable.surrogate.char.processing pour traiter correctement ces caractères pendant la génération de document afin qu'ils soient inclus dans la sortie.
-Dcom.ibm.rational.rpe.nonunicodefonts Noms de police non Unicode séparés par des points-virgules.

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

Indicateur Rational Publishing Engine 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.output.default Répertoire temp

Valeur par défaut : TEMP\rpe\output

Exemple : -Dcom.ibm.rational.rpe.output.default=C:\RPE\output

Indicateur Rational Publishing Engine Vous pouvez remplacer le répertoire temporaire par un emplacement différent de l'emplacement par défaut. Vous pouvez indiquer cet indicateur en tant que variable système ou en tant que variable Java Runtime. Les variables Java sont prioritaires sur les variables système.
-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

Indicateur Rational Publishing Engine 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.rpews.scheduler.pwd Mot de passe utilisateur permettant de s'authentifier auprès du planificateur de rapport.

Exemple : -Dcom.ibm.rational.rpe.rpews.scheduler.pwd=password

Indicateur Rational Publishing Engine Pour l'authentification auprès du composant Planificateur de rapport de l'application Services distants, configurez cet indicateur avec un mot de passe.
-Dcom.ibm.rational.rpe.rpews.scheduler.url URL du planificateur de rapport.
Exemple :

-Dcom.ibm.rational.rpe.rpews.scheduler.url=
http://server:port/rpews/scheduler

Indicateur Rational Publishing Engine Pour l'authentification auprès du composant Planificateur de rapport de l'application Services distants, configurez cet indicateur avec une URL.
-Dcom.ibm.rational.rpe.rpews.scheduler.usr Nom d'utilisateur permettant de s'authentifier auprès du planificateur de rapport.

Exemple : -Dcom.ibm.rational.rpe.rpews.scheduler.usr=user

Indicateur Rational Publishing Engine Pour l'authentification auprès du composant Planificateur de rapport de l'application Services distants, configurez cet indicateur avec un nom d'utilisateur.
-Dcom.ibm.rational.rpe.wstimeout Temps en millisecondes

Valeur par défaut : 30000 millisecondes

Exemple : -Dcom.ibm.rational.rpe.wstimeout=35000

Indicateur Rational Publishing Engine L'application Launcher dépasse le délai d'attente lors de la création de spécifications de document complexes qui sont configurées pour l'utilisation d'un moteur de publication à distance. Si vous estimez que le client dépasse trop tôt le délai d'attente, augmentez la valeur de délai d'attente.
-Dcom.ibm.rational.rpews.pwd Mot de passe utilisateur permettant de s'authentifier auprès des services distants.

Exemple : -Dcom.ibm.rational.rpews.pwd=password

Indicateur Rational Publishing Engine Pour l'authentification auprès de l'application Services distants, configurez cet indicateur avec un mot de passe.
-Dcom.ibm.rational.rpews.url URL
Exemple :

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

Indicateur Rational Publishing Engine URL de connexion à l'application Services distants. Il se peut que cette URL ne soit pas éditable si l'administrateur n'autorise pas les utilisateurs à changer l'emplacement.
-Dcom.ibm.rational.rpews.usr Nom d'utilisateur permettant de s'authentifier auprès des services distants.

Exemple : -Dcom.ibm.rational.rpews.usr=user

Indicateur Rational Publishing Engine Pour l'authentification auprès de l'application Services distants, configurez cet indicateur avec un nom d'utilisateur.
-Dosgi.configuration.area Chemin d'accès au fichier
Exemple :

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

Indicateur Java standard Pour changer l'emplacement de sortie par défaut de vos générations de documents, vous pouvez changer 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/

Indicateur Java standard Pour changer l'emplacement de sortie par défaut de vos générations de documents, vous pouvez changer 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

Indicateur Java standard 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

Indicateur Java standard 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

Indicateur Java standard 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

Indicateur IBM® Java Runtime Environment 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

Indicateur Rational Publishing Engine Variable système qui indique l'adresse du serveur de licences.

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.

Retour d'informations