BPMDeactivate 命令

在线编辑
传统:
此命令将取消激活活动快照。

停用功能阻止任何新请求，但允许完成处理所有现有实例和发送中的请求。 使用可选参数，还可停用缺省 Snapshot 和暂挂执行中的实例。

可以在不使用可选 -force 参数的情况下停用缺省 Snapshot。 因此，建议在停用 Snapshot 之前检查其是否设置为缺省 Snapshot。 当流程应用程序只有一个 Snapshot 时，可能需要停用缺省 Snapshot，但是当有多个 Snapshot 时，建议您将另一个 Snapshot 标记为缺省 Snapshot，然后再停用当前的缺省 Snapshot。

如果要从 Workflow Center 服务器取消部署 Snapshot ，或者要停止 Snapshot 或从 Workflow Server取消部署 Snapshot ，那么可能需要将其取消激活。

使用此命令不会停止 BPEL 流程。 除非您以开发方式运行服务器或在 Workflow Center 服务器上运行流程应用程序，否则可能需要对包含 BPEL 流程的流程应用程序执行其他操作:
  • 如果流程应用程序使用 BPEL 流程作为主要入口组件，则必须在 WebSphere® 管理控制台中停止相应的 BPEL 模板。 请参阅“管理 BPEL 流程和任务模板”。
  • 此外，如果该 BPEL 流程调用 BPD，那么必须允许任何现有实例在您停止模板之后但停用 Snapshot 之前完成。 请参阅“管理 BPEL 流程和任务模板”。
  • 在任何情况下，都必须从 Business Process Choreographer 数据库中清除关联的流程实例数据，如“Business Process Choreographer 的清除过程”中所述。

BPMDeactivate 命令使用 wsadmin 脚本编制客户机的 AdminTask 对象来运行。

先决条件

要点: 在配置了多个安全域的环境中，使用 PALService MBean 而不是 wsadmin 命令。 请参阅 流程应用程序 LifeCycle (PAL) MBean。
必须满足以下条件：
  • 在网络部署环境中，必须在包含用于处理 Workflow Server 或 Workflow Center 应用程序的应用程序集群成员的节点上运行此命令。 请勿从 Deployment Manager 概要文件运行此命令。
  • 在已连接方式下运行此命令，即，不使用 wsadmin -conntype none 选项。
  • 要访问 wsadmin 命令，所使用的 ID 必须具有 WebSphere Application Server 角色的权限大于监视器角色。 有关角色的信息，请参阅 管理角色 。
  • 要访问此命令使用的 Business Automation Workflow ，所使用的ID必须属于 bpmAdminGroup 或 bpmAuthorGroup。 bpmAdminGroup 的缺省名称为 tw_admins，bpmAuthorGroup 的缺省名称为 tw_authors。 有关组的信息，请参阅 IBM Business Automation Workflow 缺省组类型 。
    提示 ：默认情况下，只有 DeAdmin同时拥有 WebSphere Application Server角色和 bpmAdminGroup。
注意: 如果您正在使用 SOAP 连接，那么该命令可能需要比指定的 SOAP 超时值更长的时间才能完成。 虽然该命令会继续运行，直到完成为止，但您可能会看到异常 java.net.SocketTimeoutException: Read timed out。 要防止发生此异常，请在 profile_root/properties/soap.client.props 文件中为 com.ibm.SOAP.requestTimeout 属性设置更高的值。

位置

从 profile_root/bin 目录启动 wsadmin 脚本编制客户机。

您可以在服务器 SystemOut.log 文件中检查该命令状态。

语法

BPMDeactivate 
-containerAcronym process_application_or_toolkit_acronym
-containerSnapshotAcronym snapshot_acronym
[-containerTrackAcronym track_acronym]
[-force]
[-suspendAllBPDInstances]
[-outputFile file_path]

参数

-containerAcronym 字符串
必需参数，用于标识流程应用程序或 Toolkit 首字母缩写词。 例如，BillingDispute 流程应用程序的首字母缩略词可能为 BILLDISP。
-containerTrackAcronym 字符串
在 Workflow Center 服务器上，这是一个可选参数，用于标识与流程应用程序关联的跟踪的首字母缩略词。
-containerSnapshotAcronym 字符串
必需参数，用于标识流程应用程序或 Toolkit Snapshot 首字母缩略词。
提示： 您可以在快照页面上找到流程应用程序的缩写，网址为 Workflow Center ，也可以使用 BPMShowProcessApplication 命令。
-force
可选参数，用于停用流程应用程序或 Toolkit 的缺省 Snapshot。
-suspendAllBPDInstances
这是可选参数，用于暂挂与给定上下文相关联的所有实例，而不是让它们继续运行。 这些实例保持暂挂状态，直到您将其恢复。
限制: 当 Tip 用作 -containerSnapshotAcronym 参数的值时，不支持此参数。
-outputFile 文件路径
可选参数，用于指定要将运行命令所得日志消息写入到的文件路径。 文件的路径可以是绝对或相对路径，但是目录结构必须已经存在。 如果不提供此参数，会将消息写入 SystemOut.log 文件。

示例

在以下示例中，您首先建立与 Workflow Center 服务器的 SOAP 连接，然后取消激活 BillingDispute 流程应用程序的 Snapshot。 Snapshot 是“主要”跟踪的一部分。

要点: 在网络部署环境中，使用为运行 Workflow Server 或 Workflow Center 应用程序的应用程序集群成员配置的端口。 要确定正确的端口号，请参阅 WebSphere 管理控制台 "端口" 集合页面 (单击 服务器 > 服务器类型 > WebSphere 应用程序服务器 > server_name > 通信 > 端口 并查找 SOAP_CONNECTOR_ADDRESS 的值)。
wsadmin -conntype SOAP -port 8880 -host ProcessCenterServer01.mycompany.com -user admin -password admin -lang jython

wsadmin>AdminTask.BPMDeactivate('[-containerAcronym BILLDISP -containerSnapshotAcronym SS2.0.1 -containerTrackAcronym Main]')