BPMConfig 命令行实用程序

语法

BPMConfig[ -create [-omitPasswordValidation] [-de|-profile|-sqlfiles|-clusterMembers] properties_file ]
[ -update [-profile profile_name -de DE_name [-component component_name] -contextRootPrefix prefix] | [-profile profile_name -de DE_name -virtualHost virtual_host_name] | [-performanceTuning properties_file] | [-dataSource properties_file] | [-profile profile_name -node node_name -jdbcDriverPath jdbc_driver_path] ]
[ -upgrade -de properties_file [-component component_name ]
[ -export -profile profile_name -de DE_name [-db [properties_file]] [-system properties_file] [-outputDir configuration_directory] ]
[ -migrate -wasHome source_installation_directory -profile profile_name [-de DE_name] [-responseFile response_file] [-useRecommendedSettings] [-outputDir configuration_directory] ]
[ -validate properties_file [-omitPasswordValidation] | -db properties_file | -profile profile_name -de DE_name | -performanceTuning properties_file [-outputDir output_directory] ]
[ -start [-profile profile_name -de DE_name] | properties_file ]
[ -stop [-profile profile_name -de DE_name -username user_name -password password] | properties_file ]
[ -delete [-profiles properties_file] | [-profile profile_name -de DE_name] | [-profile profile_name -de DE_name -node node_name] | [-profile profile_name -de DE_name -node node_name -clusterMember cluster_member_name] -acceptDeletionPrompt ]
[ -help parameter_name ]

描述

可以使用 BPMConfig 命令（而不是使用 WebSphere 管理控制台中的“部署环境”向导）来创建 IBM BPM 部署环境。也可以使用 BPMConfig 命令（而不是使用“概要文件管理工具”或 manageprofiles 实用程序）来创建 IBM BPM Deployment Manager 和受管节点的概要文件。

为了补充 BPMConfig 命令，提供了一个 IBM BPM 配置编辑器，此编辑器可用于以图形化方式，使用 BPMConfig -export 命令编辑从源环境中导出的配置属性文件。在此编辑器中修改导出的属性文件之后，您可以使用 BPMConfig -create 命令基于修改的文件创建新的部署环境。 可从主题使用 IBM BPM 配置编辑器配置您的环境中找到有关 IBM BPM 配置编辑器的信息。

大多数 BPMConfig 命令参数使用的输入配置属性文件中都包含部署环境配置中使用的配置属性和值。在此帮助主题中显示的命令语法中，使用变量名称 properties_file 来标识配置属性文件。 已提供了样本配置属性文件，供您复制并进行定制以配置您自己的环境，如属性文件 Advanced-PS-ThreeClusters-DB2-MultiDB-De1.properties。 这些样本配置属性文件位于以下目录及其子目录中（其中 install_root 是 IBM BPM 的安装位置）：

install_root/BPM/samples/config

如果运行 BPMConfig 命令时发生错误，那么该命令将结束并显示一条错误消息，该消息应该有助于诊断并解决问题。任何与运行 BPMConfig 命令相关的消息都记录在以下文件中（其中 install_root 是 IBM Business Process Manager 的安装位置）：

install_root/logs/config/BPMConfig_time_stamp.log

WARNING: Could not open/create prefs root node Software\JavaSoft\Prefs at root 0x80000002
Windows RegCreateKeyEx(...) returned error code 5.

参数

-create [-omitPasswordValidation] [-de|-profile|-sqlfiles|-clusterMembers] properties_file

创建概要文件、部署环境配置、数据库表或用于创建所需数据库表的 SQL 脚本。还可以使用 -create 参数将多个集群成员添加到现有部署环境中。

如果运行 BPMConfig -create -omitPasswordValidation，将不会检查配置文件中的密码是否存在不受支持的字符。

警告： 使用此参数可能会导致 BPMConfig 在后台调用的各种命令发生参数处理错误。或者，您可能不会看到处理错误，但一些字符会丢失，实际存储的密码不是您在属性文件中指定的密码。

如果运行 BPMConfig -create -de properties_file，那么必须在具有 Deployment Manager 概要文件的计算机上运行该命令，然后在具有受管节点的每台计算机上运行该命令。 将在以下概要文件的单元中创建部署环境和概要文件：与配置属性文件中所指定的 installPath 和 hostName 属性值相匹配且尚不存在的概要文件。运行该命令时，会自动创建用于创建数据库表的脚本。根据您为属性文件中的 bpm.de.deferSchemaCreation 属性设置的值，可以创建数据库表并将系统信息装入到 Process Server 数据库中。如果您要进行迁移，并且在源环境中配置了 Business Process Choreographer，那么在运行 BPMConfig -migrate 时会自动导出配置属性文件，这些文件将用于在新环境中自动重新创建 Business Process Choreographer 配置。创建新环境后，您可能需要执行一些 Business Process Choreographer 迁移后任务，在“将您的定制配置移动到目标环境”主题中有相关描述。

如果运行带有 -profile 选项的 BPMConfig -create 命令，那么将只创建配置属性文件中指定的尚不存在的概要文件。如果已经运行 -create -de，并且已存在一个或多个概要文件，那么 BPMConfig 命令会在消息中报告现有概要文件名称并继续配置部署环境。 缺省情况下，在创建新概要文件期间，会在创建新节点时联合该节点。如果要创建概要文件但不联合节点，请同时指定 -federateLater 选项与 -create -profile 操作。虽然 -create -profile 操作会创建一个或多个 IBM BPM 概要文件，但它不会配置部署环境。如果要使用管理控制台中的“部署环境”向导来配置部署环境，那么该操作非常有用。可以首先使用 -create -profile 操作创建 IBM BPM Deployment Manager 概要文件和受管节点概要文件，然后启动管理控制台以配置部署环境。

要生成用于创建数据库表的 SQL 脚本但不创建概要文件或部署环境，可以运行带有 -create -sqlfiles 操作的 BPMConfig 命令。此命令会生成 SQL 脚本文件，以用于配置新的 IBM BPM 安装和将较低版本的 IBM BPM 安装迁移至 IBM BPM V8.6.0。可以选择使用 -outputDir 选项指定所生成脚本的输出目录。如果不指定输出目录，那么将在您运行命令所在的概要文件 Root 目录的 dbscripts 目录中生成脚本。运行 BPMConfig -create -sqlfiles 命令将不会执行任何配置。要创建或配置部署环境，必须使用 -create -de 或 -create -profile 操作来单独运行命令。

要向现有部署环境添加一个或多个集群成员，请运行命令 BPMConfig -create -clusterMembers properties_file。您必须在 Deployment Manager 节点上运行此命令。如果存在远程定制节点，您必须在远程节点上运行 syncNode 命令来获取最新的配置文件更改。

在运行该命令之前，必须将集群成员的属性添加到配置属性文件。所添加的成员的名称必须不同于相同节点现有成员的名称。您还必须扩增集群成员的索引。

您可以使用以下方法之一将集群成员属性添加到属性文件：

• 如果之前使用配置属性文件来生成部署环境，那么可以编辑该文件并添加集群成员属性，然后运行该命令来将集群成员添加到现有部署环境中。
• 如果之前使用“部署环境”向导来生成部署环境，那么可以使用 BPMConfig -export 命令导出配置属性文件，并向该文件添加集群成员属性，然后运行该命令以将集群成员添加到现有部署环境中。

在运行命令来添加集群成员之前，请确保 Deployment Manager 正在运行，并且本地节点代理已经停止。

-update [-profile profile_name [-de DE_name] [-component component_name] -contextRootPrefix prefix] | [-profile profile_name [-de DE_name] -virtualHost virtual_host_name] | [-performanceTuning properties_file] | [-dataSource properties_file] | [-dataSource properties_file] | [-profile profile_name -node node_name -jdbcDriverPath jdbc_driver_path] ]

