使用 IBM Business Automation Workflow 配置编辑器配置环境

在线编辑
Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-01-20 10:38
IBM Business Automation Workflow 配置编辑器是一个基于浏览器的界面，用于配置新的部署环境。 您可以使用 BPMConfig -export 命令以图形方式编辑从源环境导出的配置属性文件。 在编辑器中修改属性文件后，可以使用 BPMConfig -create 命令来创建基于已修改文件的新部署环境。

准备工作

配置编辑器支持以下产品 IBM Business Automation Workflow 配置编辑器支持以下 Linux® 产品：
  • SUSE Linux Enterprise Server 11 SP1 或更高版本
  • Red Hat® Enterprise Linux 服务器 或更高版本 6.0
如果未在 IBM Business Automation Workflow 配置编辑器支持的操作系统版本上安装 IBM Business Automation Workflow ，那么可以将 BPMConfigurationEditor.zip 文件复制到运行受支持的操作系统的另一台机器，然后在其中使用该编辑器。
为 SQL Server Java™ 数据库连接性 ( JDBC ) 驱动程序创建自定义目录。 在 Business Automation Workflow Deployment Manager 和每个受管节点机器上的安装根目录中，为 JDBC 驱动程序创建定制目录，并将所需的 JDBC 驱动程序 JAR 文件复制到该目录中。 例如，您可以创建以下定制目录：
install_root/sqljdbc

关于本任务

以下图像和对应的表描述了您在配置自己的新部署环境时与之交互的配置编辑器部分。
配置编辑器的截屏。 下表描述了这些部件。
表 1. 配置编辑器图像上所标注区域的描述
Label 部分 描述
A 拓扑 编辑所有可用组件（例如，单元、节点和部署环境）的属性。 在导出期间，某些属性已自动修改，其他属性需要手动输入。 错误配置的组件带有灰色阴影。 缺少值或具有无效值的属性将由红色边框括起，并由红色惊叹号图标标记。
B 安全性 编辑 LDAP 的属性。 编辑 WebSphere® Lombardi Edition 文件中的定制，包括 Process Admin Console， Workflow Server和其他定制属性。 在此选项卡上显示的信息取决于您的源配置。
C 性能 编辑数据源、线程池、激活规范、工作管理器、JVM 设置、连接工厂、ORB 数据、Web 容器和消息传递引擎的属性。
D CaseManagement 编辑案例管理属性。
E 摘要 在保存配置属性文件之前，滚动浏览所有可用属性。 完成进一步的编辑。
1 单元 编辑单元属性，例如单元名称。 将单元管理员角色映射至认证别名。
2 部署环境 编辑部署环境属性，例如 Business Automation Workflow 类型。 对于 Workflow Server，您还可以更改 Workflow Center 连接属性。
3 数据库 编辑数据库属性或将数据库角色映射至用户别名。
4 Deployment Manager 编辑 Deployment Manager 属性，例如，主机名、节点、概要文件名称和 SOAP 端口。
5 节点 编辑每个节点的属性，例如，节点名、主机名、端口和概要文件名称。
6 集群 编辑每个集群的属性。
7 集群成员 编辑每个集群成员的属性。
8 别名 编辑部署环境管理员、数据库管理员和其他别名到用户和密码的认证别名映射。
9 总线 编辑总线属性，例如，总线引用的数据库。
10 验证消息 单击该表中的消息以纠正不完整或不正确的属性。

