Inicio del cliente de scripts wsadmin mediante scripts wsadmin

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 Deprecated feature: Jacl está en desuso y Jython es el lenguaje de script predeterminado. depfeat
    Avoid trouble 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 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 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.

[AIX Solaris HP-UX Linux Windows]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.

Avoid trouble 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

Procedimiento

  1. Localice el mandato que inicia el cliente de scripts wsadmin.
    [AIX Solaris HP-UX Linux Windows][IBM i]Elija uno de los siguientes:
    • Invoque el proceso de scripts utilizando un perfil específico. El mandato QShell para invocar un proceso de scripts está ubicado en el directorio raíz_perfil/bin. El nombre del script QShell es wsadmin. Si utiliza esta opción, no necesita especificar el parámetro -profileName nombre_perfil.
    • Invoque el proceso de scripts utilizando el perfil predeterminado. El mandato Qshell de wsadmin se encuentra en el directorio raíz_servidor_aplic/bin. Si no desea conectarse al perfil por omisión, debe especificar el parámetro -profileName nombre_perfil para indicar el perfil que desea utilizar.
  2. Revise otras opciones de conexión para la herramienta wsadmin.
    Puede iniciar el cliente de scripts wsadmin de varios modos distintos. Si desea especificar el método para ejecutar scripts, realice una de las opciones siguientes de la herramienta wsadmin:
    Ejecute los mandatos de scripts de forma interactiva

    Ejecute wsadmin con una opción que no sea -f, -c o sin opción. La herramienta wsadmin se inicia y muestra un shell interactivo con un indicador de wsadmin. Desde el indicador de wsadmin, especifique un mandato Jacl o Jython cualquiera. También puede invocar mandatos utilizando los objetos wsadmin: AdminControl, AdminApp, AdminConfig, AdminTask o Help. Para dejar una sesión de scripts interactiva, utilice los mandatos quit o exit. Estos mandatos no utilizan argumentos.

    Los siguientes ejemplos inician la herramienta wsadmin:
    • Inicie la herramienta wsadmin con Jython:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython
      [IBM i]
      wsadmin -lang jython
      [Windows]
      wsadmin.bat -lang jython
    • Inicie la herramienta wsadmin con Jython si la seguridad está habilitada:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -user nombre_usuario -password contraseña
      [IBM i]
      wsadmin -lang jython -user nombre_usuario -password contraseña
      [Windows]
      wsadmin.bat -lang jython -user nombre_usuario -password contraseña
    • Inicie la herramienta wsadmin con Jacl sin opciones:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jacl
      [IBM i]
      wsadmin -lang jacl
      [Windows]
      wsadmin.bat -lang jacl
    Ejecute mandatos de scripts separadamente.

    Ejecute la herramienta wsadmin con la opción -c.

    [AIX][HP-UX][Linux][Solaris]Si invoca un mandato que incluye un carácter de signo de dólar ($) utilizando la opción wsadmin -c, la línea de mandatos intentará sustituir una variable. Para evitar este problema, añada una barra inclinada invertida antes del carácter de signo de dólar (\). Por ejemplo: wsadmin -c "\$AdminApp install ...".

    Los ejemplos siguientes ejecutan mandatos individualmente:
    • Ejecute el mandato list para el objeto AdminApp utilizando Jython:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -c 'AdminApp.list()'
      [IBM i]
      wsadmin -lang jython -c "AdminApp.list()"
      [Windows]
      wsadmin -lang jython -c "AdminApp.list()"
    • Ejecute el mandato lista para el objeto AdminApp utilizando Jacl:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -c "\$AdminApp list"
      o
      wsadmin.sh -c '$AdminApp list'
      [IBM i]
      wsadmin -c "$AdminApp list"
      [Windows]
      wsadmin -c "$AdminApp list"
    Ejecute mandatos de scripts en un script.

    Ejecute la herramienta wsadmin con la opción -f y coloque los mandatos que desee ejecutar en el archivo.

    Los ejemplos siguientes ejecutan scripts:
    • Ejecute el script a1.py con Jython:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -f  al.py
      [IBM i]
      wsadmin -lang jython -f  al.py
      [Windows]
      wsadmin -lang jython -f  al.py

      donde el archivo a1.py contiene los mandatos siguientes:

      apps = AdminApp.list()
      print apps
    Ejecute mandatos de scripts en un script de perfil.

    Un script de perfil es un script que se ejecuta antes que el script principal o antes de pasar a la modalidad interactiva. Puede utilizar scripts de perfil para establecer un entorno de script personalizado para el usuario o para la instalación.

    De manera predeterminada, es posible que los siguientes archivos de script de perfil estén configurados para la propiedad de perfiles com.ibm.ws.scripting.profiles en el archivo raíz_servidor_aplic/properties/wsadmin.properties:
    • raíz_servidor_aplic/bin/securityProcs.jacl
    • raíz_servidor_aplic/bin/LTPA_LDAPSecurityProcs.jacl

    De forma predeterminada, estos archivos están en ASCII. Si utiliza la opción profile.encoding para ejecutar los archivos de script de perfil con código EBCDIC, cambie la codificación de los archivos por EBCDIC.

    Para ejecutar mandatos de scripts en un script de perfil, ejecute la herramienta wsadmin con la opción -profile e incluya los mandatos que desee ejecutar en el script de perfil.

    Para personalizar el entorno de script, especifique uno o más scripts de perfil que desee ejecutar.

    No utilice paréntesis en los nombres de los nodos cuando cree perfiles.

    Los ejemplos siguientes ejecutan scripts de perfil:
    • Ejecute el script a1prof.py utilizando Jython:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -profile alprof.py
      [IBM i]
      wsadmin -lang jython -profile alprof.py
      [Windows]
      wsadmin.bat -lang jython -profile alprof.py

      donde el archivo a1prof.py contiene los mandatos siguientes:

      apps = AdminApp.list()
      print "Aplicaciones instaladas actualmente:\n " + apps
    • Ejecute el script a1prof.py utilizando Jacl:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -profile alprof.jacl
      [IBM i]
      wsadmin -profile alprof.jacl
      [Windows]
      wsadmin.bat -profile alprof.jacl

      donde el archivo a1prof.py contiene los mandatos siguientes:

      set apps [$AdminApp list]
      puts "Aplicaciones instaladas actualmente:\n$apps"

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>

Icon that indicates the type of topic Task topic



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