处理失败事件

您可以使用 IBM WebSphere InterChange Server Express 中的两个工具来查找、查看和处理失败事件:失败事件管理器(一个使用基于角色的安全性的基于浏览器的工具,它允许您从 Web 处理失败事件)和流管理器(一个与 InterChange Server Express 产品一起安装的工具)。要解析事务性流,您必须使用流管理器,但失败事件管理器和流管理器都允许您处理失败事件。本节包括以下内容:

使用失败事件管理器

使用流管理器

使用失败事件管理器

失败事件管理器允许您从 Web 查看和管理失败事件。 您可以对这些失败事件执行的操作取决于基于角色的安全性。管理员可以给用户指定四个缺省角色中的一个或多个角色:

管理员也可以使用应用组装工具为特定小组创建定制角色。

失败事件管理器与 IBM WebSphere Application Server 或 Tomcat 一起工作(仅限于 Windows 和 Linux 系统)。有关设置失败事件管理器以与 WebSphere Application Server、WebSphere Application Server Express 或 Tomcat 一起工作的其它信息,请参阅《WebSphere Business Integration Server Express 安装指南 Windows 版》、《WebSphere Business Integration Server Express 安装指南 Linux 版》或《WebSphere Business Integration Server Express 安装指南 OS/400 版》。OS/400 不支持 Tomcat。

失败事件管理器与以下版本的 WebSphere Application Server、WebSphere Application Server Express 和 Tomcat 一起工作:

本节包括下列过程:

为失败事件管理器设置安全性

管理员必须设置安全性以将失败事件管理器与 WebSphere Application Server 配合使用。另外,如果您的小组想使用比四个缺省用户角色更多的角色,管理员还可以创建额外的安全角色。有不同的方式来创建这些角色,取决于您是将 WebSphere Application Server 还是 Tomcat 与失败事件管理器配合使用。

为失败事件管理器和 WebSphere Application Server 设置安全性的步骤

如果您的组将 Tomcat 与失败事件管理器配合使用,则启用缺省的基于角色的安全性没有额外的步骤。如果您使用 WebSphere Application Server,则管理员必须启用安全性。

执行下列步骤来使用 WebSphere Application Server 为失败事件管理器启用基于角色的安全性:

  1. 通过执行下列操作来启动 WebSphere Application Server:
  2. 在左导航框上,单击安全性 > 用户注册表 > 本地 OS
  3. 在“本地用户注册表”页面上,输入一个有效的本地 OS 用户名和密码,并单击确定

    出现“全局安全性”页面。

  4. 一般属性下,选择启用复选框。
  5. 确保清除了强制执行 Java2 安全性复选框,让其它缺省值保持不变,并单击确定
  6. 在关于本地配置的更改的消息上单击保存按钮。出现“保存”页面。
  7. 保存至主配置下,单击保存
  8. 重新启动 WebSphere Application Server(请参阅步骤 1)。
  9. 打开管理控制台。如果已正确配置安全性,则控制台页面会要求输入用户名和密码(它们是您在步骤 3 中的“本地用户注册表”页面上输入的值),并单击确定

    出现“主管理控制台”页面。

  10. 执行下列操作来在 WebSphere Application Server 上安装“失败事件管理器”应用程序(如果尚未安装)
  11. 重新启动 WebSphere Application Server。

使用 WebSphere Application Server Express 为失败事件管理器创建定制角色的步骤

WebSphere Application Server Express 包括一个称为 Studio Site Developer 的工具,管理员使用该工具来编辑 WAR 文件和创建定制的角色。Studio Site Developer 包括在第二张 WebSphere Application Server CD 上;您可从此处安装它。关于安装 WebSphere Studio Site Developer 工具的详细信息,请参阅 《WebSphere Business Integration Server Express 安装指南 Windows 版》、《WebSphere Business Integration Server Express 安装指南 Linux 版》或《WebSphere Business Integration Server Express 安装指南 OS/400 版》。