过程

  1. 要安装 IBM Business Automation Workflow 配置编辑器，请完成以下步骤:
    1. 将 BPMConfigurationEditor.zip 配置编辑器包解压缩到目录。
      该软件包位于 install_root/BPM/config/ui/中。
    2. 确保该包中的以下文件为可执行文件：
      • install_root/BPM/config/ui/configEditor.sh
      • install_root/BPM/config/ui/validation/validate.sh
    3. 编辑 configEditor.ini 文件以设置 JAVA_HOME 位置。 （可选）您可以更改编辑器使用的端口。

      如果您不更改端口，那么将使用缺省端口 8888。 但是，如果运行 configEditor 命令且端口 8888 已由其他进程使用，那么您将接收到错误Error: listen EADDRINUSE. 如果接收到错误，那么可以停止已在使用端口 8888 的进程，也可以在 configEditor.ini 文件中指定新的端口号 (例如端口 9999)。

    4. 启动服务器。
      • 在 configEditor.sh 可执行文件所在的目录中，运行 configEditor.sh 命令。 BPMConfigEditor.log 文件将写入到您运行该命令的同一目录中。
    5. 如果浏览器未自动打开以运行配置编辑器，请手动打开浏览器。 配置编辑器仅允许本地访问。 在已安装了编辑器的计算机上，指定以下 URL：
      • Pre-19.0.0.1: http://localhost:8888/ibm/bpm/configEditor
      • https://localhost:8888/ibm/bpm/configEditor
      如果在 configEditor.ini 文件中更改了端口号，那么在此处更改端口号。
  2. 单击 浏览 并选择运行 BPMConfig -export时创建的属性文件。
    例如，DE1-Advanced-PS-SingleCluster-DB2.properties。
    单击打开编辑器以开始配置新环境。
  3. 配置目标环境。
    注: 部署环境类型的值必须是 Process Center (PC) (对于 Workflow Center) 或 Process Server (PS) (对于 Workflow Server)。
    • 跟踪在添加新数据库功能时所选择的数据库属性。 您将在下一个步骤中创建所需的新数据库。
      提示: 在 Business Automation Workflow 24.x中，公共数据库分为两部分。 一个是单元作用域数据库，用于整个单元。 另一个是包含事件排序和失败事件管理器失败事件管理器的部署环境作用域数据库，必须为每个部署环境进行配置。
    • 目标环境将使用与源环境相同的数据库，除非您更改缺省值。 如果您使用克隆的数据库，请备份导出的 BPMConfig 属性文件，以便在完成之后恢复正确的数据库属性。 然后，更新文件中的数据库信息以使用克隆的数据库。
    • 设置 bpm.dmgr.jdbcDriverPath 属性以指向安装有 JDBC 驱动程序的定制 JDBC 驱动程序路径。 没有缺省值，您必须指定路径，例如 install_root/sqljdbc。
    • 如果在源环境中对 Oracle 数据库使用定制 URL，那么将导出该 URL。 您可以在编辑器的高级选项选项卡上数据库区域中检查每个数据库容量的值。 根据需要更新数据库 URL 值，或在基本选项选项卡上设置 数据库和主机。 数据库 URL属性或数据库和主机属性必须为空。
    • 如果使用源环境中基于文件的用户注册表，请使用源环境中用于单元管理员的主管理用户名。 复用单元管理员的管理用户名可确保数据库中的数据具有相同安全上下文并能够在导出后仍可供同一用户使用。
    • 如果您要导出多个部署环境，请在每个部署环境中的用户名都不同的情况下确保每个数据库的认证别名都不同。 否则，由于认证别名使用不同的用户名，第二个部署环境的创建将失败。
      例如，第一个部署环境具有认证别名 BPM_DB_ALIAS，此认证别名使用 user1 作为用户名。
      bpm.de.authenticationAlias.3.name=BPM_DB_ALIAS
bpm.de.authenticationAlias.3.user=user1
bpm.de.authenticationAlias.3.password=
      在创建第二个部署环境之前，请检查 BPMConfig 属性文件以确保不存在具有不同用户名的相同认证别名。 如果存在，请更改此认证别名的名称。 例如：
      bpm.de.authenticationAlias.3.name=BPM_DB_ALIAS_2
bpm.de.authenticationAlias.3.user=user2
bpm.de.authenticationAlias.3.password=
    • 纠正所有验证错误，以确保目标环境正确且完整。
    • 单击 保存 以保存配置属性文件。
      重要信息: 将属性文件保存到运行 BPMConfig -export时创建该文件的位置，因为它与其他导出的配置文件之间存在交叉引用。 如果您无法使用同一名称将该文件保存到已导出属性文件所在的位置中，那么应编辑输出属性文件，并手动更改名称和位置。
      提示: 如果您看到类似于 properties_file can't be downloaded的错误，请单击 重试 以保存该文件。

下一步

启动 IBM Business Automation Workflow 配置编辑器时，它会创建在后台运行的流程。 如果您关闭了用于运行配置编辑器的浏览器，此后台进程将继续运行。 要停止此过程，请在浏览器中装入以下 URL：
  • Pre-19.0.0.1: http://localhost:port_number/bye
  • https://localhost:port_number/bye
出于安全原因，您可能想要删除“配置”编辑器目录或包含 bpmconfig.properties 文件的临时目录，或者从文件中除去管理员密码。 临时目录位于“配置”编辑器目录下，其名称类似于 i0zsWYfy4Cj97XZ1xfFVC34Hlt4DUfzd。