修改 OSGi 组合单元的配置

可以修改包含企业 OSGi 应用程序的组合单元的配置信息。 OSGi 组合单元由一个 EBA 资产、（可选）一个或多个组合捆绑软件扩展以及用于在业务级别应用程序中运行该资产和组合捆绑软件扩展的配置信息组成。 配置信息可以为 OSGi 应用程序包含 HTTP 会话管理、上下文根、虚拟主机、安全角色、run-as 角色、会话企业 bean 的 JNDI 映射、EJB 引用的 JNDI 映射以及 Web 应用程序或蓝图资源引用。

1. 启动管理控制台。
2. 浏览至 应用程序 > 应用程序类型 > 业务级应用程序 > 应用程序名称 > composition_unit_name。

   将显示“组合单元设置”面板。

3. 在 其他属性 部分下，单击以下任何选项，然后根据需要修改设置。
   • 会话管理

     为 Web 应用程序捆绑软件配置 HTTP 会话管理。

     仅当 OSGi 应用程序使用 Web 应用程序捆绑软件时，才会显示会话管理选项。

   • Web 模块的上下文根

     从列表中选择 Web Application Bundle (WAB)，然后输入该 WAB 的上下文根。 例如，/sample。 有关更多信息，请参阅 Web 模块的上下文根 [设置]。

     仅当应用程序使用 Web 应用程序捆绑软件时， Web 模块的上下文根 选项才可视。

   • 消息驱动的 bean 侦听器

     对于在 ejb-jar.xml 文件或组合单元的 @MessageDriven 注释中定义的每个消息驱动的 Bean (MDB) ，可以指定将 MDB 侦听器绑定到 MDB 所需的设置。 通过将侦听器绑定至 MDB 来配置 MDB 与 JMS 目标（MDB 从其接收消息）的关联。 有关更多信息，请参阅 消息驱动的 bean 的侦听器 [设置]。

     仅当 OSGi 应用程序至少包含一个具有至少一个 MDB 的 EJB 捆绑软件时， 消息驱动的 bean 的侦听器 选项才可视。

   • EJB JNDI 名称

     对于组合单元中的每个会话企业 bean，可以指定该企业 bean 在运行时环境中使用的 JNDI 名称。 有关更多信息，请参阅 EJB JNDI 名称 [设置]。

     仅当 OSGi 应用程序至少包含一个具有至少一个会话企业 Bean 的 EJB 捆绑软件时， EJB JNDI 名称 选项才可视。

   • EJB 引用

     对于在 ejb-jar.xml 文件， web.xml 文件或组合单元中的 @EJB 注释中定义的每个 EJB 引用，可以指定用于在运行时环境中识别 EJB 引用的 JNDI 名称。 有关更多信息，请参阅 EJB 引用 [设置]。

     仅当 OSGi 应用程序至少包含一个在 ejb-jar.xml 文件， web.xml 文件或 @EJB 注释中定义的 EJB 引用时， EJB 引用 选项才可视。

   • EJB 资源引用

     将显示此资产中可用 EJB 资源引用的列表。 即，类型为 resource-ref (资源引用) 的资源，如 Java™ 规范 JSR-250: Java 平台的公共注释。 对于每个引用，指定资源在运行时环境中使用的 JNDI 名称。 有关更多信息，请参阅 EJB 资源引用 [设置]。

     仅当 OSGi 应用程序至少包含一个在 ejb-jar.xml 文件中定义的资源引用，或者通过企业 Bean 上的 @Resource 注释定义的资源引用时， EJB 资源引用 选项才可视。

   • EJB 消息目标引用

     将显示此资产中可用 EJB 消息目标引用和资源环境引用的列表。 即，类型为 message-destination-ref (消息目标引用) 或 resource-env-ref (资源环境引用) 的资源，如 Java 规范 JSR-250: Java 平台的公共注释。 对于每个引用，指定资源在运行时环境中使用的 JNDI 名称。 有关更多信息，请参阅 EJB 消息目标引用 [设置]。

     仅当 OSGi 应用程序包含至少一个 JMS 消息目标引用或资源环境引用 (在 ejb-jar.xml 文件中定义) 或通过企业 Bean 上的 @Resource 注释定义) 时， EJB 消息目标引用 选项才可视。

   • EJB 环境条目

     对于在 ejb-jar.xml 文件的 env-entry 元素中或在组合单元的 @Resource 注释中定义的每个简单环境条目，您可以指定环境条目的值。 有关更多信息，请参阅 EJB 环境条目 [设置]。

     仅当 OSGi 应用程序至少包含一个在 ejb-jar.xml 文件或 @Resource 注释中定义的简单环境条目时， EJB 环境条目 选项才可视。

   • Web 模块的虚拟主机

     将显示此资产中可用 WAB 的列表。 对于每个 WAB，您可以通过从列表中选择其他 WAB 来更改相关联的虚拟主机。 如果在 WAB 的 ibm-web-bnd.xml 或 .xmi 文件中指定现有虚拟主机，那么缺省情况下将设置指定的虚拟主机。 否则，缺省虚拟主机设置为 default_host。 有关更多信息，请参阅 Web 模块的虚拟主机 [设置]。

     仅当应用程序使用 Web 应用程序捆绑软件时， Web 模块的虚拟主机 选项才可视。

   • 安全角色到用户或组的映射

     根据需要更改安全性映射。 有关更多信息，请参阅 安全角色到用户或组的映射 [设置]。

     仅当应用程序使用安全角色时， 安全角色到用户或组的映射 选项才可视。

   • 用户的 RunAs 角色

     可以将指定的用户标识和密码映射到 RunAs 角色。 此映射使您可以为各个用户指定特定于应用程序的特权，以便他们可以使用其他用户标识运行特定的任务。 有关更多信息，请参阅 RunAs 角色 [集合]。

     仅当应用程序使用 RunAs 角色时， RunAs 角色 选项才可视。

   • 蓝图资源引用

     将显示此资产中可用蓝图资源引用的列表。 对于每个引用，您可以从列表中选择认证别名。 仅当缺省认证别名 (来自 ibm-eba-bnd.xml 文件) 存在于每个目标服务器或集群上时，才会提供这些别名。 有关更多信息，请参阅 Blueprint resource references [Settings]。

     仅当捆绑软件包含蓝图资源引用声明时， 蓝图资源引用 选项才可视。

   • Web 模块消息目标引用

     将显示此资产中可用 Web 应用程序消息目标引用和资源环境引用的列表。 即，类型为 message-destination-ref (消息目标引用) 或 resource-env-ref (资源环境引用) 的资源，如 Java 规范 JSR-250: Java 平台的公共注释。 对于每个引用，指定资源在运行时环境中使用的 JNDI 名称。 有关更多信息，请参阅 Web 模块消息目标引用 [设置]。

     仅当捆绑软件包含 Web 应用程序时， 将 Web 模块消息目标引用绑定到受管对象 向导步骤和 Web 模块消息目标引用 属性才可视。

   • Web 模块资源引用

     将显示此资产中可用 Web 应用程序资源引用的列表。 即，类型为 resource-ref (资源引用) 的资源，如 Java 规范 JSR-250: Java 平台的公共注释。 对于每个引用，指定资源在运行时环境中使用的 JNDI 名称。 可以设置认证属性和扩展的数据源定制属性，它们会影响在运行时访问资源的方式。 要指定 JNDI 名称映射，请在框中输入 JNDI 名称，或者单击 浏览 ... 然后从 可用资源列表中选择资源引用。 要修改认证方法或设置应用于数据库连接的扩展数据源定制属性，请选择单个引用，然后单击 修改资源认证方法 ... 或 扩展属性 ...。 有关更多信息，请参阅 Web 模块资源引用 [设置]。

     仅当捆绑软件包含 Web 应用程序时， Web 模块资源引用 选项才可视。

4. 将更改保存到配置库。