correctDocumentStoreInstanceAuthorization 命令

使用 correctDocumentStoreInstanceAuthorization 命令可为驻留在外部 ECM 服务器上的案例、BPD 和团队实例更正用户和组权限。

如果您切换到外部 ECM 服务器,那么 IBM® BPM 和外部 ECM 环境会配置共享用户注册表。如果 IBM BPM 由于共享用户注册表中未提供用户或组而无法针对内容工件向用户授权,那么它会将警告打印到应用程序集群的 SystemOut.log 文件中。未共享用户或组可能有以下几种原因:

  • 用户或组在基于文件的存储库中定义。在这种情况下,无法进行任何更正。
  • 用户或组在轻量级目录访问协议 (LDAP) 用户存储库中定义,但 LDAP 存储库未与这两个系统保持连接。例如,基本条目不一样或使用了不同的 LDAP 搜索过滤器。

您可以更正 LDAP 连接设置以支持共享用户和组。更正连接设置后,可运行 correctDocumentStoreInstanceAuthorization 命令,以将案例和 BPD 实例或团队实例更新为用户和组的正确权限信息。

先决条件

correctDocumentStoreInstanceAuthorization 命令是使用 wsadmin 脚本编制客户机的 AdminTask 对象来运行的。必须满足以下条件:

  • 该命令必须在 Deployment Manager 节点上运行。
  • 一个或多个应用程序集群成员必须正在运行。
  • 在已连接方式下运行该命令。请勿指定 wsadmin -conntype none 选项。
  • 必须使用具有 WebSphere Application Server 操作员特权的用户标识连接到 Deployment Manager。

位置

从 Deployment Manager 概要文件(或 IBM BPM Express 的独立服务器概要文件)的 profile_root/bin 目录启动 wsadmin 脚本编制客户机。 correctDocumentStoreInstanceAuthorization 命令不会写入日志文件,而是直接使用消息进行响应。 但是,wsadmin 脚本编制客户机始终会编写 profile_root/logs/wsadmin.traceout 日志文件,您将在其中找到异常堆栈跟踪和其他信息。

语法

correctDocumentStoreInstanceAuthorization
-serverName server_name
-nodeName node_name
-clusterName cluster_name
-deName deployment_environment_name
-instanceID instance_ID
-teamID team_ID

参数

-serverName server_name
必需参数,用于指定托管 IBM BPM Express 的 WebSphere Application Server 服务器的名称。如果您指定了 -serverName 参数,那么还必须指定 -nodeName 参数。
-nodeName node_name
必需参数,用于指定托管 IBM BPM Express 的 WebSphere Application Server 节点的名称。如果您指定了 -nodeName 参数,那么还必须指定 -serverName 参数。
-clusterName cluster_name
必需参数,用于指定 IBM BPM 应用程序集群的名称。
-deName deployment_environment_name
必需参数,用于指定 IBM BPM 部署环境的名称。
-instanceID instance_ID
必需参数,用于指定将使用正确的用户和组权限信息更新的案例实例或 BPD 实例的标识。
-teamID team_ID
必需参数,用于指定将使用正确的用户和组权限信息更新的团队实例的标识。

您必须指定 -clusterName 参数或 -deName 参数,或者同时指定 -serverName-nodeName 参数。 作为指定任何参数的替代方法,您可以在类型为 BPMDeploymentEnvironmentServerClusterServer 的目标对象上调用命令。

您还必须指定以下某个参数:

  • -instanceID
  • -teamID

示例

注: 示例仅用于说明用途。示例包括变量值,但并不意味着可复用为代码片段。
以下 Jython 示例使用 correctDocumentStoreInstanceAuthorization 命令来指定您要使用指定节点和服务器的正确用户和组权限信息更新的案例或 BPD 实例的标识:
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(['-nodeName', 'myNodeName', '-serverName', 'myServerName', '-instanceID', myInstanceID])
以下 Jython 示例使用 correctDocumentStoreInstanceAuthorization 命令来指定您要使用指定节点和服务器的正确用户和组权限信息更新的团队实例的标识:
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(['-nodeName', 'myNodeName', '-serverName', 'myServerName', '-teamID', myTeamID])
以下 Jython 示例使用 correctDocumentStoreInstanceAuthorization 命令来指定您要使用指定集群的正确用户和组权限信息更新的案例或 BPD 实例的标识:
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(['-clusterName', '-instanceID', myInstanceID])
以下 Jython 示例使用 correctDocumentStoreInstanceAuthorization 命令来指定您要使用指定集群的正确用户和组权限信息更新的团队实例的标识:
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(['-clusterName', 'myClusterName', '-teamID', myTeamID])
以下 Jython 示例使用 correctDocumentStoreInstanceAuthorization 命令来指定您要使用指定部署环境的正确用户和组权限信息更新的案例或 BPD 实例的标识:
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(['-deName', 'myDeName', '-instanceID', myInstanceID])
以下 Jython 示例使用 correctDocumentStoreInstanceAuthorization 命令来指定您要使用指定部署环境的正确用户和组权限信息更新的团队实例的标识:
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(['-deName', 'myDeName', '-teamID', myTeamID])
以下 Jython 示例在指定目标对象上调用 correctDocumentStoreInstanceAuthorization 命令:
wsadmin -user admin -password admin -lang jython
wsadmin>server = AdminConfig.getid('/Cell:/Node:myNodeName/Server:myServerName')
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(server, ['-instanceID', myInstanceID]) 
以下 Jython 示例在指定目标对象上调用 correctDocumentStoreInstanceAuthorization 命令:
wsadmin -user admin -password admin -lang jython
wsadmin>cluster = AdminConfig.getid('/Cell:/ServerCluster:myClusterName')
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(cluster, [['-instanceID', myInstanceID]) 
以下 Jython 示例在指定目标对象上调用 correctDocumentStoreInstanceAuthorization 命令:
wsadmin -user admin -password admin -lang jython
wsadmin>de = AdminConfig.getid('/Cell:/BPMCellConfigExtension:/BPMDeploymentEnvironment:myDeName/')
wsadmin>AdminTask.correctDocumentStoreInstanceAuthorization(de, ['-teamID', myTeamID])