在 WebSphere Application Server 上调试 Jython 脚本文件

您可以使用调试器在 Jython 脚本中检测和诊断错误。您可以通过设置断点、暂挂线程、逐步执行代码以及检查变量内容来控制脚本的运行。要调试 Jython 脚本,请使用 WebSphere® Application Server 管理脚本启动程序以设置要解释脚本的运行时环境以及安全设置;如果脚本正在受保护服务器上运行。

开始之前

限制: WebSphere Application Server V6.1 和更高版本是调试 Jython 脚本文件唯一支持的运行时环境。但是,相对于调试 Jython 脚本文件,当您运行 Jython 脚本文件时,具有受支持运行时环境的不同列表。请参阅“在 WebSphere Application Server 上运行管理脚本文件”,以获取详细信息。
提示: 运行 Jython 脚本和调试 Jython 脚本的差别在于,调试 Jython 脚本时,可以在脚本中设置断点;而运行 Jython 脚本时,在不中断的情况下运行脚本。
限制: 要调试 Jython 脚本,必须通过在工作台中创建 Jython 脚本或将此脚本导入工作台,使 Jython 脚本位于工作台中。相对于在文件系统上运行 Jython 脚本,必须在工作台中调试 Jython 脚本。当您在文件系统上工作台外部调试 Jython 脚本时,调试工具(例如,用于设置断点的断点边界)不可用。

关于此任务

要调试 Jython 脚本:

过程

  1. 在 Jython 编辑器中打开 Jython 脚本文件:
    1. 在“导航器”视图中,展开包含您希望调试的 Jython 脚本文件的 Jython 项目。
    2. 右键单击 Jython 脚本文件。
    3. 在菜单中,选择打开方式 > Jython 编辑器
  2. 在 Jython 脚本中设置断点。要在 Jython 编辑器中设置一个或多个断点,请在您希望设置为断点的代码行旁的边界中双击。
  3. 在 Jython 编辑器中右键单击,并在菜单中选择调试方式 > 管理脚本 将打开 WebSphere Application Server 管理脚本启动程序。使用 WebSphere Application Server 管理脚本启动程序以从开发环境中在 WebSphere Application Server 上调试管理脚本文件。
  4. 脚本页面是 WebSphere Application Server 管理脚本启动程序的主页。
  5. 管理脚本字段会自动预填充脚本文件的路径。
  6. 脚本编制运行时环境列表中,选择 WebSphere Application Server 运行时环境的名称,如“首选项”页面中所定义(窗口 > 首选项 > 服务器 > 运行时环境)。 您必须指定本地文件系统上用于解释脚本文件的运行时环境。如果您希望解释脚本文件的运行时环境不在列表中,请单击新建以定义新的 WebSphere Application Server 运行时环境。将打开“新建服务器运行时环境”向导。可以使用“新建服务器运行时环境”向导创建任何运行时环境。但是,当您使用 WebSphere Application Server 管理脚本启动程序来调试 Jython 脚本时,仅支持本地 WebSphere Application Server V6.1 或更高版本运行时环境进行调试。
  7. 概要文件名称列表中,选择属于先前选择的运行时环境的概要文件。概要文件是一组定义运行时环境的文件。 如果选择[未指定]选项,那么工具将选择为其分配了缺省角色的概要文件。
  8. wsadmin 参数字段中,为 wsadmin 脚本编制客户机指定高级命令行调用语法。 命令行调用语法引用在 WebSphere Application 文档中提供,请参阅 Wsadmin 工具主题,以获取更多详细信息。 此 WebSphere Application Server 管理脚本启动程序已处理传递到 wsadmin 脚本编制客户机的以下信息:
    • 脚本文件的文件名和路径
    • 脚本文件的语言
    • 用于运行脚本文件的 WebSphere Application Server 概要文件的名称
    • 用于认证目标受保护服务器的用户标识和密码
    请勿再次在 wsadmin 参数字段中指定信息。

    如果您正在远程服务器上运行管理脚本,那么指定是使用远程方法调用 (RMI) 还是使用 SOAP 连接类型及其端口值。如果在远程服务器上启用安全性,那么指定 -user-password 参数。 在 wsadmin 参数字段中使用以下其中一个命令语法:

    • 针对 SOAP 连接类型:
      -conntype SOAP [-host host_name] [-port port_number] [-user userid] [-password password]

      例如:-conntype SOAP -host mycomputer.mycompany.com -port 8800 -user myUserID -password myPassword

    • 针对 RMI 连接类型:
      -conntype RMI [-host host_name] [-port port_number] [-user userid] [-password password]

      例如:-conntype RMI -host mycomputer.mycompany.com -port 2809 -user myUserID -password myPassword

    提示: 如果您想要将参数传递到 Jython 脚本,请勿在此 wsadmin 参数字段中指定这些参数,因为此字段是 wsadmin 脚本编制客户机的目标。改为选择参数页面,并在程序参数文本框中指定程序参数。
    注: 如果需要指定用于运行 Jython 脚本的程序参数,请记住,第一个程序参数在调试 Jython 脚本时与调试 Jython 脚本时用于不同用途。
  9. 安全性部分中,通过选择以下其中一个选项来指定脚本是否在受保护服务器上运行。
    选项 描述
    目标服务器不具有安全性 指定脚本在不受保护的服务器上运行。
    如 soap.client.props 或 sas.client.props 文件中所定义

    指定脚本在受保护 WebSphere Application Server 上运行,且在 sas.client.props 或 soap.client.props 文件中提供了认证信息来与此受保护服务器进行通信。

    sas.client.props 和 soap.client.props 文件位于每个 WebSphere Application Server 概要文件的 properties 目录中(例如,x:/profilePath/properties)。

    如果您使用远程方法调用 (RMI) 连接器,那么使用相应值在 sas.client.props 文件中设置以下属性的值。

    com.ibm.CORBA.loginUserid=
    com.ibm.CORBA.loginPassword=
    此外,设置以下属性:
    com.ibm.CORBA.loginSource=properties
    在 sas.client.props 文件中,此属性的缺省值为 prompt。如果保留缺省值,那么会显示一个对话框,提示输入密码。如果脚本以不受照管方式运行,那么会显示为暂挂。
    如果您使用简单对象访问协议 (SOAP) 连接器,那么使用相应值在 soap.client.props 文件中设置以下属性的值。
    com.ibm.SOAP.securityEnabled=true
    com.ibm.SOAP.loginUserid=
    com.ibm.SOAP.loginPassword=
    (可选)设置以下属性:
    com.ibm.SOAP.loginSource=none
    您可以在 soap.client.props 文件中查找此属性的缺省值。如果接受缺省值且未提供 loginUseridloginPassword 值,那么会显示一个对话框,提示输入密码。如果脚本以不受照管方式运行,那么会显示为暂挂。
    注: 如果在“指定”部分和 sas.client.props 文件或 soap.client.props 文件中指定用户和密码,那么 WebSphere Application Server 管理脚本启动程序会覆盖 .props 文件中的信息。
    指定 指定脚本在受保护的服务器上运行。

    用户标识密码字段中,输入用户标识和密码以认证此目标受保护服务器。

    如果在此部分和 sas.client.props 文件或 soap.client.props 文件中指定用户标识和密码信息,那么 WebSphere Application Server 管理脚本启动程序会覆盖 .props 文件中的信息。

    注意: 使用密码字段会导致安全漏洞,因为密码信息对系统状态程序(例如,ps 命令)变为可见,此程序可由其他用户启动以显示所有运行的进程。 如果安全漏洞存在问题,请勿使用此选项。改为选择如 soap.client.props 或 sas.client props 文件中所定义;在针对 SOAP 连接器的 soap.client.props 文件或针对 RMI 连接器的 sas.client.props 文件中指定用户标识和密码信息。soap.client.propssas.client.props 文件位于 WebSphere Application Server 概要文件的 properties 目录中。
  10. 单击应用以保存配置。 所选 WebSphere Application Server 运行时环境的相应 VM 参数和类路径会自动填充。
    提示: 如果更改脚本编制运行时环境列表的选择,那么针对每个更改单击应用,以自动填充新选择的 WebSphere Application Server 运行时环境的正确 VM 参数和类路径。
  11. 验证是否已在 Jython 编辑器中设置了断点(在先前步骤中指定)。否则,调试会话运行,直到完成。
  12. 单击调试以调试脚本。 将打开“调试”透视图。

下一步做什么

调试器在 Jython 脚本上设置的断点上暂挂,您可以进一步在“调试”透视图中调试脚本。
指示主题类型的图标 任务主题
信息中心的条款和条件 | 反馈

时间戳记图标 最近一次更新时间: 2014 年 4 月 17 日

文件名:tjythondebug.html