Variables WebSphere
Les variables WebSphere sont des paires nom-valeur qui fournissent des paramètres pour les attributs de type de données de chaîne utilisés pour configurer le produit. Après qu'une variable ait été définie, le nom symbolique spécifié pour cette variable peut être spécifié dans la zone Valeur de tout autre zone de configuration du produit acceptant une valeur de chaîne.
- les noms de chemins WebSphere Application Server, tels que JAVA_HOME et APP_INSTALL_ROOT
- une valeur de chemin pour les pages JSP extendedDocumentRoot ou le fichier qui fournit
l'attribut. Cette fonction permet d'ajouter une application à chaque noeud dans un environnement de cluster sans modifier le fichier ibm-web-ext.xmi de l'application sur chaque noeud.
Configurations prises en charge: Pour les
fichiers de liaison et d'extension IBM®, l'extension
de nom de fichier .xmi ou .xml est différente selon que vous utilisiez un module ou une application antérieure à
Java EE 5 ou un module ou une application ultérieure à Java™ EE 5. Un fichier de liaison ou d'extension
IBM porte le nom ibm-*-ext.xmi ou ibm-*-bnd.xmi où * correspond au fichier
d'extension ou de liaison, tel app, application, ejb-jar ou web. Les conditions suivantes s'appliquent : Toutefois, un module Java EE 5 ou version ultérieure peut exister dans une application qui inclut des fichiers antérieurs à Java EE 5 et utilise l'extension de nom de fichier .xmi.
Les fichiers ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi et ibm-portlet-ext.xmi continuent d'utiliser les extensions de fichier .xmi.
sptcfg - certaines valeurs de personnalisation applicables à une cellule
- Une variable dont la portée est de niveau noeud n'est disponible que sur le noeud et les serveurs de ce noeud. Si une variable de niveau noeud possède le même nom qu'une variable de cellule, c'est la valeur de la variable de niveau noeud qui prévaut.
- Une variable de serveur n'est disponible que sur le processus du serveur. Une variable de serveur est prioritaire par rapport à une variable de même nom définie à un niveau supérieur.
La valeur d'un attribut de configuration peut contenir des références à une ou plusieurs variables. La syntaxe d'un attribut de ce type est le nom de la variable placé entre accolades { } ou entre parenthèses ( ). Dans tous les cas, la variable est suivie du signe dollar.
- littéraux chaîne, incluant les valeurs null et les chaînes vides ;
- références de variables incluant chacune un ou plusieurs niveau(x) d'adressage indirect ;
- références de variables imbriquées ;
- toute combinaison de littéraux chaîne non vide et non null, références de variables, et références de variables imbriquées.
Pour les systèmes d'exploitation Microsoft Windows, les chemins d'accès spécifiés sont
précédés du préfixe /Program Files.
| Les attributs de configuration sont constitués des éléments suivants : | valeur d'attribut de configuration ; | nom de variable ; | valeur de seconde variable | valeur de troisième variable | valeur de quatrième variable | valeur d'attribut de configuration détaillé |
|---|---|---|---|---|---|---|
| Littéral chaîne | /IBM/WebSphere/AppServer | N/A | N/A | N/A | N/A | /IBM/WebSphere/AppServer |
| Référence de variable | $(WAS_ INSTALL_ ROOT) | WAS_ INSTALL_ ROOT | /IBM/WebSphere/AppServer | N/A | N/A | /IBM/WebSphere/AppServer |
| Référence de variable avec littéral chaîne | $(USER_ INSTALL_ ROOT)/temp | USER_ INSTALL_ ROOT | N/A | N/A | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/temp |
| Référence de variable indirecte avec une littéral chaîne | $(WAS_ INSTALL_ ROOT)/lib | WAS_ INSTALL_ ROOT | $(MY_INSTALL_ ROOT) | MY_INSTALL_ ROOT | N/A | N/A |
| Références de variables imbriquées avec littéral chaîne (Exemple 1) | $(${INSTALL_ TYPE}_ INSTALL_ ROOT)/lib | INSTALL_ TYPE | USER | USER_INSTALL_ ROOT | /IBM/WebSphere/AppServer/profiles/AppSrv01 | /IBM/WebSphere/AppServer/profiles/AppSrv01/lib |
| Références de variables imbriquées avec littéral chaîne (Exemple 2) | $(${INSTALL_ TYPE}_ INSTALL_ ROOT)/lib | INSTALL_ TYPE | WAS | WAS_INSTALL_ ROOT | /IBM/WebSphere/AppServer/AppServer | /IBM/WebSphere/AppServer/AppServer/lib |
Lors du processus de configuration, dès qu'une variable tient lieu de valeur d'attribut de configuration, une extension est effectuée sur cette variable. Une extension de variable consiste à remplacer de manière répétée les références de variables par des valeurs de variables jusqu'à ce que seul un littéral chaîne demeure en tant que valeur de l'attribut de configuration. Si le processus d'extension rencontre une variable qui n'est pas correctement définie, l'extension de cette variable s'interrompt et une exception VariableExpansionException est générée. Le processus de configuration du produit se poursuit. Cependant, des erreurs de traitement peuvent se produire car la valeur de cet attribut de configuration n'est pas correctement établie.
Eviter les incidents: La syntaxe d'extension de variable constituée d'un symbole dollar et d'un nom de variable à une seule lettre
sans accolades ni parenthèses n'est pas pris en charge.
Toutes les références de variables WebSphere doivent être placées entre parenthèses ou accolades, même s'il s'agit d'une unique lettre. Cette syntaxe nécessite le caractère d'échappement du symbole du dollar pour éviter
toute ambiguïté.gotcha| Valeur en entrée | Valeur après extension |
|---|---|
| $ | $ |
| $$ | $ |
| $$$ | $$ |
| $$$$ | $$ |
| $$$$$ | $$$ |
Rubrique de concept