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 variables WebSphere permettent de configurer :
  • 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 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 :
    • Pour une application ou un module qui utilise une version Java EE antérieure à la version 5, l'extension de fichier doit être .xmi.
    • Pour une application ou un module qui utilise Java EE 5 ou version ultérieure, l'extension de fichier doit être .xml. Si des fichiers .xmi sont inclus dans l'application ou le module, le produit les ignore.

    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
  • [z/OS]le service de localisation pour la plateforme z/OS.
Lorsqu'une variable est définie, une portée lui est attribuée. La portée correspond à la série d'emplacements du réseau du produit dans lesquels la variable est applicable.
  • Une variable dont la portée est de niveau cellule est disponible dans toute la cellule du gestionnaire de déploiement.
  • Une variable dont la portée est de niveau cluster est disponible dans tout le cluster de la 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.

Une valeur d'attribut de configuration de chaîne peut être constituée des éléments suivants :
  • 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.

[Windows]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.

Tableau 1. Variables et attributs WebSphere . Le tableau suivant répertorie toutes les combinaisons possibles.
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 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
Tableau 2. Symbole de dollar littéral . Pour des raisons de compatibilité avec les versions antérieures, la syntaxe sans symbole dollar est toujours prise en charge et le symbole dollar littéral est interprété comme indiqué dans le tableau ci-après.
Valeur en entrée Valeur après extension
$ $
$$ $
$$$ $$
$$$$ $$
$$$$$ $$$

Icône indiquant le type de rubrique Rubrique de concept



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=ccws_variable
Nom du fichier : ccws_variable.html