Puede utilizar las variables de WebSphere para proporcionar los valores para
cualquiera de los atributos de tipos de datos de series de caracteres contenidos en los
archivos de configuración del producto.
Antes de empezar
Dado que las aplicaciones no pueden acceder directamente a las variables de
WebSphere, si define una variable de
WebSphere dentro de una aplicación, se devuelve un mensaje de error como, por ejemplo,
"Variable desconocida". Si debe hacer referencia a una variable de WebSphere
contenida en una aplicación, incluya el método siguiente en la aplicación para ampliar la
serie que utiliza la variable de WebSphere.
Avoid trouble: Para poder ampliar variables de
WebSphere necesita tener privilegios administrativos.
gotcha
private String expandVariable(String s) throws
javax.management.JMException {
com.ibm.websphere.management.AdminService as =
com.ibm.websphere.management.AdminServiceFactory.getAdminService
();
String server = as.getProcessName();
java.util.Set result = as.queryNames(new javax.management.ObjectName("*:*,type=AdminOperations,process="
+ server), null);
return (String)as.invoke((javax.management.ObjectName)
result.iterator().next(),"expandVariable",new Object[]
{"${"+s+"}"}, new String[] {"java.lang.String"});
De forma
similar, puede incluir las líneas de código siguientes en un archivo de script
si desea utilizar un mandato de script para ampliar las variables de WebSphere.
- En Jacl:
set mbean [$AdminControl completeObjectName WebSphere:*,type=AdminOperations]
$AdminControl invoke $mbean expandVariable {{"${APP_INSTALL_ROOT}"}}
- En Jython:
AdminOperations = AdminControl.completeObjectName('WebSphere:*,type=AdminOperations')
print AdminControl.invoke(AdminOperations, 'expandVariable', '${APP_INSTALL_ROOT}')
Acerca de esta tarea
Las variables de WebSphere generalmente se utilizan para especificar vías de acceso a archivos.
El tema "Valores de variable" proporciona más detalles sobre cómo especificar variables,
y resalta información adicional sobre los componentes del producto que
las utilizan.
También se utilizan las variables de WebSphere para configurar:
- Nombres de vías de acceso de producto como, por ejemplo, JAVA_HOME y
APP_INSTALL_ROOT.
- Configurar determinados valores de personalización de toda la célula o de todo el clúster.
El servicio de ubicación.
Las variables de entorno.
El mecanismo de ámbito de
variables para las variables de WebSphere variables le permite
definir una variable a nivel de nodo, clúster o célula y también a
nivel de servidor. Este mecanismo le permite especificar un valor para todos los servidores de un nodo,
clúster o célula, en lugar de especificar individualmente el valor para cada servidor.
Para definir una variable nueva, cambie el valor de una variable
existente, o suprima una variable existente siguiendo los pasos que
se indican a continuación, según corresponda.
Procedimiento
- Pulse en la consola administrativa.
- Seleccione el ámbito de la
variable en la lista de ámbitos disponibles.
Si crea una variable nueva,
se creará en el ámbito seleccionado. Si define la misma variable en
varios niveles, la definición más granular altera temporalmente el
valor de nivel más alto. Por ejemplo, si especifica la misma variable
en un nivel de célula y en el nivel de nodo, el valor del nivel de
nodo sobrescribirá el valor del nivel de célula.
Establecer
ámbitos para las variables es especialmente importante si se
prueban objetos de orígenes de datos. El
establecimiento de ámbitos para las variables puede hacer que un origen de
datos falle la conexión de prueba, pero se ejecute satisfactoriamente, o que
pase la conexión de prueba, pero no se ejecute.
- Cree una variable nueva.
- Pulse Nuevo.
- Especifique un nombre, un valor y, si lo desea, una
descripción para la variable.
El servidor de aplicaciones utiliza variables internas de WebSphere Application Server para sus propios fines. Los prefijos que indican que una variable es interna son WAS_DAEMON_<propiedad
personalizada del servidor>, WAS_DAEMON_ONLY_<propiedad personalizada
del servidor> y WAS_SERVER_ONLY_<propiedad personalizada del
servidor>. Todas las variables que tengan estos distintivos no son para uso propio. Están reservadas
exclusivamente para que las utilice el tiempo de ejecución del servidor. Si se
modifican estas variables se pueden producir errores inesperados.
Puede utilizar las variables de WebSphere para
modificar la configuración del daemon. Si anexa una propiedad personalizada de servidor en un distintivo de daemon, puede designar
esa variable específicamente para ese daemon.
Escriba DAEMON_<propiedad
personalizada del servidor> en el campo Nombre.
Por ejemplo, si especifica DAEMON_ras_trace_outputlocation en
el campo Nombre y SYSOUT en el campo Valor, puede dirigir esa salida de rastreo del
daemon específica a SYSPRINT.
Puede crear variables de WebSphere
que admitan la sustitución. Por ejemplo, si especifica
${<nombre_variable>} en el campo Nombre, el valor de
<nombre_variable> pasa a ser el nombre de la nueva variable de
WebSphere. Por
ejemplo, si especifica ${JAVA_HOME} como nombre de la variable, el nombre de la variable de
WebSphere que se crea es el directorio padre de
Java™.
- Pulse Aceptar.
- Pulse en el área de navegación de la consola
administrativa y compruebe que la variable se muestra en la lista de variables
para el ámbito seleccionado.
La
consola administrativa no capta los errores tipográficos. La variable se ignora si se hace referencia a la misma de forma incorrecta.
- Modificar el valor para una variable existente.
- Pulse el nombre de la variable que desea cambiar.
- Modifique el contenido del campo Valores.
El campo Valores para algunas de las variables que ya están definidas
al instalar el producto es de sólo lectura porque cambiar los valores
que se han especificado para dichas variables podría dar lugar a
errores de proceso en el producto.
- Pulse Aceptar.
- Suprimir una variable existente.
- Seleccione la variable que desea suprimir.
- Pulse Suprimir.
- Pulse Aceptar.
- Verifique que esta variable se ha eliminado de la lista
de variables para el ámbito seleccionado.
- Guarde la configuración.
- Detenga los servidores afectados e inícielos de nuevo para
que el cambio en la configuración de la variable sea efectivo.
Si el cambio que ha realizado afecta a un nodo, debe detener y
reiniciar todos los servidores de dicho nodo. Del mismo modo, si el
cambio que ha realizado afecta a una célula, debe detener y reiniciar
todos los servidores de dicha célula.