使用-update参数为部署环境配置定制上下文 Root。也可以使用 -update 参数来更新部署环境的数据源信息。指定的定制上下文 Root 将用作缺省 IBM BPM 上下文 Root 的前缀。在运行命令之前创建部署环境。运行命令之前，请停止 Deployment Manager、节点代理程序以及所有正在运行的服务器。 在 Windows 环境中，从 <install_root>\bin 目录运行命令。

您也可以使用 -update 参数（值为 jdbc_driver_path）来配置定制 JDBC 路径。此命令可更新 JDBC 驱动程序路径变量。在独立服务器上，运行此命令以配置服务器。在网络部署环境中，运行此命令以配置 Deployment Manager 并针对每个受管节点重新运行此命令。

-profile profile_name 值用于标识 Deployment Manager 概要文件。建议在运行 -update 参数前创建此概要文件的备份副本。 -de DE_name 值识别部署环境名称。如果在 WebSphere 单元中只有一个部署环境，那么可以省略 -de 选项。 -component component_name 值用于标识组件，并且唯一的值（对于定制上下文 Root）是 ProcessPortal。-contextRootPrefix prefix 值指定要使用的定制上下文 Root 前缀。该前缀必须以前置正斜杠 (/) 开头。指定的前缀会添加到缺省上下文 Root 的开头。如果指定了前置正斜杠 (/) 本身，那么 -contextRootPrefix 选项会将任何定制上下文 Root 还原为 IBM BPM 缺省上下文 Root。有关定制上下文 Root 的更多信息，请参阅主题“在部署环境中为组件定制上下文 Root”。

