您可以使用 BPMConfig 命令,以利用包含部署环境配置中使用的所有值的属性文件来创建典型的网络部署环境。在创建部署环境的同时,您可以创建所需的数据库表,并为受管节点创建新的 Deployment Manager 概要文件和定制概要文件,方法是在 BPMConfig 命令使用的属性文件中包含这些概要文件的设置。
开始之前
在使用 BPMConfig 命令行实用程序创建部署环境之前,可能需要手动创建属性文件中所指定的所有数据库。虽然 BPMConfig 命令可以创建数据库模式和表,但它不能创建数据库。
必须创建数据库后才能创建表(以及启动服务器)。根据为 bpm.de.deferSchemaCreation 属性所设置的值,可在运行 BPMConfig 命令时或者运行该命令之后创建数据库模式和表。可在以下“关于本任务”部分中找到有关 bpm.de.deferSchemaCreation 属性的信息。
对于 SQL Server 数据库服务器,请确保在完成配置之前用户名和模式已存在。模式值应为用户所选的缺省模式。
如果将由当前正在运行服务器的 Windows 用户连接到数据库,那么 SQL Server 必须已启用通过 Microsoft SQL Server Management Studio 指定的 Windows 认证方式或 SQL Server 和 Windows 认证方式。您还应确保使用与您的认证方法相匹配的样本属性文件作为您自己的配置属性文件的基础。例如,如果您自己的配置属性文件基于名称以 SQLServer-WinAuth 结尾的其中一个样本配置文件,那么缺省情况下属性 sqlServerWinAuth 设置为“true”。
要点: 在将参与部署环境的所有计算机上使用相同的属性文件运行 BPMConfig 命令。
必须先在具备 Deployment Manager 概要文件的计算机上运行此命令,然后在具备受管节点的各个计算机上运行此命令。在任何给定时间,在一台计算机上只能执行一个概要文件创建操作,并且针对特定 Deployment Manager 只能执行一个节点联合操作。因此,如果要在不同计算机上同时创建多个概要文件,那么必须在创建受管节点概要文件时使用 BPMConfig 命令的 federateLater 选项,然后按顺序在每台计算机上运行带有 -create -de 选项的该命令以联合受管节点。
关于此任务
当使用
-create
-de 选项运行时,
BPMConfig 命令会执行以下任务:
注: 如果使用 SQL Server Windows 认证,并且 bpm.de.deferSchemaCreation 设置为 false,那么必须手动运行引导实用程序来装入 Process 数据库,因为 BPMConfig 不会自动执行此步骤。
过程
要首次创建部署环境,请完成以下步骤:
- 如果之前已运行带有 -create -sqlfiles -outputDir 参数的 BPMConfig 命令来生成用于创建数据库的数据库脚本,那么您应该已经具有属性文件。 验证是否已设置 bpm.de.deferSchemaCreation 属性的值,然后转至步骤 5 并完成其余步骤。
但是,如果您还没有包含概要文件、部署环境和数据库的配置设置的定制属性文件,请完成以下所有步骤。
- 在要创建部署环境的计算机上,查找相应的样本属性文件:BPM_Home\BPM\samples\config。
- 找到最贴切地表示您的目标部署环境的样本属性文件并生成此文件的副本。 对于每个不同的产品配置,都有一个不同的文件夹包含样本配置文件。例如,对于配置 Advanced、Advanced-Only 或 Standard 部署环境,
有一个包含一组样本配置属性文件的 advanced、Advanced-Only 或 standard 文件夹。 在每个文件夹中,有一组特定于不同数据库类型和配置环境的文件。样本文件按照以下格式命名:de_type[-environment_type]-topology-database_type[-suffix],
其中:
- de_type 可设置为 Advanced、Advanced-Only 或 Standard 。
- environment_type 可设置为 PS(针对 Process Server)或 PC(针对 Process Center)。如果 de_type 为 Advanced-Only,那么将不使用此变量。
- topology 可设置为 、SingleCluster 或 ThreeClusters。
- database_type 可设置为 DB2、DB2zOS、Oracle 或 SQLServer。
- suffix 可设置为 -WinAuth(针对 SQL Server 数据库)。
用于使用 SQL Server 数据库在单集群拓扑中配置 Advanced 部署环境(包含 Process Server)的样本配置属性文件称为 Advanced-PS-SingleCluster-SQLServer.properties。
- 修改您的属性文件版本,以使值对应于您自己的配置。 修改样本属性文件时,请使用文件内提供的指南来指定值。
如果要配置 Process Server 环境以远程使用 Process Center,必须将 psProcessCenterHostname 属性的缺省值从 local
host 更改为有效主机名。如果正在配置脱机 Process Server 并且 bpm.de.psOffline 的值设置为 true,那么您不必指定 psProcessCenterHostname 属性的值。
注: 您修改的属性文件必须使用 UTF-8 编码。
当您执行修改时,请勿将任何定制属性添加到该文件,否则 BPMConfig 命令在运行时将失败。
如果需要在属性文件中使用反斜杠字符 (\),必须在该字符前使用转义反斜杠,例如
bpm.dmgr.installPath=c:\\IBM\\BPM85。
如果您正在配置基于 Advanced 或 Advanced-Only 模板的三集群设置,且您希望部署环境包含可选的 Business
Process Archive Manager,那么请包含 配置 Business Process Archive Manager 中描述的属性文件条目。
有关可用属性的更多信息,请阅读样本文件中的注释,或者参阅 BPMConfig 命令行实用程序和 BPMConfig 命令的配置属性中的样本属性文件描述。
- 在具有 Deployment Manager 的计算机上运行 BPMConfig 命令,并向其传递您已创建的属性文件的名称。
BPM_home\bin\BPMConfig -create -de my_environment.properties
- 启动 Deployment Manager。在具有一个或多个受管节点的所有计算机上运行 BPMConfig 命令,并向其传递相同属性文件的名称。 创建受管节点概要文件,并将其联合到 Deployment Manager 单元中。
注: 对于要在与 Deployment Manager 不同的机器上配置的每个节点,在节点上运行 BPMConfig 之前,请检查 Deployment Manager 的 SOAP 端口并更新属性文件中 bpm.dmgr.soapPort 的值。
注: 对于属性文件中的各集群成员,BPMConfig 均将 http 和 https 端口添加到虚拟主机列表。在运行 BPMConfig 后检查虚拟主机列表,以确保分配的端口可接受。
- 可选: 如果您计划使用包含高级内容或已导入 IBM Integration Designer 的应用程序,并且要向单元添加多个部署环境,请提供一种可在各个部署环境之间区分这些业务级别应用程序中的高级内容的方法。 有关信息,请参阅隔离部署环境中描述如何设置 AdvancedDeploymentDEScoped 属性的步骤。
下一步做什么
如果您运行了将 deferSchemaCreation 设置为 true 的
BPMConfig 命令,那么必须创建自己的数据库表,如果您的环境包含 ProcessServer 组件,那么还必须
装入 Process 数据库。要创建数据库,请运行 BPMConfig 命令生成的 SQL 脚本。
要装入 Process 数据库,请运行 bootstrapProcessServerData 实用程序。
有关更多信息,请参阅相关任务链接,这些链接是有关运行用于创建数据库表的生成脚本。
创建部署环境和数据库表后,可以通过从 Deployment Manager 计算机运行带有 -start 操作的 BPMconfig 命令,启动 Deployment Manager、节点代理程序和集群。如果要创建 Advanced 或 Advanced-Only 部署环境,那么需要重新启动 Deployment Manager 和节点代理程序,以使单元作用域配置生效。这仅对于具有Advanced 或 Advanced-Only 功能的第一个部署环境才是必需的。
如果新节点或已更新的节点位于 Deployment Manager 节点所在的计算机上,那么该已更新节点或新节点会自动与 Deployment Manager 节点同步。在您启动该节点之前,请通过检查 profile_root\logs 目录中的 syncNode.log 文件来确保此同步已完成。如果新节点或已更新的节点与 Deployment Manager 节点位于不同的计算机上,那么您需要在该新节点或已更新节点上运行 syncNode.bat 或 syncNode.sh 命令,并等待同步完成后才能启动该节点。
如果使用 SQL Server Windows 认证,那么必须手动运行引导实用程序来装入 Process Server 数据库,如主题在 Windows 上的网络部署环境中向数据库中装入系统信息所述。