Variables de WebSphere

Las variables de WebSphere son pares de nombre y valor que se utilizan para proporcionar valores para cualquiera de los atributos de tipos de datos de serie que se utilizan para configurar el producto. Una vez que se ha definido una variable, el nombre simbólico que se especifica para dicha variable se puede especificar en el campo Valor de cualquier otro campo de configuración del producto que acepte un valor de serie.

Las variables de WebSphere pueden utilizarse para configurar lo siguiente:
  • Nombres de vía de acceso de WebSphere Application Server, tales como JAVA_HOME y APP_INSTALL_ROOT.
  • El valor de la vía de acceso para el atributo de servicio de archivos o JSP extendedDocumentRoot. Esta capacidad le permite añadir una aplicación a cada uno de los nodos de un entorno en clúster sin modificar el archivo ibm-web-ext.xmi de dicha aplicación en cada nodo.
    Supported configurations Supported configurations: Para los archivos de enlace y extensión de IBM®, la extensión del nombre de archivo .xmi o .xml es diferente en función de si se utiliza una aplicación o módulo previo a Java EE 5 o una aplicación o módulo Java™ EE 5 o posterior. Un archivo de enlace o extensión de IBM se denomina ibm-*-ext.xmi o ibm-*-bnd.xmi donde * es el tipo de archivo de extensión o enlace como app, application, ejb-jar o web. Se aplican las condiciones siguientes:
    • En el caso de una aplicación o módulo que utilice una Java EE anterior a la versión 5, la extensión del archivo debe ser .xmi.
    • En el caso de una aplicación que utilice Java EE versión 5 o posterior, la extensión del archivo debe ser .xml. Si los archivos .xmi se incluyen con la aplicación o el módulo, el producto ignora los archivos .xmi.

    No obstante, puede existir un módulo de Java EE 5 o posterior dentro de una aplicación que incluya archivos previos a Java EE 5 y que utilice la extensión de nombre de archivo .xmi.

    Los archivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, y ibm-portlet-ext.xmi siguen utilizando la extensión de archivo .xmi.

    sptcfg
  • Determinados valores de personalización de la célula
  • [z/OS]El servicio de ubicación para la plataforma z/OS.
Cuando se define una variable, se le asigna un ámbito. El ámbito es el rango de ubicaciones en la red del producto en el que se aplica la variable.
  • Una variable con un ámbito a nivel de célula está disponible en toda la célula del gestor de despliegue.
  • Una variable con un ámbito a nivel de clúster está disponible en todo el clúster de la célula.
  • Una variable con un ámbito a nivel de nodo sólo está disponible en el nodo y en los servidores de ese nodo. Si una variable a nivel de nodo tiene el mismo nombre que una variable a nivel de célula, el valor de la variable a nivel de nodo tiene preferencia.
  • Una variable de servidor sólo está disponible en el proceso de un servidor. La variable de servidor tiene prioridad sobre una variable con el mismo nombre definida en un nivel superior.

El valor de un atributo de configuración puede contener referencias a una o más variables. La sintaxis de un atributo de estas características es el nombre de la variable, incluido entre corchetes { } o entre paréntesis ( ). En cualquier caso, la variable irá precedida por el signo de dólar.

Un valor de atributo de configuración de serie puede constar de:
  • Literales de serie, incluidos el valor nulo y una serie vacía
  • Referencias de variable, cada una de las cuales con uno o varios niveles de indirección
  • Referencias de variable anidadas.
  • Cualquier combinación de literales de serie que no sean nulos ni vacíos, referencias de variable y referencias de variable anidadas.

[Windows]Para sistemas operativos Microsoft Windows, las vías de acceso de archivo van precedidas por /Archivos de programa.

Tabla 1. Variables y atributos de WebSphere . En la tabla siguiente, se ilustran todas las combinaciones posibles.
El atributo de configuración consta de: Valor de atributo de configuración Nombre de la variable Valor de la segunda variable Valor de la tercera variable Valor de la cuarta variable Valor de atributo de configuración expandido
Literal de serie /IBM/WebSphere/AppServer N/D N/D N/D N/D /IBM/WebSphere/AppServer
Referencia de variable $(WAS_INSTALL_ROOT) WAS_ INSTALL_ ROOT /IBM/WebSphere/AppServer N/D N/D /IBM/WebSphere/AppServer
Referencia de variable con literal de serie $(USER_INSTALL_ROOT)/temp USER_ INSTALL_ ROOT N/D N/D /IBM/WebSphere/AppServer/profiles/AppSrv01 /IBM/WebSphere/AppServer/profiles/AppSrv01/temp
Referencia de variable indirecta con un literal de serie $(WAS_INSTALL_ROOT)/lib WAS_ INSTALL_ ROOT $(MY_INSTALL_ROOT) MY_INSTALL_ ROOT N/D N/D
Referencias de variable anidadas con literal de serie (Ejemplo 1) $(${INSTALL_TYPE}_INSTALL_ROOT)/lib INSTALL_ TYPE USER USER_INSTALL_ ROOT /IBM/WebSphere/AppServer/profiles/AppSrv01 /IBM/WebSphere/AppServer/profiles/AppSrv01/lib
Referencias de variable anidada con literal de serie (Ejemplo 2) $(${INSTALL_TYPE}_INSTALL_ROOT)/lib INSTALL_ TYPE WAS WAS_INSTALL_ ROOT /IBM/WebSphere/AppServer/AppServer /IBM/WebSphere/AppServer/AppServer/lib

Durante el proceso de configuración, siempre que se encuentra una variable como un valor de un atributo de configuración, se realiza una expansión de variable en dicha variable. Una expansión de variable es el proceso de sustituir de forma recursiva referencias de variable por valores de variable hasta que quede un solo literal de serie como valor para el atributo de configuración. Si el proceso de expansión detecta una variable no definida correctamente, la expansión de dicha variable se detendrá y se emitirá la excepción VariableExpansionException. El proceso de configuración del producto prosigue. Sin embargo, es posible que se produzcan errores de procesamiento debido al establecimiento incorrecto del valor de este atributo de configuración.

Avoid trouble Avoid trouble: La sintaxis de la expansión de variables que consta de un signo de dólar y un nombre de variable de una sola letra sin corchetes ni paréntesis que rodean, no se soporta. Todas las referencias de variables de WebSphere deben estar incluidas entre paréntesis o corchetes coincidentes, aunque estén formadas por una sola letra. Dicha sintaxis requería el escape del signo de dólar para evitar ambigüedades.gotcha
Tabla 2. Signo de dólar literal . Por compatibilidad con versiones anteriores, se sigue soportando el escape del signo de dólar literal y éste se interpreta como se indica en la tabla siguiente.
Valor de entrada Valor tras la expansión
$ $
$$ $
$$$ $$
$$$$ $$
$$$$$ $$$

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ccws_variable
File name: ccws_variable.html