您的流程应用程序使用入站 Web Service、Web API 还是 REST API？IBM Business Process Manager 公开的所有 URL 都会包含新配置的上下文 Root，因此这一更改将影响到使用先前上下文 Root 作为端点的客户机应用程序。请更新客户机应用程序以使用新的定制上下文 Root。

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

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

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

要点： 如果更新了 -contextRootPrefix 选项的值，那么必须更改现有应用程序中的所有硬编码 URL。 要成功部署应用程序，Process Center 必须至少为 V8.5.0.1 版本级别。

注： 在创建上下文 Root 前缀时，如果看到请求您再次登录的窗口，请尝试这些更改来解决该问题。您使用使用的是轻量级第三方认证 (LTPA) 安全性？请求登录的原因在于：您的多个单元共享同一个 IBM HTTP Server (IHS) 但是没有共享 LTPA 密钥。共享 LTPA 密钥。发生该问题的另一个原因是限制用户只能在相同 IHS 上访问一个单元。如果用户想在相同的 IHS 上访问其他单元，可以使用另一个浏览器来进行；也就是说，每个单元使用一个浏览器。

如果您指定了 -update -profile profile_name -de DE_name -virtualHost virtual_host_name，那么所指定部署环境中 IBM BPM 应用程序的 Web 模块会映射至指定的虚拟主机。如果您的单元中有多个部署环境，那么可以使用上下文 Root 前缀来区分多个部署环境，也可以使用 BPMConfig -update -virtualHost 命令来配置其他虚拟主机。

如果您指定了 -update -dataSource properties_file，那么将会更新部署环境的数据库名称、数据库服务器名称和数据库服务器端口。对于 Oracle 数据库，还将更新数据库 URL。但是，不会更新关联的用户认证和模式。因此，必须确保要更新的数据库具有与当前部署环境中所配置数据库相同的用户和模式。

也可以将 -performanceTuning 选项与 -update 参数结合使用，以更新在配置属性文件中指定的部署环境的性能调优属性。如果您指定了 -performanceTuning properties_file，那么将更新配置属性文件中的所有性能调优属性。有关可以编辑的性能调优属性列表，请参阅 BPMConfig 命令的配置属性。

-upgrade -de properties_file [-component component_name]

将现有的 Standard 部署环境 升级为 Advanced 部署环境。 通过升级，您可以充分使用 Advanced 部署环境 所提供的其他功能。 还可以运行 upgrade 命令以将 BPCArchive 添加到 3 集群拓扑或添加针对 DB2 on z/OS 的 IBM BPM document store。-component 选项的有效值为 BPCArchive 和 EmbeddedECM。

要升级部署环境，请使用以下命令：

BPMConfig.sh -upgrade -de properties_file

运行该命令后，将同步各个节点，从而使受管节点获取最新的配置属性文件更改。

升级将会基于所指定的配置属性文件中的属性。运行命令之前，您可能需要编辑文件中的属性。可在以下位置找到可编辑和用于升级部署环境的样本配置属性文件：

install_root/BPM/samples/config/upgradede

注： 如果定制了 Process Portal 主题，请注意在您运行 BPMConfig –upgrade 命令时，该命令将更改 oobLoadedStatus.properties 文件中 Business Space 系统工件的导入设置，并将覆盖您的定制内容。 请在运行 BPMConfig -upgrade 之前备份您的定制内容。然后，在完成升级过程后重新导入定制内容并将其与部署的主题合并。

如果您向 Standard 部署环境 添加了受支持的定制内容（如上下文 Root 前缀或对虚拟主机映射的更新），那么相同的定制内容会在升级期间自动应用于 Advanced 部署环境。 例如，如果您在 Standard 部署环境 属性文件中设置了 bpm.de.contextRootPrefix 属性和 bpm.de.virtualHost 属性，那么当环境升级时，就会自动更新所有 Web 模块的上下文 Root 和虚拟主机映射以实现高级功能。

当您在新的 Advanced 部署环境 中选择要使用的数据库时，既可以使用现有的 IBM BPM 数据库，也可以针对环境的高级功能指定新数据库和总线。 会提供脚本来生成支持数据库和总线所需的资源。例如，如果您将 bpm.de.deferSchemaCreation 属性设置为 false，那么会在您的数据库中自动生成高级环境功能需要的所有表。

注： 尽管您可将部署环境从 Standard 升级至 Advanced，但您无法将环境类型从 Process Center 更改为 Process Server（或从 Process Server 更改为 Process Center），无法将拓扑从单集群更改为三集群（或从三集群更改为单集群），也无法更改数据库类型。

要将 BPCArchive 添加到 3 集群拓扑或者要将针对 DB2 on z/OS 的 IBM BPM document store添加到现有部署环境，请在 Deployment Manager 上运行相应的命令：