如果您正在使用 WebSphere Application Server Express,则执行以下步骤来创建定制角色:

  1. 通过单击启动 > 程序 > IBM WebSphere Application Server Express 5.1.1 > Studio Site Developer 来启动 Studio Site Developer。
  2. 打开 Web 透视图。在工作台启动之后,单击窗口 > 打开透视图 > Web
  3. 通过单击文件 > 导入、选择文件并单击下一步来导入要编辑的 FailedEvents.war 文件。
    OS/400

    对于 OS/400,在 OS/400 上而不是在 Windows 上装入 WAR 文件。因此您必须将它复制到 Windows 或将一个驱动器从 Windows 映射至 OS/400。OS/400 上的该文件是 /qibm/proddata/wbiserver43/product/WBFEM/WAS/FailedEvents.war
    不要在 proddata 中编辑该文件。将它复制到 OS/400 上的另一个路径,在那里编辑它,然后从新位置部署更改后的 WAR 文件。

  4. 单击浏览按钮以选择要编辑的 FailedEvents.war 文件。
  5. 通过执行下列操作来创建 Web 项目:
  6. 展开 FailedEventWebProject 并双击 Web 部署描述符。一个选项卡式窗口将在编辑器中打开,缺省情况下显示概述选项卡。
  7. 通过执行下列操作来创建定制角色:
  8. 在“安全性”屏幕上单击安全性约束选项卡并通过执行下列操作将新的角色添加至安全性约束:
  9. 单击“编辑器”屏幕底部的 Servlet 选项卡并编辑登录 servlet 的初始化参数以描述您创建的每个角色:
  10. 单击文件 > 保存以将项目保存在 Studio Site Developer 中。
  11. 通过在““项目导航器”视图中右键单击 Web 项目并单击导出来将该项目导出至 WAR 文件:

使用 WebSphere Application Server 为失败事件管理器创建定制角色的步骤

WebSphere Application Server 包括一个称为“应用组装工具”的工具,管理员使用该工具来编辑 WAR 文件和创建定制的角色。(对于 OS/400,管理员在 Windows 上使用该工具来编辑存储并部署在 OS/400 上的 JAR 文件)。

如果您正在使用 WebSphere Application Server,则执行以下步骤来创建定制角色:

  1. 通过选择开始 > 程序 > IBM WebSphere Application Server > 应用组装工具来启动应用组装工具。
  2. 在“欢迎使用”对话框中,单击现有的选项卡并进行浏览以选择 FailedEvents.war 文件。单击确定

    WAR 文件的完整结构显示在左窗格中。

  3. 右键单击安全角色并单击新建
  4. 在“新建安全角色”对话框中,为新角色输入名称和描述,并单击确定
  5. 展开安全性约束并从左窗格选择 SC1
  6. 在右窗格中,在授权约束下,单击添加
  7. 选择您创建的角色并单击确定
  8. 单击应用
  9. 从左窗格的根部,展开“Web 组件”-> 展开“登录”-> 右键单击“初始化参数”。
  10. 选择“角色组件”参数并编辑参数值。

    该参数值是以下格式的字符串:

    <RoleName1>:event_owners=<ownername>*connectors=<connectorName>*bos=
     

    <boname.verb>#
     

    <CompositeKeyValue>+<CompositekeyValue2>/<AnotherPossibleKeyValue>  |
     

     <RoleName2>: 
     

    ......
     

    < | > - 分隔两个角色

    < : > - 将角色名与角色的组件分开

    < * > - 分隔角色中的组件(连接器和业务对象)

    < = > - 将组件名与其值分开

    < , > - 分隔组件内的值

    < # > - 将业务对象名与它的键值分开

    < / >- 分隔业务对象可能具有的键(相同的业务对象 - 不同的键)

    < + > - 分隔业务对象的组合键(确保以这些键值在业务对象中出现的特定顺序提供它们)

    例如:

    Role1:event_owners=collab1, collab2*connectors=conn1, 
     conn2*bos=bo1.create#55/67, 
     

    bo2.delete#99/80
     

     |Role2:event_owners=collab3,collab4*connectors=conn3*bos=bo4.create
     #59+9876/82, bo2.delete#56
     

    在此示例中,“event_owners”指在协作或连接器中事件的故障点。

  11. 在输入参数值之后,单击应用
  12. 单击文件 > 保存。WAR 文件已随时可以部署。
  13. 在创建这些角色之后,必须再次设置安全性。转至为失败事件管理器和 WebSphere Application Server 设置安全性的步骤

