Configuration d'indicateurs éloignés pour l'application Web Services

Vous pouvez ajouter des paramètres appelés aux fichiers de configuration des serveurs d'applications afin de spécifier certains paramètres pour votre application Web Services.

Avant de commencer

Examinez la liste des indicateurs pouvant être utilisés pour l'application Web Services et sélectionnez-en un à utiliser pour effectuer cette tâche.
Tableau 1. Indicateurs éloignés
Indicateur Valeur Description
-Dcom.ibm.rational.rpe.docgen.concurentlimit Un nombre

Exemple : -Dcom.ibm.rational.rpe.docgen.concurentlimit=5

Définissez le nombre maximum de demandes de génération de document Rational Publishing Engine simultanées qui peuvent s'exécuter en une seule fois. Si la limite est atteinte, les demandes de travail suivantes sont placées en file d'attente afin de démarrer une fois les travaux en cours terminés.
-Dcom.ibm.rational.rpe.remote.debug true, false

Exemple : -Dcom.ibm.rational.rpe.remote.debug=true

Vous pouvez consulter les informations de journal plus détaillées pour déboguer des problèmes de génération de documents.
-Dcom.ibm.rational.rpe.remote.filestore Un chemin qui commence par \\

Exemple : -Dcom.ibm.rational.rpe.remote.filestore=\\storage\rpe\files

Si vous configurez un environnement d'équilibrage de charge, vous pouvez désigner l'emplacement du répertoire de stockage partagé.
-Dcom.ibm.rational.rpe.remote.ignorelanguage true, false

Exemple : -Dcom.ibm.rational.rpe.remote.ignorelanguage=true

Lorsque la valeur est true, l'application Web Services ignore les indicateurs -Duser.country et -Duser.language définis par l'utilisateur et indique le langage par défaut défini par l'administrateur pour le serveur.
-Dcom.ibm.rational.rpe.remote.javaopts Taille du segment de mémoire

Exemple : -Dcom.ibm.rational.rpe.remote.javaopts=-Xmx1280m

Vous pouvez augmenter la quantité de mémoire allouée à la génération de documents par l'application Web Services. La valeur par défaut est -Xmx1024m.

Si vous utilisez un environnement JRE (Java™ Runtime Environment) 32 bits pour l'application Web Services, vous pouvez ajuster la taille de segment de mémoire de 1 à 1,5 Go. Si vous utilisez un environnement JRE 64 bits pour l'application Web Services, vous pouvez utiliser une taille de segment de mémoire supérieure à 1,5 Go.

-Dcom.ibm.rational.rpe.remote.jre Chemin d'accès absolu aux fichiers d'application de l'environnement d'exécution Java.

Exemple : -Dcom.ibm.rational.rpe.remote.jre=C:\Program Files\Java\jre7

Vous pouvez spécifier un chemin d'accès à l'environnement d'exécution Java différent de celui contenu dans les fichiers d'application de Rational Publishing Engine, qui se trouve dans %RPE_HOME%\jre.
-Dcom.ibm.rational.rpe.remote.jrearch 32 ou 64 bits.

Exemple : -Dcom.ibm.rational.rpe.remote.jrearch=32

Si Rational Publishing Engine ne détecte pas la version correcte de l'environnement d'exécution Java pour exécuter les générations de documents, vous pouvez spécifier la version à utiliser.
-Dcom.ibm.rational.rpe.remote.rpecommandjar Chemin d'accès absolu au fichier rpecommand.jar.

Exemple : -Dcom.ibm.rational.rpe.remote.rpecommandjar=C:\Program Files\Rational\Publishing Engine

Si Rational Publishing Engine ne détecte pas le chemin d'accès correct au fichier rpecommand.jar, vous pouvez spécifier le chemin à utiliser.
-Dcom.ibm.rational.rpe.remote.showconsole true, false.

-Dcom.ibm.rational.rpe.remote.debug doit également être défini sur true.

Exemple :

-Dcom.ibm.rational.rpe.remote.showconsole=true
-Dcom.ibm.rational.rpe.remote.debug=true

icône Windows : vous pouvez ouvrir les informations de journal détaillées de com.ibm.rational.rpe.remote.debug dans une console distincte sur les ordinateurs Windows. N'utilisez pas cette propriété si le serveur d'applications est exécuté en tant que service Windows NT.
-Dcom.ibm.rational.rpe.remote.workarea Chemin d'accès absolu auquel l'utilisateur a accès en écriture.

Exemple : -Dcom.ibm.rational.rpe.remote.workarea=C:\temp

Emplacement dans lequel les fichiers temporaires sont créés lors de la génération de documents. Si aucun chemin n'est spécifié, le répertoire temporaire du système est utilisé.
-Dcom.ibm.ws.classloader.encodeResourceURLs true, false

-Dcom.ibm.rational.rpe.remote.debug doit également être défini sur true.

Exemple :

-Dcom.ibm.ws.classloader.encodeResourceURLs=false
-Dcom.ibm.rational.rpe.remote.debug=true

Requis uniquement pour WebSphere Application Server 8. Cet indicateur empêche le codage des URL. Si les URL sont codées par WebSphere Application Server 8, elles ne peuvent pas être lues par Rational Publishing Engine.

Pourquoi et quand exécuter cette tâche

Vous pouvez configurer un ou plusieurs des indicateurs éloignés 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