BPMConfig.sh -upgrade -de properties_file -component BPCArchive
BPMConfig.sh -upgrade -de properties_file -component EmbeddedECM

必须首先更新配置属性文件。有关指示信息，请参阅主题配置 Business Process Archive Manager 和为 z/OS 上的 DB2 配置 IBM BPM 文档库。运行该命令后，将同步各个节点，从而使受管节点获取最新的配置属性文件更改。

-export -profile profile_name [-de DE_name] [-db [properties_file]] [-system properties_file] [-outputDir configuration_directory]]

将配置属性从现有部署环境导出到某个输出配置目录中。也可以选择导出数据库信息和/或系统数据以用于性能分析。

如果要使用 -export 参数以只导出现有部署环境中的配置属性，而不导出数据库信息或系统数据，请使用以下命令语法：

BPMConfig.sh -export -profile profile_name [-de DE_name] [-outputDir configuration_directory]

注： 在以上命令语法中，-profile 选项指定 Deployment Manager 概要文件或独立概要文件的名称。 如果在 WebSphere 单元中只有一个部署环境，那么可以省略 -de 选项。

如果要使用 -export 参数来导出现有部署环境中的配置属性，并导出数据库信息和/或系统数据，请使用以下命令语法：

BPMConfig.sh -export -profile profile_name [-de DE_name] [-db [properties_file]] [-system properties_file] [-outputDir configuration_directory]

注： 在以上命令语法中，-profile 选项指定 Deployment Manager 概要文件或独立概要文件的名称。 如果在 WebSphere 单元中只有一个部署环境，那么可以省略 -de 选项。-db 选项用于导出数据库信息，-system 选项用于导出系统数据。将导出数据库信息和系统数据以用于性能分析。导出数据库信息和系统数据时，以下注意事项适用：

• 您只能使用 -system 选项来导出正在运行 Linux 或 AIX 操作系统的机器上的系统数据。您无法使用 -system 选项来导出正在运行 Windows 操作系统的机器上的系统数据。
• 如果您指定了 -db 选项和 -system 选项，那么必须首先在命令语法中指定 -db 选项。
• 输入配置属性文件对于 -db 选项是可选的，但对于 -system 选项是必需的。但是，这两个选项使用相同的输入文件，该文件包含的属性使您能够导出数据库信息和系统数据。如果您在命令语法中指定了 -db 选项和 -system 选项，那么不能为 -db 选项指定输入文件，只能为 -system 选项指定输入文件。 （可以在使用 -system 选项指定的输入文件中更改 -db 和 -system 选项的属性。） 已提供了名为 PerformanceAnalysis.properties 的样本输入属性文件，供您复制并进行定制。该文件位于以下目录中（其中 install_root 是 IBM BPM 的安装位置）：

  install_root/BPM/samples/config/performanceanalysis/

有关使用 -db 和 -system 选项导出数据库信息和系统数据以用于性能分析的更详细的信息，请参阅主题使用 BPMConfig 命令导出数据库信息以用于性能分析和使用 BPMConfig 命令导出系统数据以用于性能分析。

如果您正在使用 -export 参数来导出现有部署环境中的配置属性，那么导出的属性可用于以下目的：

• 使用 IBM BPM 配置编辑器修改属性，然后在不同的 IBM BPM 安装上创建与导出的部署环境类似的另一个部署环境（修改后进行克隆）。
• 将导出的部署环境的配置与同时导出的另一个部署环境相比较。
• 通过运行 BPMConfig -create clusterMembers properties_file 命令，使用额外的集群成员扩展现有部署环境。

将导出以下配置属性：

• 单元和部署环境
• Deployment Manager 和受管节点
• 集群和集群成员
• 数据源和 JDBC 提供程序信息
• 认证别名和角色映射
• LDAP
• 部署环境和 Process Portal 上下文 Root 前缀（如果已在当前部署环境中设置）
• Business Process Choreographer 定制
• 其他性能调优配置属性

-profile 选项指定 Deployment Manager 概要文件或独立概要文件的名称。可选的 -outputDir 选项是要用于存放已导出配置文件的目录的完整路径。如果未指定 -outputDir 选项，那么配置文件将放在缺省输出目录 install_root/temp/DE_name 中。

提示： 如果您由于拥有多个部署环境而多次运行该命令，请记住要指定不同的输出目录名称（如果使用了 -outputDir 选项）。

输出目录包含与下表中文件类似的配置文件。要反映新部署环境的需求，请对该表的第一行中列出的已导出配置属性文件进行更新。无需更新表中列出的其他文件，但请确保这些文件一起保存在同一目录中以供将来参考。

表 1. 每个部署环境的配置文件

