Depuración de archivos de script Jython en WebSphere Application Server

Puede detectar y diagnosticar errores en el script Jython con el depurador. Puede controlar la ejecución del script estableciendo puntos de interrupción, suspendiendo hebras, recorriendo el código y examinando el contenido de las variables. Para depurar scripts Jython, utilice WebSphere Application Server Administrative Script Launcher para configurar el entorno de ejecución para interpretar el script y los valores de seguridad; si el script se ejecuta sobre un servidor seguro.

Antes de empezar

Restricción: WebSphere Application Server v6.1 y posterior es el único entorno de ejecución soportado para depurar archivos de script Jython. No obstante, cuando se ejecutan (a diferencia de depurar) archivos de script Jython, hay una lista de distintos tipos de entornos de ejecución soportados. Para obtener más información, consulte Ejecutar archivos de scripts administrativos en WebSphere Application Server.
Consejo: La diferencia entre ejecutar y depurar scripts Jython es que para depurar scripts Jython puede establecer puntos de interrupción en el script, mientras que en la ejecución de un script Jython está ejecutando el script sin interrupciones.
Restricción: Para depurar scripts Jython, los scripts Jython deben estar dentro del entorno de trabajo; esto se lleva a cabo creando o importando el script Jython al entorno de trabajo. El script Jython se debe depurar dentro del entorno de trabajo, a diferencia de ejecutar un script Jython situado en el sistema de archivos. Las herramientas de depuración como el margen de puntos de interrupción para establecer los puntos de interrupción no están disponibles al depurar el script Jython fuera del entorno de trabajo del sistema de archivos.

Acerca de esta tarea

Para depurar scripts Jython:

Procedimiento

  1. Abra un archivo de script Jython en el editor Jython:
    1. En la vista Navegador, expanda el proyecto Jython que contenga el archivo de script Jython que desee depurar.
    2. Pulse con el botón derecho del ratón en el archivo script de Jython.
    3. En el menú, seleccione Abrir con > Editor Jython.
  2. Establezca los puntos de interrupción en el script Jython. Para establecer uno o más puntos de interrupción en el editor Jython, efectúe una doble pulsación en el margen junto a la línea de código que desea establecer como punto de interrupción.
  3. En el editor Jython, pulse con el botón derecho del ratón y, en el menú, seleccione Depurar como > Script administrativo. Se abrirá WebSphere Application Server Administrative Script Launcher. Utilice WebSphere Application Server Administrative Script Launcher para depurar archivos de scripts administrativos en WebSphere Application Server desde dentro del entorno de desarrollo.
  4. La página Script es la página principal de WebSphere Application Server Administrative Script Launcher.
  5. El campo Script administrativo se rellena automáticamente con la vía de acceso del archivo de script.
  6. En la lista Entorno de ejecución de scripts, seleccione el nombre de un entorno de ejecución de WebSphere Application Server tal como se ha definido en la página Preferencias (Ventana > Preferencias > Servidor > Entornos de ejecución). Debe especificar un entorno de ejecución que se encuentre en su sistema de archivos local para interpretar el archivo de script. Si el entorno de ejecución que desea para interpretar el archivo de script no está disponible en la lista, pulse Nuevo para definir un nuevo entorno de ejecución de WebSphere Application Server. Se abrirá el asistente Entorno de ejecución de servidor nuevo. Puede crear cualquier entorno de ejecución con el asistente Entorno de ejecución de servidor nuevo. No obstante, cuando se utiliza WebSphere Application Server Administrative Script Launcher para depurar el script Jython, sólo se soporta el entorno de ejecución local de WebSphere Application Server Versión v6.1 o posterior para la depuración.
  7. En la lista Nombre de perfil, seleccione un perfil que pertenezca al entorno de ejecución seleccionado anteriormente. Un perfil es el conjunto de archivos que definen el entorno de ejecución. Si selecciona la opción [Sin especificar], la herramienta elegirá el perfil que tenga asignado el rol predeterminado.
  8. En el campo Argumentos de wsadmin, especifique la sintaxis de invocación de línea de mandatos avanzada para el cliente de scripts wsadmin. En la documentación de WebSphere Application encontrará información de referencia sobre la sintaxis de invocación de línea de mandatos. Consulte el tema Herramienta Wsadmin para obtener más detalles. Este WebSphere Application Server Administrative Script Launcher ya maneja la siguiente información que se pasa al cliente de scripts wsadmin:
    • El nombre de archivo y la vía de acceso del archivo de script
    • El lenguaje del archivo de script
    • El nombre del perfil de WebSphere Application Server del perfil que se utiliza para ejecutar el archivo de script
    • El ID de usuario y la contraseña para autenticarse en el servidor seguro de destino
    No especifique la información de nuevo en el campo Argumentos de wsadmin.

    Si ejecuta los scripts administrativos sobre un servidor remoto, especifique si está utilizando un tipo de conexión de método remoto (RMI) o SOAP y su valor de puerto. Si la seguridad está habilitada en el servidor remoto, especifique los parámetros -user y -password. Utilice una de las sintaxis de mandato siguientes en el campo Argumentos de wsadmin:

    • Para el tipo de conexión SOAP:
      -conntype SOAP [-host nombre_host] [-port número_puerto] [-user ID_usuario] [-password contraseña] 

      Por ejemplo: -conntype SOAP -host miordenador.miempresa.com -port 8800 -user miIDusuario -password miContraseña

    • Para el tipo de conexión RMI:
      -conntype RMI [-host nombre_host] [-port número_puerto] [-user ID_usuario] [-password contraseña] 

      Por ejemplo: -conntype RMI -host miordenador.miempresa.com -port 2809 -user miIDusuario -password miContraseña

    Consejo: Si desea pasar argumentos al script Jython, no los especifique en este campo de argumentos wsadmin, ya que este campo es el destino para el cliente de scripts wsadmin. En su lugar, seleccione la páginaArgumentos y el recuadro de texto Argumentos de programa para especificar los argumentos del programa.
    Nota: Si tiene que especificar los argumentos de programa para ejecutar los scripts Jython, tenga en cuenta que el primer parámetro del programa se utiliza con fines distintos al depurar que al ejecutar los scripts de Jython.
  9. En la sección Seguridad, especifique si el script se ejecuta en un servidor que es seguro seleccionando una de las opciones siguientes.
    Opción Descripción
    No hay seguridad en servidor de destino Especifica que el script se ejecuta en un servidor que no es seguro.
    Como se define en el archivo soap.client.props o sas.client.props

    Especifica que el script se ejecuta en un WebSphere Application Server seguro y se ha proporcionado información de autenticación en los archivos sas.client.props o soap.client.props para comunicarse con este servidor seguro.

    Los archivos sas.client.props y soap.client.props se encuentran en el directorio de propiedades de cada perfil de WebSphere Application Server, por ejemplo x:/profilePath/properties.

    Si utiliza un conector de invocación a método remoto (RMI), establezca valores adecuados para las siguientes propiedades en el archivo sas.client.props.

    com.ibm.CORBA.loginUserid=
    com.ibm.CORBA.loginPassword=
    Además, establezca la siguiente propiedad:
    com.ibm.CORBA.loginSource=properties
    El valor predeterminado de esta propiedad es prompt en el archivo sas.client.props. Si deja el valor predeterminado, aparecerá un recuadro de diálogo con un indicador de solicitud de contraseña. Si el script se ejecuta desatendido, parece que se cuelgue.
    Si utiliza un conector de protocolo de acceso a objetos simple (SOAP), establezca valores adecuados para las siguientes propiedades en el archivo soap.client.props:
    com.ibm.SOAP.securityEnabled=true
    com.ibm.SOAP.loginUserid=
    com.ibm.SOAP.loginPassword=
    Si lo desea, establezca la siguiente propiedad:
    com.ibm.SOAP.loginSource=none
    Puede encontrar el valor predeterminado de esta propiedad en el archivo soap.client.props. Si acepta el valor predeterminado y no proporciona los valores loginUserid y loginPassword, aparece un recuadro de diálogo con un indicador de solicitud de contraseña. Si el script se ejecuta desatendido, parece que se cuelgue.
    Nota: Si especifica el usuario y la contraseña en la sección Especificar y en el archivo sas.client.props o el archivo soap.client.props, WebSphere Application Server Administrative Script Launcher sustituye la información en el archivo .props.
    Especificar Especifica que el script se ejecuta en un servidor que es seguro.

    En los campos ID de usuario y Contraseña, escriba el ID de usuario y la contraseña para autenticarse en este servidor seguro de destino.

    Si especifica información de ID de usuario y contraseña en esta sección y en el archivo sas.client.props o el archivo soap.client.props, WebSphere Application Server Administrative Script Launcher sustituye la información en el archivo .props.

    Atención: El uso del campo contraseña puede provocar riesgos de seguridad porque la información de contraseña se vuelve visible para el programa de estado del sistema como por ejemplo el mandato ps, que puede ser iniciado por otros usuarios para visualizar todos los procesos en ejecución. No utilice esta opción si la exposición a riesgos de seguridad representa un problema. En su lugar, seleccione Del modo definido en el archivo soap.client.props o sas.client props y especifique la información de ID de usuario y contraseña en el archivo soap.client.props para el conector SOAP o el archivo sas.client.props para el conector RMI. Los archivos soap.client.props y sas.client.props se encuentran en el directorio de propiedades del perfil de WebSphere Application Server.
  10. Pulse Aplicar para guardar la configuración. Los argumentos de VM adecuados y las vías de acceso de clase correspondientes al entorno de ejecución de WebSphere Application Server seleccionada se llenan automáticamente.
    Consejo: Si cambia la selección de la lista de Entorno de ejecución de scripts, pulse Aplicar para cada que cambio llene automáticamente los argumentos de VM y las vías de acceso de clases correctos para el entorno de ejecución de WebSphere Application Server que acaba de seleccionar.
  11. Compruebe que tiene los puntos de interrupción establecidos en el editor Jython (como se ha especificado en los pasos anteriores). De lo contrario, la sesión de depuración se ejecuta hasta el final.
  12. Pulse Depurar para depurar el script. Se abre la perspectiva Depurar.

Qué hacer a continuación

El depurador se suspende en el punto de interrupción establecido en el script Jython, y puede continuar depurando el script en la perspectiva Depurar.
Icono que indica el tipo de tema Tema de tarea
Términos y condiciones para centros de información | Comentarios

Icono de indicación de fecha y hora Última actualización: 22 de abril de 2014

Nombre de archivo: tjythondebug.html