Personnalisation de l'environnement Liberty

Vous pouvez personnaliser l'environnement Liberty à l'aide de certaines variables spécifiques afin de prendre en charge le placement des fichiers binaires du produit et des ressources partagées dans les systèmes de fichiers accessibles en lecture seule.

Pourquoi et quand exécuter cette tâche

Les variables d'environnement spécifiques de Liberty répertoriées dans la liste suivante peuvent être configurées dans le fichier server.env pour personnaliser l'environnement Liberty. La variable de configuration ${wlp.install.dir} possède un emplacement déduit qui est toujours le parent du répertoire contenant le script de lancement.

  • WLP_USER_DIR

    Cette variable d'environnement peut être utilisée pour spécifier un autre emplacement pour ${wlp.user.dir}. Cette variable doit être un chemin d'accès absolu. Si elle est spécifiée, l'environnement d'exécution recherche des ressources partagées et des définitions de serveur dans le répertoire indiqué. Dans le contexte d'un serveur particulier, le chemin représenté par ${server.config.dir} équivaut à ${wlp.user.dir}/servers/nomServeur. Si cette variable d'environnement n'est pas spécifiée, ${wlp.user.dir} est défini sur ${wlp.install.dir}/usr.

  • WLP_OUTPUT_DIR

    Cette variable d'environnement peut être utilisée pour spécifier un autre emplacement pour la sortie générée par le serveur (comme les journaux), le répertoire workarea et les fichiers générés. Les fichiers dans le répertoire logs peuvent inclure console.log, messages.log et tout fichier de l'outil de diagnostic de premier niveau généré. Les fichiers générés peuvent inclure des clichés de serveur qui sont créés avec la commande server dump ou server javadump. Cette variable doit être un chemin d'accès absolu. Si cette variable d'environnement est spécifiée, dans le contexte d'un serveur particulier, la valeur de ${server.output.dir} devient l'équivalent de WLP_OUTPUT_DIR/nomServeur. Si elle n'est pas spécifiée, ${server.output.dir} est identique à ${server.config.dir}.

    Lorsque la commande server est utilisée, le processus serveur utilise le répertoire de sortie comme répertoire de travail en cours.

  • WLP_ZOS_PROCEDURE

    Vous pouvez utiliser cette variable d'environnement pour spécifier le nom d'une procédure STC à utiliser pour démarrer le serveur en tant que tâche démarrée z/OS et non pas en tant que processus d'arrière-plan de UNIX System Services. Par défaut, le port de commande reste activé pour permettre l'administration en continu du serveur à partir du script de serveur. Le cas échéant, le port de commande peut être désactivé manuellement afin de permettre l'administration de serveur uniquement depuis la console opérateur z/OS. Voir Spécification des propriétés d'amorce du profil Liberty.

  • WLP_ZOS_JOBNAME

    Cette variable d'environnement peut être utilisée en plus de la variable WLP_ZOS_PROCEDURE afin de spécifier un nom de travail pour le serveur Liberty qui a été démarré en tant que tâche démarrée z/OS.

  • WLP_DEBUG_ADDRESS

    Cette variable d'environnement peut être utilisée pour spécifier un port alternatif lorsque vous exécutez le serveur en mode débogage. La valeur par défaut est 7777. Lorsque le serveur Liberty s'exécute en mode débogage depuis la commande serveur, les valeurs suivantes sont définies : JAVA_DEBUG="-Dwas.debug.mode=true -Dcom.ibm.websphere.ras.inject.at.transform=true -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=${WLP_DEBUG_ADDRESS}". Si toutefois vous exécutez le serveur Liberty depuis le fichier JAR exécutable ws-server.jar, ou le SPI de serveur Liberty imbriqué, vous devez utiliser les mêmes paramètres pour activer le mode débogage pour le serveur Liberty.

Vous pouvez spécifier les variables d'environnement WLP_OUTPUT_DIR, WLP_USER_DIR et WLP_DEBUG_ADDRESS dans les fichiers server.env. Vous pouvez aussi spécifier des options de JVM dans des fichiers jvm.options. Les fichiers server.env et jvm.options ne fonctionnent que si vous utilisez le script de gestion de serveur. Si vous utilisez le fichier JAR exécutable ws-server.jar pour lancer votre serveur, ces fichiers ne sont pas pris en charge.

Procédure

Que faire ensuite

Si vous démarrez le serveur Liberty à l'aide du script de serveur, toutes les variables d'environnement du système d'exploitation de la session courante sont disponibles. Si vous démarrez le serveur à l'aide du bean géré ou du Centre d'administration, les seules variables d'environnement disponibles sont celles qui sont disponibles pour une commande à distance qui s'exécute sur ce système.


Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_admin_customvars.html