样本名称	描述
DE_name.properties	该属性文件包含源环境的配置属性。在配置目标环境时您将使用该文件。有关这些配置属性的更多信息，请参阅主题BPMConfig 命令的配置属性。
fileRegistry.xml	如果使用基于文件的用户注册表，将从源环境复制用户注册表文件以便添加到目标环境。
ltpa.jceks	如果使用 LTPA，将从源环境复制 LTPA 密钥文件以便添加到目标环境。
ldap_additional_properties.xml	如果在源环境中使用联合存储库和未加密的 LDAP 连接，那么会将 LDAP 服务器的附加用户定义属性从源环境复制到输出目录（稍后在这里会自动使用这些属性来创建目标环境）。 限制： 如果将联合存储库扩展为除了使用源环境中的缺省 uid 属性外，还使用定制登录属性（例如 userPrincipalName），那么不会为目标环境配置 LDAP，并产生以下警告：CWMCB0600W: 无法配置 LDAP！您可以在 BPMConfig 成功终止后单独配置 LDAP。如果您看到该警告，请在迁移完成之后，使用您想要使用的登录属性手动配置 LDAP。
ProcessServer_100SourceCustomMerged.xml 和 PDW_100SourceCustomMerged.xml	如果您有 XML 配置属性文件，将从源环境中复制这些文件。导出的配置文件将合并，并在目标环境中重命名为 101CustomMigrated.xml。
Application-config-bpc.xml 和 resources-bpc.xml	如果在源环境中配置了 Business Process Choreographer，那么会将配置文件从源环境复制到输出目录，其中，这些文件以后会自动用于创建目标环境。
Support-config-bpc.xml	如果在源环境中的支持集群上配置了 Business Process Choreographer Archive Manager，那么会将配置从源环境复制到输出目录，其中该配置以后会自动用于创建目标环境。

-migrate -wasHome source_installation_directory -profile profile_name [-de DE_name] [-responseFile response_file] [-useRecommendedSettings] [-outputDir configuration_directory]

可以使用 BPMConfig -migrate 命令从较旧产品或版本进行迁移。您必须指定以下选项：

• -wasHome 选项指定源环境中先前安装的 IBM BPM 安装目录的完整路径。例如：opt/BPMInstall/BMP751Adv 或 E:\BPMInstall\WPS700 或 C:\IBM\Lombardi72\AppServer。
• -profile 选项指定 Deployment Manager 或独立概要文件的名称。
• -de 选项指定部署环境的名称（可在管理控制台中找到此名称）。如果要迁移多个部署环境，那么需要使用此选项。如果仅迁移一个部署环境，那么可省略此选项。如果您正在从独立环境进行迁移，请勿使用该选项。

（可选）您可以通过创建响应文件并指定 -responseFile response_file 选项（其中 response_file 是响应文件的完整路径），在迁移期间以静默方式运行 BPMConfig -migrate。如果未指定 -responseFile 选项，那么系统会提示您指明部署环境类型、目标环境的拓扑以及目标环境是有单个消息传递引擎总线还是多个总线。以下示例显示了响应文件的内容：

# Deployment environment type for the target environment. Value is Advanced, Standard or Advanced-Only
target.deType=Advanced
# Topology for the target environment(number of cluster). Value is 1 or 3
target.clusterNumber=3
# Node number for the target environment. Value is a number, such as 2.
target.nodeNumber=2
# Bus option for the target environment for 3-cluster topology. Value is true or false
target.isSingleBus=false

如果迁移后要使用性能调优属性的建议值，而不是使用源环境中的值，那么可以选择指定 -useRecommendedSettings 选项。 对于性能调优属性（例如 JVM 堆大小或线程池配置），此命令会将源值与建议值相比较。如果源值较小，那么会改为将建议值添加到配置属性文件。以后可以使用 IBM BPM 配置编辑器查看和修改属性。

限制：

• 如果要从独立环境迁移，必须手动迁移性能调优属性。
• 如果源环境是网络部署环境，那么 BPMConfig -migrate 会在属性文件中为每个已迁移的集群添加缺省集群成员。 但是，如果没有迁移现有集群成员；必须在属性文件中手动添加。

可选的 -outputDir 选项是要用于存放配置文件的文件夹的完整路径。如果未指定 -outputDir 选项，那么配置文件将放在缺省输出目录 install_root/temp/DE_name 中。

提示： 如果您由于拥有多个部署环境而多次运行该命令，请记住要指定不同的输出目录名称（如果使用了 -outputDir 选项）。

输出目录包含与下表中的文件类似的文件：

表 2. 迁移文件