使用 Tomcat 为失败事件管理器创建定制用户和角色的步骤

本节仅适用于 Windows 和 Linux 系统。OS/400 不支持 Tomcat。

如果您正在使用 Tomcat,则执行以下步骤来创建定制用户和角色:

  1. 编辑位于 Tomcat_Home\conf 下的 tomat-users.xml 文件以按需要作出以下更改:
  2. 保存该文件。
  3. 编辑位于 Tomcat_Home\webapps\FailedEvents\WEB-INF 下的 web.xml 文件以添加您在步骤 1 中添加至 tomat-users.xml 文件的角色。执行下列操作:
  4. 保存该文件。
  5. 从命令行启动 Tomcat 以调用 setclasspath.bat 文件:Tomcat_home/bin/startup.bat

登录到失败事件管理器的步骤

只能通过仅在 Windows 平台上受支持的浏览器来访问失败事件管理器。受支持的浏览器为:

执行下列步骤来登录到失败事件管理器:

  1. 在 Windows 上打开浏览器并输入下列其中一个 URL,这取决于为您的小组设置失败事件管理器的方式:
  2. 如果启用了安全性,则您必须输入应用程序服务器用户名和密码。
  3. 在“连接”屏幕中,输入服务器名用户名密码,然后单击登录

    图 61. 失败事件管理器“连接”屏幕


    在登录后,将出现“查询”对话框,如图 62 中所示。

    图 62. 失败事件管理器“查询”对话框


查看失败事件的步骤

执行下列步骤来在失败事件管理器中查看有关失败事件的信息:

  1. 在“查询”页面上,选择有关您要查看的失败事件的信息:
  2. 单击提交

    出现失败事件表,如图 63 中所示。

    图 63. 失败事件管理器的失败事件表


    如果未给您指定一个有权查看业务对象的角色,则业务对象按钮在此表中可能不可用,如图 64 中所示。

    注:
    根据浏览器的不同,按钮或其它控件不显示或显示但不可用。

    图 64. 失败事件管理器中无权查看业务对象的失败事件表


  3. 如果您要查看特定失败事件的详细信息,则选择左列中的复选框并单击详细信息列中的查看

    出现“事件详细信息”对话框,如图 65 中所示。

    图 65. 失败事件管理器“事件详细信息”对话框


  4. 如果给您指定了有权访问业务对象的角色,则单击业务对象列中的业务对象按钮以查看关于业务对象的详细信息。出现“业务对象数据”对话框,如图 66 中所示。

    图 66. 失败事件管理器“业务对象数据”对话框


在失败事件管理器中处理失败事件的步骤

在失败事件表中执行下列步骤来处理失败事件:

  1. 对您要处理的失败事件选择左列中的复选框。
  2. 执行下列其中一项操作:

在失败事件管理器中检查您的访问权的步骤

执行下列步骤来检查指定给您的角色是否基于满足失败事件管理器角色的安全性:

  1. 登录至失败事件管理器(请参阅登录到失败事件管理器的步骤)。
  2. 在打开的查询页面上,单击底部左边的检查您的访问权链接。

    出现一个页面,列示了可用的缺省角色。您可以输入一个角色名以查看是否给您指定了该角色。

使用流管理器

要找到、查看和处理失败事件,使用流管理器,它是与 InterChange Server Express 产品一起安装的工具。流管理器使您可以容易地构造一个查询来找到并显示未解析的流。在显示未解析的流之后,可以选择屏幕中的任何流并提交它、废弃它或执行其它操作。有关失败的流的背景信息,请参阅流故障

以下主题描述使用流管理器来构造查询、查看详细信息和处理事件:

