管理对象请求代理程序

本节包含有关解决与 IBM Java 对象请求代理程序(ORB)相关问题的信息,该软件处理 InterChange Server Express 及其若干组件之间的通信。本节提供有关以下主题的信息:

对象请求代理程序安装

InterChange Server Express 需要 IBM Java ORB 才能与其若干组件(包括适配器和系统管理器)通信。要使用 ORB,则要求安装 IBM Java ORB。

IBM Java ORB 是作为 IBM Java 运行时环境(JRE)软件的一部分安装的,WebSphere InterChange Server Express 安装程序自动安装该软件。

定制对象请求代理程序的步骤

执行下列其中一个步骤来定制对象请求代理程序:

  1. 参阅表 22,以了解 IBM Java ORB 支持的属性来定制其行为。
  2. 以命令行选项的形式将 IBM ORB 属性及其值指定给组件的启动脚本。当您从命令行指定 IBM ORB 属性时,则您将仅为正在启动的组件更改该属性。通过在 ORB 属性前加上 -D 命令行选项来指定该属性。从命令行指定的属性将覆盖系统内部或来自 CWSharedEnv 文件中的任何其它属性设置。
  3. CWSharedEnv 文件中编辑适当的变量。当您在 CWSharedEnv 文件中更改变量时,您将为启动过程期间读取此文件的所有组件更改该属性。这些组件包括任何适配器、InterChange Server Express 实例、repos_copy 实用程序和 InterChange Server Express 工具。
    注:
    有关 CWSharedEnv 文件的更多信息,请参阅管理运行时属性的步骤

    表 22 所示,ORB 位置由 CWSharedEnv 文件中的特殊变量指定。您必须在 CWSharedEnv 文件中修改这些变量才能更改其位置。

    其它 ORB 属性列示在 CWSharedEnv 文件的 ORB_PROPERTY 变量中。在此变量中,每个 IBM ORB 属性前加有 -D 命令行选项。要添加或更改 ORB 属性,您必须在 CWSharedEnv 文件的 ORB_PROPERTY 变量中添加或更改适当的 -D 选项。您在 CWSharedEnv 文件中指定的属性覆盖来自配置文件中的任何其它设置。

  4. 在适当的配置(.cfg)文件中指定配置参数(如果存在的话)。可在配置文件的 CORBA 节中用配置参数设置许多 ORB 属性。InterChange Server Express 配置文件(InterchangeSystem.cfg)和适配器本地配置文件都可包含 CORBA 节。当您在 CORBA 配置文件中指定配置参数时,您将为 ORB 服务器执行的所有与 ORB 相关的任务更改该配置参数。
    重要提示:
    配置文件采用 XML 格式。除非您使用 XML 编辑器或您对 XML 格式非常熟悉,否则不要修改这些文件!

    例如,要指定最大线程数,可执行以下任何操作:


表 22. 可定制的 IBM Java ORB 属性
IBM ORB 属性 配置参数 描述
com.ibm.CORBA.ListenerPort OAport ORB 服务器(在 InterChange Server Express 内)侦听入局请求所在的端口号。
com.ibm.CORBA.LocalHost OAipAddr ORB 服务器(在 InterChange Server Express 内)运行所在的机器的 IP 地址或主机名。
com.ibm.CORBA.ThreadPool. MaximumSize OAthreadMax 连接管理器可创建的最大线程数。缺省值(零)指示没有大小限制。
com.ibm.CORBA.ThreadPool. InactivityTimeout OAthreadMaxIdle 删除空闲线程之前的时间(以秒计)。
com.ibm.CORBA.RequestTimeout CORBA 请求在超时之前等待的秒数。缺省情况下不会超时;ORB 无限期地等待响应。
com.ibm.CORBA.LocateRequest “定位请求”的超时值(以秒计)。
com.ibm.CORBA.FragmentTimeout ORB 在它超时之前等待第二个及后续消息片段的最长时间。将此属性设置为零以指示不超时。缺省值为 30000

更改对象请求代理程序位置的步骤

这些步骤仅适用于 OS/400。对于 Windows 和 Linux 系统,该位置设置为 14500 且不能更改。

执行下列其中一个步骤来在安装期间更改对象请求代理程序的位置:

  1. 有关缺省 ORB 位置的信息,参阅表 23
  2. 在安装期间更改此缺省信息。在“命名服务器”屏幕中,WebSphere InterChange Server Express 安装程序提示您输入 InterChange Server Express 实例的 IP 地址和端口号。安装程序将此信息保存在产品目录的适当变量中。

表 23 还显示 CWSharedEnv 文件中指定 ORB 位置的变量。

