定制部署环境中组件的上下文根

在创建部署环境之后，可通过使用 BPMConfig 脚本来添加前缀，在环境中定制所有组件的上下文根。也可以通过添加专用于此组件的前缀来定制 Heritage Process Portal 上下文根。

在创建部署环境之前，也可以通过在为此部署环境定义配置的 BPMConfig 属性文件中设置上下文根属性，来定制上下文根。

关于此任务

要定制 IBM® Business Process Manager 上下文根，请运行带有 -update 参数的 BPMConfig 脚本。

要点：如果已定制了上下文根，并且您希望将 Process Server 连接到 Process Center Repository 以部署应用程序，那么 Process Center 必须至少为 V8.5.0.1 级别。

过程

要在现有部署环境中定制上下文根，请完成以下步骤：

停止部署环境中正在运行的所有服务器。
在命令行环境中，切换到 BPMConfig 脚本在 Deployment Manager 节点上所在的目录。例如：
cd install_root/bin
使用以下语法来运行该脚本：
BPMConfig -update -profile profile_name [-de DE_name] -component component_name -contextRootPrefix prefix

其中：
-profile

指定 Deployment Manager 概要文件名称。

-de

指定要应用上下文根更改的部署环境的名称。将使用这些更改来配置部署环境中的所有组件。
如果 WebSphere 单元中仅有一个部署环境，那么您可以省略 -de 选项。

-component

指定可为其设置上下文根前缀的组件。唯一的有效值为 ProcessPortal。使用此参数可指示您希望设置特定于 Heritage Process Portal 的上下文根前缀。
您必须指定 -de 和 -component，以在部署环境中的组件级别应用上下文根更改。

-contextRootPrefix

指定要设置的上下文根前缀。该值需要前置正斜杠 (/)。指定的前缀会添加到缺省上下文根的开头。如果指定了前置正斜杠 (/) 本身，那么 -contextRootPrefix 选项会将任何定制上下文根还原为 IBM BPM 缺省上下文根。
要点：如果更新 -contextRootPrefix 的值，您必须更新现有应用程序中的所有硬编码 URL。

示例：
- 要将 de_prefix 前缀添加到 P1SR01 部署环境中配置的所有组件的缺省上下文根值中，请输入以下命令：
  ./BPMConfig -update -profile DmgrProfile -de P1SR01 -contextRootPrefix /de_prefix
- 要将 myportal 前缀添加到 P1SR01 部署环境中 Heritage Process Portal 组件的缺省上下文根值中，请输入以下命令：
  ./BPMConfig -update -profile DmgrProfile -de P1SR01 -component ProcessPortal -contextRootPrefix /myportal
- 要设置不同于 P1SR01 部署环境中其他组件所使用前缀 (de_prefix) 的 Heritage Process Portal 上下文根前缀 (myportal)，请按顺序运行以下命令：
  ./BPMConfig -update -profile DmgrProfile -de P1SR01 -contextRootPrefix /de_prefix
  ./BPMConfig -update -profile DmgrProfile -de P1SR01 -component ProcessPortal -contextRootPrefix /myportal
查看 Deployment Manager 节点上的 install_root/logs/config/BPMConfig_timestamp.log 文件以确认无任何错误。

结果

用于访问 IBM Business Process Manager Web 应用程序的 URL 将被配置为包含该上下文根前缀。因此，这一更改将影响到使用缺省上下文根作为端点的客户机应用程序。在 URL 中，将在缺省上下文根前面添加包含前置正斜杠 (/) 的指定上下文根前缀。例如，缺省 Business Process Choreographer Explorer URL 将采用 https://application_server_host:port_number/bpc 格式，其中，bpc 是缺省上下文根（或应用程序服务器上的 Business Process Choreographer Explorer 应用程序的根目录）。如果将上下文根前缀设置为 myprefix，那么 Business Process Choreographer Explorer URL 会变为 https://application_server_host:port_number/myprefix/bpc。

下一步做什么

更新 Web 服务器插件。运行 BPMConfig -update -contextRootPrefix 命令时，会在产品应用程序中更新 Web 模块。如果产品应用程序映射到 Web 服务器，那么必须使用新的上下文根来更新 Web 服务器的 plugin-cfg.xml 文件。任何 Web 服务器都需要传播（或生成并传播）。有关更多信息，请参阅 WebSphere Application Server 产品信息中的插件配置。

请在启动 IBM Business Process Manager 用户界面前清空浏览器缓存。

请更新客户机应用程序以使用新的定制上下文根。

必须从 Process Center 下载并重新安装先前安装的任何 Process Designer，因为 Process Designer 必须使用新的上下文根配置。

注：在使用定制上下文根的环境中，系统可能会提示您在初次访问后重新登录到 Process Center。如果您正在使用轻量级第三方认证 (LTPA) 安全性，那么当有多个单元共享同一 IBM HTTP Server (IHS) 而不共享 LTPA 密钥时，系统会要求您登录。在这种情况下，请共享 LTPA 密钥。此外，如果您要访问同一 IHS 上的多个单元，请对每个单元单独使用一个浏览器。