Configuration des indicateurs éloignés pour l'application Services distants sur Apache Tomcat

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.concurrentlimit Un nombre

Exemple : -Dcom.ibm.rational.rpe.docgen.concurrentlimit=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.
Important : Lorsque vous sélectionnez un nombre de demandes de génération de document simultanées, pensez au nombre de licences qui sont disponibles pour votre organisation. Si une licence n'est pas disponible au début de la génération de document, soit parce que vous avez défini la limite sur un nombre supérieur au nombre de licences ou soit parce que toutes les licences sont utilisées, l'un des comportements suivants a lieu :
  • Si les indicateurs com.ibm.rational.rpe.license.attempts.count et com.ibm.rational.rpe.license.retry.timeout sont spécifiés, la génération de document est ajoutée à la file d'attente et une nouvelle tentative est effectuée selon les intervalles indiqués.
  • Si les indicateurs com.ibm.rational.rpe.license.attempts.count et com.ibm.rational.rpe.license.retry.timeout ne sont pas spécifiés, la génération de document ne peut pas se terminer. La génération de document s'arrête.
-Dcom.ibm.rational.rpe.license.attempts.count Un nombre

Valeur par défaut : 1

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

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

Valeur par défaut : 5 secondes

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

Nombre de secondes à attendre entre les tentatives de recherche d'une licence disponible.
-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

Valeur par défaut : false

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

Lorsque la valeur est true, l'application Services distants 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

Valeur par défaut : -Xmx1024m

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.

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


Retour d'informations