启动流管理器的步骤

查找未解析的流的步骤

"查看未解析流的详细信息的步骤"

处理未解析的流的步骤

启动流管理器的步骤

执行以下步骤以启动流管理器:

  1. 单击开始 > 程序 > IBM WebSphere Business Integration Express > Toolset Express > 管理 > 流管理器。出现“连接至 InterChange Server”对话框(请参阅图 67

    图 67. 连接至 InterChange Server 对话框


  2. 使用以下任一方法来输入服务器名称:
  3. 输入您要连接至的服务器的用户名和密码。如果选择记住用户名和密码复选框,则用户名和密码将与服务器名称一起存储在注册表中,并且将加密该密码。单击连接
    注:
    要从注册表中除去不想要的用户或服务器,单击“选项”。这将打开“选项”对话框,可从中除去服务器或用户。
    下图显示“选项”对话框。

    图 69. 选项对话框


当您单击“连接至 InterChange Server”对话框中的连接之后,流管理器打开(请参阅图 70)。

图 70. 流管理器


查找未解析的流的步骤

在流管理器中执行下列步骤来查找所有未解析的流:

  1. 启动流管理器。请参阅启动流管理器的步骤
  2. 执行下列其中一项操作:
  3. 在指定搜索条件之后,单击查找按钮或单击事件 > 查找。结果显示在“流管理器”窗口的下半部(请参阅图 71)。

    图 71. 显示过滤结果的流管理器


  4. 要将当前过滤器信息另存为查询,单击查询 > 保存。您输入的查询名称显示在查询列表中。

事件属性选项卡

单击事件属性选项卡以根据未解析的事件的特征进行搜索(请参阅图 72)。

图 72. 流管理器“事件属性”选项卡


事件属性选项卡中具有以下选项:

“日期和时间”选项卡

使用日期和时间选项卡来仅查询在特定时间段失败的流(请参阅图 73)。

图 73. “日期和时间”选项卡


日期和时间选项卡中具有以下选项:

“错误文本和业务对象属性”选项卡

使用错误文本和业务对象属性选项卡来构造仅包括某些业务对象、业务对象属性和属性值的查询(请参阅图 74)。

图 74. “错误文本和业务对象属性”选项卡


在以下各列中选择值:

您还可以仅查询生成消息的未解析流,该消息包含您在包含错误文本字段中输入的指定文本。

注:
您在包含错误文本字段中输入的关键字不区分大小写。

查看未解析流的详细信息的步骤

执行下列步骤来在流管理器中查看未解析流的详细信息:

  1. 查询列表选择一个查询。
  2. 执行下列其中一项操作:

    结果显示在“流管理器”窗口的下半部(请参阅图 71)。

    出现未解析的流表,列示了事件和下列信息:

    对于正在等待的事件,事件状态单元包含以下信息:


    Waiting
    [timeout expiration:...]
    [scenario name:...]
    [scenario node ID...]

  3. 要访问有关任何事件的更多信息,双击包含该事件的行(或单击事件 > 全部选择)。这样会打开“显示事件详细信息”对话框(请参阅图 75)。

    图 75. 流管理器“显示事件详细信息”对话框


  4. 要访问关于与选择的事件相关联的业务对象的更多信息,单击事件 > 显示详细信息。出现“显示业务对象数据”对话框(请参阅图 76)。

    图 76. “显示业务对象数据”对话框


如果要对任何未解析的流执行操作,则参阅处理未解析的流的步骤

管理查询的步骤

执行下列其中一个步骤来管理您为未解析的流创建的查询:

管理查询结果的步骤

执行下列步骤来管理您为未解析的流创建的查询:

  1. 在流管理器的结果列表中,在结果列表中选择一个或多个事件。
  2. 执行下列其中一项操作:

处理未解析的流的步骤

执行下列步骤来在流管理器中处理结果列表中的任何失败事件:

  1. 在流管理器的结果列表中,在结果列表中选择一个或多个事件。
  2. 执行下列其中一项操作:

Copyright IBM Corp. 2004