Setting variables for Liberty servers

Vous devez définir une ou plusieurs variables WebSphere pour pouvoir utiliser le gestionnaire de travaux pour installer et gérer à distance des serveurs à Liberty. Vous pouvez définir ces variables sur une console d'administration, dans un script wsadmin ou à l'aide de la commande registerHost. Les variables définissent les répertoires racine dans lesquels installer les ressources du Liberty et indiquent les chemins de recherche permettant de trouver les ressources qui ne sont pas encore enregistrées auprès du gestionnaire de travaux.

Avant de commencer

Les ressources du Liberty incluent des projets, des kits de développement de logiciels (environnement d'exécution Java), des environnements d'exécution du Liberty, des serveurs et des applications. Pour plus d'informations, voir la rubrique sur les ressources du Liberty.

Si vous utilisez une console d'administration, wsadmin ou la commande registerHost pour définir les valeurs des variables du serveur à Liberty, démarrez le gestionnaire de travaux ou le gestionnaire de déploiement.

Pourquoi et quand exécuter cette tâche

Vous pouvez spécifier des valeurs pour les variables WebSphere et les variables intégrées.

Variables WebSphere

Pour pouvoir installer les ressources Liberty à l'aide du gestionnaire de travaux, vous devez définir une ou plusieurs variables WebSphere. La quantité de tâches de configuration dépend de la topologie déployée. Vous pouvez définir les valeurs des variables à l'aide de la console du gestionnaire de travaux ou du gestionnaire de déploiement, de wsadmin ou de la commande registerHost.

Vous pouvez installer des ressources à un emplacement de travail non partagé ou à un emplacement partagé. Ne partagez pas les ressources qui sont installées dans l'emplacement de travail.

Les ressources installées dans un emplacement partagé peuvent être utilisées par les serveurs à Liberty installés dans un emplacement de travail. Par exemple, vous pouvez configurer les serveurs de travail à Liberty afin qu'ils utilisent un ou plusieurs des types suivants de ressources partagées :
  • exécution Liberty
  • Kit de développement de logiciels
  • Application
Installez les ressources à des emplacements partagés comme étant accessibles en lecture seule. Vous pouvez partager des ressources dans un hôte ou entre des hôtes en utilisant les techniques de partage de disque telles que le système NFS (Network File System).

Au cours de l'installation des ressources, et à condition qu'il n'existe pas de conflit de noms, les ressources du fichier compressé du Liberty sont extraites vers le répertoire racine de travail indiqué par WLP_WORKING_DIR ou vers le répertoire partagé indiqué par WLP_SHARED_DIR.

Tableau 1. Variables par défaut du Liberty. Spécifiez au moins un chemin de répertoire pour le répertoire de travail non partagé.
Variables par défaut Description
WLP_WORKING_DIR Spécifie le chemin d'installation ou de recherche d'inventaire pour les ressources de travail non partagées du Liberty. Si la soumission d'un travail n'indique pas que le répertoire d'installation ou de recherche peut être partagé, le travail utilise cette variable. Par défaut, les ressources Liberty sont installées dans le répertoire de travail non partagé défini par cette variable.

Indiquez un chemin absolu pour cette variable. Ne spécifiez pas de chemin relatif.

WLP_SHARED_DIR Indique le chemin d'installation ou de recherche d'inventaire des ressources partagées du Liberty. Si la soumission d'un travail indique que le répertoire d'installation ou de recherche peut être partagé, le travail utilise cette variable.

Indiquez un chemin absolu pour cette variable. Ne spécifiez pas de chemin relatif.

WLP_ADDITIONAL_DIRS (facultatif) Indique des chemins supplémentaires de recherche des ressources Liberty autres que les chemins inclus dans les variables WLP_SHARED_DIR et WLP_WORKING_DIR.
Vous devez configurer les chemins de recherche supplémentaires pour les ressources Liberty afin de :
  • Rechercher les kits de développement de logiciels installés préalablement qui sont gérés indépendamment du gestionnaire de travaux.
  • Rechercher les ressources de serveur qui ne sont pas installées dans les répertoires de travail et partagés par défaut. Par exemple, vous pouvez définir différents emplacements d'installation associés aux répertoires de base de plusieurs utilisateurs. Pour plus d'informations, voir les descriptions des variables HOME et USER.

Indiquez un chemin absolu pour cette variable. Ne spécifiez pas de chemin relatif.

Variables intégrées

When you use the job manager to remotely install and manage Liberty servers, you can set the following built-in variables to customize installation locations and Liberty configuration files based on operating system home directory, operating system user, host name, and project membership:

HOME
Contient la valeur du répertoire de base de l'utilisateur du système d'exploitation qui est utilisé pour soumettre un travail Installer les ressources de profil Liberty. Vous pouvez utiliser la variable HOME pour configurer un répertoire de travail situé dans un chemin relatif par rapport au répertoire de base de l'utilisateur ayant procédé à la soumission. Par exemple :
WLP_WORKING_DIR=${HOME}/working
USER
Contient le nom de l'utilisateur du système d'exploitation qui est utilisé pour soumettre un travail Installer les ressources de profil Liberty. Vous pouvez utiliser la variable USER pour configurer un répertoire de travail pour chaque utilisateur, situé dans un chemin relatif par rapport à un répertoire global. Par exemple :
WLP_WORKING_DIR=/working/${USER}
Lorsque vous utilisez la variable HOME ou USER pour personnaliser l'emplacement d'installation, vous devez configurer la variable WLP_ADDITIONAL_DIRS avec les répertoires spécifiques de chaque utilisateur. Par exemple :
WLP_ADDITIONAL_DIRS=/usr/home/user1;/usr/home/user2

Si vous n'incluez pas les répertoires dans la variable WLP_ADDITIONAL_DIRS, les travaux d'inventaire ne localisent pas les ressources associées du Liberty sur les hôtes cible.

HOSTNAME
Contient le nom d'hôte configuré de l'hôte cible sur lequel un travail Installer les ressources de profil Liberty est exécuté. Vous pouvez utiliser la variable HOSTNAME dans le fichier de serveur bootstrap.properties ; par exemple :
hostname=${HOSTNAME}
Vous pouvez ensuite utiliser la variable HOSTNAME dans le fichier de configuration du serveur, server.xml ; par exemple :
<httpEndpoint host="${hostname}" httpPort="9081" httpsPort="9444" id="defaultHttpEndpoint"/>
CURRENT_PROJECT
Contient le nom du projet inclus dans le fichier compressé des ressources du Liberty.

Procédure

Vous pouvez définir des variables WebSphere pour tous les hôtes cible à un niveau défini ou les définir à un niveau d'hôte cible.

Résultats

Une fois les modifications sauvegardées, ces dernières sont visibles dans la liste des variables sur une page Variables WebSphere de la console.

Eviter les incidents Eviter les incidents: After you have defined the variables, see Packaging Liberty resources for information on how to properly package files for the Install Liberty resources job. If you use IBM Installation Manager to install Liberty, create a subdirectory under the location of WLP_WORKING_DIR. This directory will be used to identify this instance of the Liberty runtime. Utilisez-le comme répertoire d'installation lors de l'installation avec IBM Installation Manager. Si WLP_WORKING_DIR a pour valeur /liberty/working par exemple, créez un sous-répertoire runtime_1 ; ensuite, utilisez /liberty/working/runtime_1 comme répertoire d'installation lors de l'installation avec IBM Installation Manager.gotcha

Que faire ensuite

You can now submit a job that installs resources from a Liberty resources compressed file, as well as an inventory job that searches for previously existing Liberty resources.

Vous pouvez définir ultérieurement des variables qui remplacent les valeurs des variables pour des hôtes cible différents ou remplacer les variables définies par l'utilisateur :
  • Vous pouvez choisir de remplacer les valeurs des variables Liberty sur des hôtes différents en modifiant les propriétés cible pour chaque hôte. Définissez tout d'abord les variables WebSphere par défaut appropriées à un niveau plus élevé ; par exemple :
    WLP_SHARED_DIR=/shared
    WLP_WORKING_DIR=/working
    WLP_ADDITIONAL_DIRS=...
    Remplacez ensuite pour chaque cible les valeurs de ces variables qui diffèrent de la valeur par défaut. Par exemple, si la plupart des hôtes s'exécutent sur des systèmes d'exploitation AIX, HP-UX, Linux ou Solaris, avec des hôtes Windows dans votre environnement, après l'enregistrement de chaque hôte Windows, vous pouvez ajouter les propriétés hôte suivantes :
    WLP_SHARED_DIR=c:/shared
    WLP_WORKING_DIR=c:/working
  • Vous pouvez modifier les propriétés spécifiques de l'hôte cible pour remplacer une variable définie par l'utilisateur par des cibles individuelles. Le remplacement d'une variable définie par l'utilisateur est utile lorsqu'il existe plusieurs interfaces réseau sur chaque cible et que vous souhaitez indiquer laquelle utiliser pour chaque cible. Vous pouvez définir cette variable dans un fichier de serveur bootstrap.properties ; par exemple :
    hostname=${hostname.interface1}

    Pour chaque cible, vous devez définir la valeur réelle de la variable définie par l'utilisateur dans le fichier de propriétés propre à cet hôte cible. Par exemple, pour host1, définissez la valeur de l'interface comme étant hostname.interface1=host1.xyz.com et définissez host2 comme étant hostname.interface1=host2.xyz.com.


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



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tagt_jobmgr_var_cs_res
Nom du fichier : tagt_jobmgr_var_cs_res.html