样本名称	描述
DE1-Advanced-PS-ThreeClusters-DB2-MultiBus.properties	该属性文件包含源环境的配置信息。在配置目标环境时您将使用该文件。要获取有关属性的信息，请参阅有关所迁移属性的参考主题。
fileRegistry.xml	如果使用基于文件的用户注册表，那么将从源环境复制用户注册表文件以迁移至目标环境。
ltpa.jceks	如果使用 LTPA，那么将从源环境复制 LTPA 密钥文件以便迁移到目标环境。
ldap_additional_properties.xml	如果在源环境中使用联合存储库和未加密的 LDAP 连接，那么将从源环境复制 LDAP 服务器的用户定义的其他属性以迁移至目标环境。 限制： 如果将联合存储库扩展为除了使用源环境中的缺省 uid 属性外，还使用定制登录属性（例如 userPrincipalName），那么不会为目标环境配置 LDAP，并产生以下警告：CWMCB0600W: 无法配置 LDAP！您可以在 BPMConfig 成功终止后单独配置 LDAP。如果您看到该警告，请在迁移完成之后，使用您想要使用的登录属性手动配置 LDAP。
ProcessServer_100SourceCustomMerged.xml 和 PDW_100SourceCustomMerged.xml	如果具有 XML 配置属性文件，那么将从源环境中复制这些文件以迁移至目标环境。导出的配置文件将合并，并在目标环境中重命名为 101CustomMigrated.xml。
Application-config-bpc.xml 和 resources-bpc.xml	如果已在源环境中配置了 Business Process Choreographer，那么将从源环境复制配置文件以迁移至目标环境。
Support-config-bpc.xml	如果已在源环境中支持集群上配置了 Business Process Choreographer Archive Manager，那么将从源环境复制配置以迁移至目标环境。

-validate properties_file [-omitPasswordValidation] | -db properties_file | -profile profile_name [-de DE_name] [-outputDir output_directory] | -performanceTuning properties_file

如果您指定了 -validate properties_file，那么该命令将验证指定的配置属性文件是否可用于创建部署环境。

如果指定 -validate -omitPasswordValidation，将不会检查配置文件中的密码是否存在不受支持的字符。

警告： 指定此参数可能会导致严重后果。

如果您指定了 -validate -db properties_file，那么该命令将验证是否可使用指定的用户名和密码成功建立到数据库的连接。它不会验证数据库的内容，例如模式。

EmbeddedECMDb 必须使用与数据库用户名相同的模式名称。否则，在适用的 IBM BPM V8.5.5 或更高版本的环境中运行 BPMConfig -validate 命令会发生以下错误：CWMCB0239E: The database schema value BPMECM2S for component EmbeddedECM should be the same as the database user name BPMSAND。

如果您指定了 -validate -profile profile_name [-de DE_name] [-outputDir output_directory]（其中 -de 选项在 WebSphere 单元中只有一个部署环境时是可选的），那么将为指定的部署环境生成状态报告。 状态报告会列出在部署环境中配置的组件，同时显示每个组件及其相关联资源的状态。报告也会显示关键安全角色的状态以及 Process Center、IBM Process Server 和 Performance Data Warehouse 的运行时状态。生成的状态报告的名称为 ConfigValidationReport_DE_name.html（其中 DE_name 是部署环境的名称）。 例如，ConfigValidationReport_De1.html。如果您指定了输出目录，那么会在附加到输出目录的 html 目录中生成状态报告。例如，如果您将 E:/Output 指定为输出目录，那么状态报告会生成至 E:/Output/html。 如果不指定输出目录，将在附加到运行了 BPMConfig 命令的目录的 html 目录中生成状态报告。 例如 install_root/bin/html。

如果您指定了 -validate -performanceTuning properties_file，那么该命令将验证配置属性文件中的所有性能调优参数（如 JVM 堆大小和线程池配置）。 如果该文件中的值不同于建议值，那么您会看到一条警告消息。例如，如果 JVM 最大堆大小的建议值为 2048，但配置属性文件中的值为 1024，那么将显示以下警告消息：The parameter 'maximumHeapSize' for Dmgr value [2014] is less than the target default value [2048]。有关可以编辑的性能调优属性列表，请参阅 BPMConfig 命令的配置属性。

在配置了安全 LDAP 的情况下，运行 BPMConfig -validate 命令来验证已导出的配置属性文件时将出现以下错误：CWMCB0345E: LDAP protocol ldaps: is not supported。 可以安全地忽略此错误。

-start [-profile profile_name [-de DE_name]] | properties_file

启动部署环境。您可以通过指定 Deployment Manager 概要文件名称和部署环境名称来运行该命令，也可以使用配置属性文件来运行该命令。如果您通过指定 Deployment Manager 概要文件名称来运行该命令，那么在 WebSphere 单元中只有一个部署环境时，可以省略 -de 选项。

必须在手动启动所有远程节点代理程序之后，在 Deployment Manager 机器上运行该命令。 -start 参数使用该 Deployment Manager 概要文件来启动部署环境的多个元素，包括 Deployment Manager、任何本地节点代理程序和集群成员。

