Vous pouvez personnaliser l'environnement du profil 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écifique du profil Liberty de
la liste suivante peuvent être configurées dans le fichier server.env
pour personnaliser l'environnement du profil 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.
- 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
# Activer la récupération de place prolixe.
-verbose:gc
# Indiquer un autre journal de récupération de place prolixe sur les machines virtuelles IBM Java uniquement.
-Xverbosegclog:verbosegc.log
# Indiquer d'autres options de récupération de place prolixe sur les machines virtuelles Java HotSpot uniquement.
-Xloggc:verbosegc.log
-XX:+PrintGCDetails
-XX:+PrintGCTimeStamps
-XX:+PrintHeapAtGC
Le script de gestion des serveurs recherche les
fichiers jvm.options en deux endroits : ${wlp.install.dir}/etc/jvm.options
et ${server.config.dir}/jvm.options.
Si le fichier est présent aux deux endroits, les options utilisées sont celles
de la version ${server.config.dir}/jvm.options.
Remarque :
- 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.
- 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.