Puede utilizar la herramienta wsadmin para configurar y administrar los
servidores de aplicaciones, el despliegue de aplicaciones y las operaciones de tiempo de
ejecución del servidor.
Acerca de esta tarea
La herramienta wsadmin proporciona la posibilidad de automatizar las tareas de configuración para el entorno mediante la ejecución de scripts. Sin embargo, existen algunas limitaciones en la utilización de la herramienta
wsadmin, que incluyen:
- La herramienta wsadmin sólo soporta los lenguajes de script Jython y Jacl.
El release de la Versión 6.1 de WebSphere Application Server representaba
el inicio del proceso de desuso de la sintaxis Jacl que está asociada con la herramienta
wsadmin. La sintaxis Jacl para la herramienta wsadmin permanece en el
producto y recibe soporte durante dos releases principales del producto
como mínimo. Después de ese periodo, es posible que se elimine el soporte
del lenguaje Jacl de la herramienta wsadmin. La sintaxis Jython para la herramienta wsadmin constituye la
dirección estratégica para la automatización administrativa de WebSphere
Application Server. El servidor de aplicaciones proporciona funciones y herramientas administrativas
significativamente mejoradas que soportan la automatización del producto y el uso
de la sintaxis Jython.
Deprecated feature: Jacl está en desuso y
Jython es el lenguaje de script predeterminado.
depfeat
Avoid trouble: No todas las clases de componentes de
WebSphere Application Server se empaquetan en el mismo archivo
.jar. Si va a utilizar la herramienta wsadmin para ejecutar los scripts Jython, incluya la propiedad del sistema jython.package.path en el mandato wsadmin para asegurarse de que todos los archivos JAR necesarios se hayan establecido en la vía de acceso del paquete jython durante el arranque de wsadmin.
./wsadmin.sh -lang jython -javaoption
"-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar"
Si desea invocar funciones de WebSphere Application Server desde diferentes clases de WebSphere Application Server que se empaquetan en los archivos .jar distintos de runtime.jar y admin.jar, puede incluir varios archivos jar en la vía de acceso especificada para la propiedad del sistema jython.package.path y sepárelos con un punto y coma (;).
./wsadmin.sh -lang jython -javaoption
"-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar;com.ibm.ws.wccm.jar"
Si desea invocar funciones deWebSphere Application Server en un script jython utilizando ws_ant, puede crear un archivo de texto del archivo .prop e incluir la línea siguiente en ese archivo:
jython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar
A continuación, incluya el archivo de propiedades en el archivo script xml.
Por ejemplo:
<taskdef name="wsadmin" classname="com.ibm.websphere.ant.tasks.WsAdmin"/>
<target name="main">
<wsadmin conntype="NONE" lang="jython" failonerror="true" properties="/tmp/jython.prop"
script="/home/fsgapp/MSTWasBuild/project/scripts/socr/socr/jython/configure.py">
</wsadmin>
</target>
gotcha
- La herramienta wsadmin gestiona las operaciones de instalación, configuración,
despliegue y tiempo de ejecución de los servidores de aplicaciones, gestores de despliegue, agentes administrativos y gestores de trabajos que ejecuten la misma versión o una versión superior del producto. La herramienta wsadmin no se puede conectar a un servidor de aplicaciones, gestor de despliegue, agente administrativo o gestor de trabajos que ejecute una versión del producto más antigua que la versión de la herramienta wsadmin. Por ejemplo, un cliente wsadmin de la versión 7.x no se puede conectar a un servidor de aplicaciones de la versión 6.x. Sin embargo, un cliente wsadmin de la versión 6.x se puede conectar a un servidor de aplicaciones de la versión 7.x. Existe esta limitación porque se añade funcionalidad nueva a la herramienta
wsadmin en cada release del producto. No puede utilizar la funcionalidad de mandatos nueva en servidores de aplicaciones que ejecuten versiones anteriores del producto.
- La herramienta wsadmin opera en el nivel del nodo del gestor de despliegue, en un entorno de células mixtas. No ejecute wsadmin en el nivel del nodo del servidor de aplicaciones para asegurarse de que todas las funcionalidades del mandato estén disponibles.
El iniciador de wsadmin da soporte a varios objetos de scripts, incluidos los objetos AdminConfig, AdminControl, AdminApp, AdminTask y Help. Los scripts utilizan estos objetos para la gestión de aplicaciones, la configuración, el control operativo y las comunicaciones
con MBeans que se ejecutan en los procesos del producto. Debe iniciar el cliente de scripts wsadmin antes de realizar ninguna otra tarea con scripts.
Para poder iniciar la herramienta de wsadmin con la seguridad habilitada,
revise el tema sobre las consideraciones SSL para administradores de WebSphere
Application Server y el tema sobre la definición de la seguridad SSL para clientes y
servidores.
En un entorno de gestión flexible, puede conectar la herramienta wsadmin a un proceso de servidor de aplicaciones base, gestor de despliegue, agente administrativo o gestor de trabajos.
Si no especifica el puerto del servidor de aplicaciones base o el nombre del perfil asignado al gestor de trabajos, la herramienta wsadmin se conecta automáticamente al agente administrativo.
Avoid trouble: El diseño de la gestión de aplicaciones no permite instalar un EAR de nivel de especificación EE ni un módulo con un nivel superior al cliente. El código de cliente que se ejecuta en wsadmin lee el archivo EAR y utiliza la introspección del contenido para generar las opciones de configuración de despliegue que son aplicables a esa aplicación. El código del lado del cliente no puede procesar un nivel de especificación que es mayor de lo que soporta el cliente.
gotcha
Resultados
La herramienta wsadmin devuelve la salida siguiente cuando establece una conexión con el proceso del servidor:
Salida de ejemplo de Jython:
Applications currently installed:
DefaultApplication
ivtApp
queryWASX70311: Para obtener ayuda, entre: "print Help.help()"
wsadmin>
Salida de ejemplo de Jacl:
Aplicaciones instaladas actualmente:
DefaultApplication
ivtApp
queryWASX70311: Para obtener ayuda, entre: "$Help help"
wsadmin>
![[z/OS]](../images/ngzos.gif)
Si recibe el mensaje:
[ Unable to allocate an initial java heap of 268435456 bytes. ]
[ **Out of memory, aborting** ]
[ *** panic: JVMST016: Cannot allocate memory for initial java heap ]
CEE5207E The signal SIGABRT was received.
el cliente de scripts wsadmin no ha podido iniciarse porque el tamaño de la región
en el inicio de sesión no es lo suficientemente grande para asignar el tamaño mínimo de pila(-Xms
) que se ha especificado en la máquina virtual Java (JVM) que se creó cuando se inició
wsadmin. El valor predeterminado para la opción -Xms, tal como se especificó en
la sentencia del archivo wsadmin.sh PERF_JVM_OPTIONS="-Xms256m -Xmx256m, es de 256
MB. Para corregir este problema, cierre la sesión de TSO y, a continuación, cuando vuelva a
iniciar la sesión en TSO, intente incrementar el valor del parámetro
Size en
la pantalla de inicio de sesión. Si no puede incrementar el valor del parámetro
Size en
la pantalla de inicio de sesión, compruebe si hay alguna salida de IEFUSI que le impida incrementar el
valor de este parámetro.
Si está iniciando la sesión mediante telnet en OMVS, el valor que se utiliza para determinar el tamaño del espacio de direcciones que el inicio de
sesión recibe se especifica en el miembro BPXPRMxx parmlib. BPXPRMxx controla el entorno completo de z/OS UNIX. Por consiguiente, el valor
que se establece para el parámetro MAXASSIZE determina el tamaño del espacio
de direcciones. No obstante, si va a utilizar RACF, el tamaño de la dirección también se puede
establecer para un usuario individual en el segmento RACF OMVS respectivo. En esta situación, el valor especificado para el parámetro ASSIZEMAX indica, en bytes,
el límite de tamaño de espacio de direcciones para dicho usuario. Por ejemplo
un valor de ASSIZEMAX=0268435456 indica que el espacio de direcciones
asignado a dicho usuario es 256 MB.