注： 在使用 start 参数运行的情况下，BPMConfig 命令会发送指示信息以启动集群中定义的所有服务器并返回命令完成状态。在某些情况下，命令可能会在所有服务器启动之前以“已完成”状态返回。 在“Process Admin Console”中验证所有服务器均已启动，以及应用程序均已启动，然后再处理其他事件，例如启动 Process Designer。

-stop [-profile profile_name [-de DE_name] -username user_name -password password] | properties_file

停止部署环境。该命令必须在 Deployment Manager 机器上运行，但是无需在任何远程节点上运行。您可以使用配置属性文件运行该命令，也可以指定 Deployment Manager 概要文件名称、部署环境名称、用户名和密码。如果您通过指定 Deployment Manager 概要文件名称来运行该命令，那么在 WebSphere 单元中只有一个部署环境时，可以省略 -de 选项。如果选择使用配置属性文件来运行该命令，那么可以使用在使用 BPMConfig 命令创建部署环境时所使用的属性文件。 或者，可以通过运行带有 -export 参数的 BPMConfig 命令来导出配置属性文件（如 -export 部分中所述）。 使用的用户名和密码可以是单元管理员或部署环境管理器管理员的用户名和密码。 如果您没有指定用户名和密码，那么系统会在运行命令时提示您提供这些信息。

要点： stop 参数不会停止 Deployment Manager 和节点代理程序。如果需要，您必须手动将其停止。

-delete [-profiles properties_file] | [-profile profile_name -de DE_name] | [-profile profile_name -de DE_name -node node_name] | [-profile profile_name -de DE_name -node node_name -clusterMember cluster_member_name] -acceptDeletionPrompt

使用 -delete 参数来删除概要文件、部署环境和集群成员。

• 当环境位于单台计算机上时，要同时删除所有 IBM BPM 概要文件，请运行以下命令：

  BPMConfig -delete -profiles properties_file

  必须运行 Deployment Manager，并且必须在要删除概要文件的计算机上运行 BPMConfig。该命令将会删除运行命令的安装上配置属性文件中的所有概要文件，包括 Deployment Manager 概要文件。 要删除受管节点概要文件，请参阅 从部署环境中除去受管节点概要文件。

  建议在运行 -delete 参数前创建这些概要文件的备份副本。

  注： 当您运行该命令时，可能无法删除概要文件 Root 目录下的一些文件，因为它们已被锁定。您应该检查概要文件 Root 目录，如果仍存在，那么应以递归方式将其删除。
• 要删除部署环境，请运行以下命令（其中，profile_name 是 Deployment Manager 的名称）：

  BPMConfig -delete -profile profile_name -de DE_name

  删除部署环境的命令必须在 Deployment Manager 机器上运行。

  使用该命令来删除某个部署环境时，它会删除通过 BPMConfig 命令或“部署环境”向导创建该部署环境时配置的资源（例如集群和应用程序）。该命令同时还删除部署环境使用的总线。

  命令保留部署环境使用的作者别名和用户。它还会保留部署环境的数据库以及数据库脚本（位于目录 profile_root/dbscripts/cell_name.DE_name 中）。

  BPMConfig 命令以断开连接（本地）的方式运行，并且无权访问 IBM BPM 数据库。运行 BPMConfig 命令以删除部署环境之前，请确保不存在长时间运行的任务，然后卸载应用程序 HTM_PredefinedTasks_V8000_cluster_name 和 HTM_PredefinedTaskMsg_V8000_cluster_name（其中 cluster_name 是部署环境的应用程序集群的名称）。 要卸载应用程序，您可以使用 WebSphere 管理控制台，也可以使用管理命令和脚本，如主题部署 BPEL 流程和人员任务应用程序及其子主题中所述。

  如果在部署环境存在您或其他用户手动配置的资源，您必须手动删除这些资源。

  运行 BPMConfig 命令后，必须运行 syncNode 命令来获取最新的配置文件更改。

  注： 在您运行此命令之后，必须手动删除每个受管节点（托管已删除 IBM BPM 部署环境的应用程序集群成员）上的以下目录，

  managed_node_profile/BusinessSpace/application_cluster_name
  managed_node_profile/SearchIndex/task/application_cluster_name
  managed_node_profile/FileNet/application_cluster_name

• 要从 IBM BPM 部署环境中除去受管节点，请运行以下命令（其中，node_name 是受管节点的名称，profile_name 是 Deployment Manager 概要文件的名称）：

  BPMConfig -delete -profile profile_name -de DE_name -node node_name

  运行 BPMConfig 命令后，必须运行 syncNode 命令来获取最新的配置文件更改。

  该命令将会删除节点上所有集群成员，但不会影响 IBM BPM 部署环境的功能。 部署环境的每个集群中始终至少保留一个集群成员。

  注： 在您运行此命令之后，必须手动删除以下目录：

  managed_node_profile/BusinessSpace/application_cluster_name
  managed_node_profile/SearchIndex/task/application_cluster_name
  managed_node_profile/FileNet/application_cluster_name