表 23. IBM Java ORB 的位置
ORB 位置 IBM ORB 属性 缺省值 CWSharedEnv 变量
IP 地址 org.img.CORBA.ORBInitialHost 本地主机的名称 ORB_HOST
端口号 org.omg.CORBA.ORBInitialPort 14500 ORB_PORT

执行下列其中一个步骤来在安装之后更改对象请求代理程序的位置:

有关如何更改 ORB 属性的信息,请参阅定制对象请求代理程序的步骤

使用 IBM Transient Naming Server

使用 IBM Transient Naming Server(tnameserv)可以为 WebSphere Business Integration Express 系统提供命名服务。当 WebSphere Business Integration Express 系统的某一组件启动时,它向 IBM Transient Naming Server 注册它自己。当该组件需要访问另一 business integration 系统组件时,它使用命名服务来确定定位并启动与该组件的交互作用所需要的信息。例如,当适配器需要与 InterChange Server Express 通信时,它通过 Transient Naming Server 来获取 InterChange Server Express 的位置。

注:
IBM Transient Naming Server 是 IBM Java ORB 的一部分。因此,作为 WebSphere InterChange Server Express 安装过程的一部分,将在 InterChange Server Express 机器上自动安装它。
对于 OS/400,命名服务器不是 WebSphere InterChange Server Express 的一部分。它是 Java Developer Kit 1.4(许可程序 5722JV1 选项 6)的一部分。
OS/400

对于 OS/400,Transient Name Server 与 QWBISVR43 子系统一起自动启动。如果它由于某些原因结束,则执行下列步骤来启动 Transient Name Server:

  1. 输入 CL 命令 QSH,并从 QSHELL 环境进入 /QIBM/Proddata/WBIServer43/bin 目录。
  2. 运行脚本:submit_name_server.sh

标识已注册的组件

WebSphere InterChange Server Express 产品提供 CosNameServer_Dump 工具来列示当前已向 IBM Transient Naming Server 注册的所有有效 InterChange Server Express ORB 对象。此工具位于产品目录的 bin 子目录中。使用下列命令来调用它:CosNameServer_Dump.batCosNameServer_Dump.sh

使用 Persistent Naming Server 的步骤

本节仅适用于 Windows 和 Linux 系统。Persistent Naming Server 在 OS/400 上不受支持。

当 WebSphere Business Integration Express 系统的某一组件启动时,它向 IBM Transient Naming Server 注册自己,并且其 CORBA 对象存储在 Transient Naming Server 的内存中。然而,如果 Transient Naming Server 失败,则其内存内容将丢失。因此,已向它注册的所有组件必须重新引导才能向命名服务注册。

Persistent Naming Server 扩展 IBM ORB Transient Naming Server 的能力,以便向 Transient Naming Server 注册的 CORBA 对象的集合被存储在命名资源库中。命名资源库的存在意味着这些 CORBA 引用是持久的,而不是仅仅存在于 Transient Naming Server 内存中;也就是说,如果 Transient Naming Server 失败,这些引用仍可用于其它进程和 InterChange Server Express 组件。其它组件不需要关闭并重新启动以便向命名服务重新注册。

命名资源库的缺省位置是以下本地文件:ProductDir\CxCosNameRepos.ior

执行下列步骤来更改命名资源库的位置:

  1. 编辑 InterChange Server Express 配置文件(InterchangeSystem.cfg)。
  2. 设置 CosNamingPersistencyFile 配置参数。缺省情况下,将启用 Persistent Naming Server;也就是说,对 CORBA 对象的引用将保留在命名资源库中。
  3. (仅限于 Windows 和 Linux)为了此命名服务器能够运行,您必须用 PersistentNameServer 启动文件(位于产品目录的 bin 子目录中)显式地启动它。此启动文件执行以下步骤:

    作为启动过程的一部分,InterChange Server Express 通过将当前已向 Transient Naming Server 注册的 CORBA 对象复制到命名资源库文件中来更新命名资源库。当每个适配器启动时,它用它的信息来更新命名资源库。如果适配器启动时 InterChange Server Express 尚未启动,则只要 InterChange Server Express 一启动,就会更新命名资源库。

    注:
    如果 Persistent Naming Server 失败,则可以用 PersistentNameServer 启动脚本重新启动它。然而,您不需要重新启动 InterChange Server Express 或任何已启动的适配器。

执行下列步骤来关闭 Persistent Naming Server:

  1. 编辑 InterChange Server Express 配置文件(InterchangeSystem.cfg)。
  2. CosNamingPersistency 配置参数(位于 CORBA 节)设置为 false

Copyright IBM Corp. 2004