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_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
- Spécifiez les variables d'environnement au moyen de fichiers server.env.
Vous pouvez utiliser des fichiers
server.env au niveau de l'installation et au niveau du serveur pour spécifier des variables d'environnement telles que
JAVA_HOME,
WLP_USER_DIR et
WLP_OUTPUT_DIR. Exemple :
# Use a specific Java binary
JAVA_HOME=/opt/ibm/java-i386-60/jre
# JAVA_HOME=c:\Java
Remarque : - Les fichiers server.env admettent seulement des paires clé=valeur.
- Les lignes vides et les lignes qui commencent par le caractère # sont ignorées.
- Il n'existe pas de caractère d'échappement : tous les caractères sont littéraux, y compris les barres obliques inversées et les blancs de début et de fin.
- Il ne doit y avoir aucun espace avant ou après le signe égal "=".
- L'expansion par le shell et
l'expansion de variables ne sont pas prises en charge.
- La variable WLP_USER_DIR ne peut être spécifiée que dans le fichier ${wlp.install.dir}/etc/server.env car son but est d'indiquer l'emplacement du reste de la configuration. Une fois la configuration restante trouvée et fusionnée, aucune configuration supplémentaire n'est attendue dans un autre emplacement, ni prise en charge.
Le script de gestion des serveurs recherche les
fichiers server.env en deux endroits : ${wlp.install.dir}/etc/server.env
et ${server.config.dir}/server.env. Si le fichier est présent aux deux endroits, les deux versions sont
fusionnées ; les valeurs de la version au niveau du serveur sont prioritaires sur celles
de la version au niveau de l'exécution.
Vous pouvez aussi spécifier ces variables d'environnement dans l'environnement shell ; toutefois, les fichiers
server.env restent prioritaires.
- Personnalisez les options de JVM au moyen de fichiers jvm.options.
Vous pouvez utiliser des fichiers
jvm.options au niveau de l'exécution et au niveau du serveur pour spécifier d'autres options de
démarrage du serveur, par exemple des arguments
-X. Les options sont appliquées
aux actions de démarrage, d'exécution et de débogage, lorsque celles-ci sont démarrées via
le script de gestion des serveurs. Veillez à spécifier une seule option par ligne. Exemple :
# Set the maximum heap size to 1024m.
-Xmx1024m
# Set a system property.
-Dcom.ibm.example.system.property=ExampleValue
# Enable verbose output for class loading.
-verbose:class
# Enable verbose garbage collection.
-verbose:gc
# Specify an alternate verbose garbage collection log on IBM Java Virtual Machines only.
-Xverbosegclog:verbosegc.log
# Specify additional verbose garbage collection options on HotSpot Java Virtual Machines only.
-Xloggc:verbosegc.log
-XX:+PrintGCDetails
-XX:+PrintGCTimeStamps
-XX:+PrintHeapAtGC
![[16.0.0.4 and later]](../ng_v16004plus.gif)
Vous pouvez créer plusieurs fichiers
jvm.options dans les emplacements suivants :
- ${wlp.install.dir}/usr/shared/jvm.options
- ${server.config.dir}/configDropins/defaults/jvm.options
- ${server.config.dir}/jvm.options
- ${server.config.dir}/configDropins/overrides/jvm.options
Ces fichiers sont fusionnés de haut en bas avant le démarrage du serveur et sont utilisés comme les options
JVM du serveur. Si aucun de ces fichiers n'est présent,
${wlp.install.dir}/etc/jvm.options est lu.
Remarque : - Ne placez pas les valeurs de propriétés entre guillemets.
- Les lignes vides et les lignes qui commencent par le caractère # sont ignorées.
- Il n'existe pas de caractère d'échappement : tous les caractères sont littéraux, y compris les barres obliques inversées et les blancs de début et de fin.
- Il ne doit y avoir aucun espace avant ou après le signe égal "=".
- L'expansion par le shell et
l'expansion de variables ne sont pas prises en charge.
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.