• 要删除单独集群成员，请运行以下命令（其中，cluster_member_name 是目标集群成员的名称，profile_name 是 Deployment Manager 概要文件的名称）：

  BPMConfig -delete -profile profile_name -de DE_name -node node_name -clusterMember cluster_member_name

  您只需要在 Deployment Manager 节点上运行此命令。如果存在远程定制节点，您必须在远程节点上运行 syncNode 命令来获取最新的配置文件更改。在运行 syncNode 命令之前，请确保 Deployment Manager 正在运行，还要确保本地节点代理程序已停止。如果您有本地定制节点位于与 Deployment Manager 节点相同的机器上，那么无需运行 syncNode 命令，因为在运行 BPMConfig 命令时将为本地节点自动调用前一命令。

  注： 在您运行此命令之后，如果已删除的应用程序集群成员是受管节点上的最后一个成员，那么必须手动删除以下目录：

  managed_node_profile/BusinessSpace/application_cluster_name
  managed_node_profile/SearchIndex/task/application_cluster_name
  managed_node_profile/FileNet/application_cluster_name

• 如果您不希望系统提示您确认是否想删除指定资源，请在命令语法结尾附加 -acceptDeletionPrompt 选项。

-help parameterName

显示指定参数名的用法信息。 如果您仅指定了 -help 参数而未指定任何参数名，那么它将返回 BPMConfig 命令的用法信息。 如果您指定了 -help 参数与参数名（例如 -create 参数），那么它将显示所指定参数的用法信息。例如：-help create。

BPMConfig 命令使用的配置属性文件中包含该命令使用的属性以及属性的用法信息及其缺省值。

要创建自己的属性文件，请将特定于产品的目录中的样本配置属性复制到以下父目录：

install_root/BPM/samples/config

指定要使用的属性文件时，可以指定当前目录的绝对路径或相对路径。

示例

BPMConfig -create -de myenvironment.properties 

BPMConfig -create -profile myenvironment.properties

BPMConfig -create -sqlfiles myenvironment.properties -outputDir /MyBPMScriptDir

BPMConfig -create -clusterMembers myenvironment.properties

BPMConfig -update -profile mydeploymentmgrprofilename -de mydeploymentenvname -contextRootPrefix /mycorporation

BPMConfig -update -profile mydeploymentmgrprofilename -de mydeploymentenvname -component ProcessPortal -contextRootPrefix /mycorporationprocessportal

BPMConfig -update -dataSource myenvironment.properties

BPMConfig -update -profile DmgrProfile -de De1 -virtualHost virhost1

BPMConfig -update -profile Dmgr01 -node Dmgr01 -jdbcDriverPath E:\temp\jdbcdrivers\Oracle
BPMConfig -update -profile Dmgr01 -node Node01 -jdbcDriverPath E:\temp\jdbcdrivers\Oracle
BPMConfig -update -profile Dmgr01 -node Node02 -jdbcDriverPath /root/temp/jdbcdrivers/Oracle

BPMConfig -upgrade -de myenvironment.properties

BPMConfig -validate myenvironment.properties 

BPMConfig -validate -db myenvironment.properties 

BPMConfig -validate -profile DmgrProfile -de De1 -outputDir E:/Output

BPMConfig -start -profile DmgrProfile -de De1

BPMConfig -start myenvironment.properties

BPMConfig -stop -profile DmgrProfile -de De1 -username DmgrAdmin -password mypassword

BPMConfig -stop myenvironment.properties

BPMConfig -export -profile DmgrProfile -de De1 -outputDir E:\ConfigExport

BPMConfig.sh -export -profile DmgrProfile -de De1 -db -system /home/user/performanceAnalysis.properties -outputDir /home/user/ConfigExport

BPMConfig -migrate -wasHome E:\BPM751Adv -profile DmgrProfile -de De1 -outputDir E:\ConfigExport  

BPMConfig -migrate -wasHome /opt/BPM751Adv/ -profile DmgrProfile -de DE1 -outputDir /home/user_name/751configuration -responseFile /home/user_name/bpm_response.txt 

BPMConfig -delete -profiles myenvironment.properties

BPMConfig -delete -profile DmgrProfile -de De1

BPMConfig -delete -profile DmgrProfile -de De1 -node Node1

BPMConfig -delete -profile DmgrProfile -de De1 -node Node1 -clusterMember Server1

BPMConfig -help

BPMConfig -help create