您可以使用 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 Business Integration Server Express 的管理工具集安装,则如果在系统上检测到 WebSphere Application Server 或 WebSphere Application Server Express V5.0.2 或 5.1,将自动安装并配置失败事件监视器。仅必须配置基于角色的安全性。参阅为失败事件管理器设置安全性。
缺省情况下,在安装 Tomcat 与失败事件管理器之后将启用安全性(请参阅《WebSphere Business Integration Server Express 安装指南 Windows 版》、《WebSphere Business Integration Server Express 安装指南 Linux 版》或《WebSphere Business Integration Server Express 安装指南 OS/400 版》。)必须在 Tomcat_home\conf\tomcat-users.xml 文件中创建具有 Administrator 角色的用户,以便管理员可以获取对应用程序的全部访问权。有关如何在失败事件管理器中创建角色的详细信息,参阅为失败事件管理器设置安全性。
本节包括下列过程:
管理员必须设置安全性以将失败事件管理器与 WebSphere Application Server 配合使用。另外,如果您的小组想使用比四个缺省用户角色更多的角色,管理员还可以创建额外的安全角色。有不同的方式来创建这些角色,取决于您是将 WebSphere Application Server 还是 Tomcat 与失败事件管理器配合使用。
如果您的组将 Tomcat 与失败事件管理器配合使用,则启用缺省的基于角色的安全性没有额外的步骤。如果您使用 WebSphere Application Server,则管理员必须启用安全性。
执行下列步骤来使用 WebSphere Application Server 为失败事件管理器启用基于角色的安全性:
OS/400 |
---|
对于 OS/400,执行以下步骤来启动 WebSphere Application Server:
|
出现“全局安全性”页面。
出现“主管理控制台”页面。
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,则执行以下步骤来创建定制角色:
OS/400 |
---|
对于 OS/400,在 OS/400 上而不是在 Windows 上装入 WAR
文件。因此您必须将它复制到 Windows 或将一个驱动器从 Windows 映射至
OS/400。OS/400 上的该文件是
/qibm/proddata/wbiserver43/product/WBFEM/WAS/FailedEvents.war。
|
您可以在单独的编辑器(如记事本)中输入值并将它粘贴至值字段中。
该参数值是以下格式的字符串:
<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
WebSphere Application Server 包括一个称为“应用组装工具”的工具,管理员使用该工具来编辑 WAR 文件和创建定制的角色。(对于 OS/400,管理员在 Windows 上使用该工具来编辑存储并部署在 OS/400 上的 JAR 文件)。
如果您正在使用 WebSphere Application Server,则执行以下步骤来创建定制角色:
WAR 文件的完整结构显示在左窗格中。
该参数值是以下格式的字符串:
<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”指在协作或连接器中事件的故障点。
本节仅适用于 Windows 和 Linux 系统。OS/400 不支持 Tomcat。
如果您正在使用 Tomcat,则执行以下步骤来创建定制用户和角色:
<auth-constraint id="AuthConstraint_1062537631424"> <description>SC1:+:</description> <role-name>Administrator</role-name> <role-name>ViewEvents</role-name> <role-name>ViewAll</role-name> <role-name>SubmitEvents</role-name> <role-name>Manager</role-name> </auth-constraint>
<security-role id="SecurityRole_1068513225089"> <description>Can manage all events.</description> <role-name>Manager</role-name> </security-role>
<servlet id="Servlet_1062537018298"> <servlet-name>Login</servlet-name> <display-name>Login</display-name>
<servlet-class> com.ibm.btools.itools.FailedEvents.servlets.Login </servlet-class> <init-param id="InitParam_1063835207426"> <param-name>ROLECOMPONENTS</param-name> <param-value> role1: event_owners SourceToDestCollab |role2:event_owners=Collab2* bos=CUSTOMER2.Create#2/4 |role3:event_owners=SourceToDestCollab, Collab2 </param-value> <description> Roles and components (collabs or connectors) associated with these roles. </description> </init-param> </servlet>
该参数值是以下格式的字符串:
<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”指在协作或连接器中事件的故障点。
只能通过仅在 Windows 平台上受支持的浏览器来访问失败事件管理器。受支持的浏览器为:
执行下列步骤来登录到失败事件管理器:
http://HostName/FailedEvents
其中 HostName 是安装了 WebSphere Application Server 的计算机的名称。
http://HostName:nnnn/FailedEvents
其中 HostName 是安装了 WebSphere Application Server 的计算机的名称,而 nnnn 是端口号。
在登录后,将出现“查询”对话框,如图 62 中所示。
执行下列步骤来在失败事件管理器中查看有关失败事件的信息:
出现失败事件表,如图 63 中所示。
如果未给您指定一个有权查看业务对象的角色,则业务对象按钮在此表中可能不可用,如图 64 中所示。
出现“事件详细信息”对话框,如图 65 中所示。
在失败事件表中执行下列步骤来处理失败事件:
执行下列步骤来检查指定给您的角色是否基于满足失败事件管理器角色的安全性:
出现一个页面,列示了可用的缺省角色。您可以输入一个角色名以查看是否给您指定了该角色。
要找到、查看和处理失败事件,使用流管理器,它是与 InterChange Server Express 产品一起安装的工具。流管理器使您可以容易地构造一个查询来找到并显示未解析的流。在显示未解析的流之后,可以选择屏幕中的任何流并提交它、废弃它或执行其它操作。有关失败的流的背景信息,请参阅流故障。
以下主题描述使用流管理器来构造查询、查看详细信息和处理事件:
执行以下步骤以启动流管理器:
当您单击“连接至 InterChange Server”对话框中的连接之后,流管理器打开(请参阅图 70)。
在流管理器中执行下列步骤来查找所有未解析的流:
单击事件属性选项卡以根据未解析的事件的特征进行搜索(请参阅图 72)。
事件属性选项卡中具有以下选项:
选择用于查询每个事件的查询描述。
选择要查询的流所在的连接器或源连接器,或选择任何。
使用日期和时间选项卡来仅查询在特定时间段失败的流(请参阅图 73)。
日期和时间选项卡中具有以下选项:
使用错误文本和业务对象属性选项卡来构造仅包括某些业务对象、业务对象属性和属性值的查询(请参阅图 74)。
在以下各列中选择值:
您还可以仅查询生成消息的未解析流,该消息包含您在包含错误文本字段中输入的指定文本。
执行下列步骤来在流管理器中查看未解析流的详细信息:
结果显示在“流管理器”窗口的下半部(请参阅图 71)。
出现未解析的流表,列示了事件和下列信息:
对于正在等待的事件,事件状态单元包含以下信息:
Waiting
[timeout expiration:...]
[scenario name:...]
[scenario node ID...]
如果要对任何未解析的流执行操作,则参阅处理未解析的流的步骤。
执行下列其中一个步骤来管理您为未解析的流创建的查询:
执行下列步骤来管理您为未解析的流创建的查询:
执行下列步骤来在流管理器中处理结果列表中的任何失败事件: