Configuration des indicateurs éloignés pour l'application Services distants sur WebSphere Application Server

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

Avant de commencer

Examinez la liste des indicateurs pouvant être utilisés pour l'application Services distants 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.license.attempts.count Un nombre

Exemple : -Dcom.ibm.rational.rpe.license.attempts.count=2

Nombre de fois qu'une licence disponible peut être recherchée. La valeur par défaut est de 1 fois. Si la valeur entrée est inférieure à 1, elle est ignorée.
-Dcom.ibm.rational.rpe.license.retry.timeout Nombre en secondes.

Exemple : -Dcom.ibm.rational.rpe.license.retry.timeout=6

Nombre de secondes à attendre entre les tentatives de recherche d'une licence disponible. La valeur par défaut est de 5 secondes.
-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 Services distants. La valeur par défaut est -Xmx1024m.

Si vous utilisez un environnement JRE (Java™ Runtime Environment) 32 bits pour l'application Services distants, 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 Services distants, 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 systèmes 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.rational.rpe.ssl Type de sécurité :
  • SSL
  • SSLv2
  • SSLv3
  • TLS
  • TLSv1
  • TLSv1.1

Exemple : -Dcom.ibm.rational.rpe.ssl=TLSv1

Lorsqu'il est défini sur un type de sécurité spécifique, Rational Publishing Engine communique uniquement dans ce type de sécurité.

Pour TLS v1.2, configurez plutôt l'indicateur -Dcom.ibm.rational.rpe.tls12only. Si les indicateurs -Dcom.ibm.rational.rpe.tls12only et -Dcom.ibm.rational.rpe.ssl sont tous deux configurés, -Dcom.ibm.rational.rpe.tls12only est prioritaire.

-Dcom.ibm.rational.rpe.tls12only true, false

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

Lorsque la propriété est définie sur true, Rational Publishing Engine communique uniquement en mode Transport Layer Security (TLS) 1.2. Rational Publishing Engine ne vérifie pas les autres paramètres de propriété Java Virtual Machine pour identifier le protocole Secure Sockets Layer (SSL) qui est utilisé.

Si les indicateurs -Dcom.ibm.rational.rpe.tls12only et -Dcom.ibm.rational.rpe.ssl sont tous deux configurés, -Dcom.ibm.rational.rpe.tls12only est prioritaire.

-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.

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