maintainDocumentStoreTrace 命令

在线编辑

传统:
使用 maintainDocumentStoreTrace 命令对 BPM 文档库的单个组件或所有组件启用或禁用跟踪。

如果已将 IBM® Business Automation Workflow 配置为使用外部 Enterprise Content Management 服务器，那么此命令不适用。 FileNet P8 Platform 中的等效过程位于主题 故障诊断中。

maintainDocumentStoreTrace 命令是使用 wsadmin 脚本编制客户机的 AdminTask 对象来运行的。
注: 当您启用跟踪时，它会导致其他文件系统输入和输出操作，这些操作可能会使系统变慢。 您应该只在进行问题确定时启用跟踪。

先决条件

必须满足以下条件：

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

在运行此命令之前，请查看 管理 BPM 文档库的跟踪。

位置

从 Deployment Manager 概要文件的 profile_root/bin 目录启动 wsadmin 脚本编制客户机。 maintainDocumentStoreTrace 命令不会写入日志文件，但 wsadmin 脚本编制客户机始终会写入 profile_root/logs/wsadmin.traceout 日志文件，您将在其中找到异常堆栈跟踪和其他信息。

语法

maintainDocumentStoreTrace
-serverName server_name
-nodeName node_name
-clusterName cluster_name
-deName deployment_environment_name
-disable componentName|all
-enable componentName|all
-list

参数

-serverName 服务器名称
必需参数，用于指定文档库的服务器名称。 如果您指定了 -serverName 参数，那么还必须指定 -nodeName 参数。
-nodeName 节点名
必需参数，用于指定文档库的节点名。 如果您指定了 -nodeName 参数，那么还必须指定 -serverName 参数。
-clusterName 集群名称
必需参数，用于指定文档库的集群名称。
-deName deployment_environment_name
必需参数，用于指定文档库的部署环境名称。
-disable 组件名称 全部
必需参数，用于指定应禁用跟踪的文档库组件。 指定 all 可对所有组件禁用跟踪。
-enable 组件名称 全部
必需参数，用于指定应启用跟踪的文档库组件。 指定 all 可对所有组件启用跟踪。
警告: 启用所有跟踪可能会导致系统严重减速。
-list
必需参数，用于显示在文档库中启用了跟踪的组件的最新列表。

您必须指定 -clusterName 参数或 -deName 参数，或者同时指定 -serverName 和 -nodeName 参数。 作为指定任何参数的替代方法，您可以在类型为BPMDeploymentEnvironment,ServerCluster，或Server.

您还必须指定以下一个或多个参数：

  • -disable
  • -enable
  • -list

任何更改都将立即生效，无需执行任何额外的保存操作。

以下组件包含在 BPM 文档库中:

  • 个 API
  • AsynchronousProcessing
  • AuditDisposition
  • CBR
  • CFSDaemon
  • CFSImportAgent
  • CodeModule
  • ContentCache
  • ContentStorage
  • 数据库
  • EJB
  • 引擎
  • 错误
  • 事件
  • FixedContentProvider
  • GCD
  • 处理程序
  • 元数据
  • 发布
  • 复制
  • 搜索
  • 安全性
  • SSI
  • 扫掠
  • ThumbnailGeneration
  • WSI

示例

注: 这些示例仅用于说明目的。 它们包含变量值，并非意在作为代码片段重复使用。
以下 Jython 示例使用 maintainDocumentStoreTrace 命令显示在指定节点和服务器的文档库中启用了跟踪的组件的最新列表：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-nodeName', 'myNodeName', '-serverName', 'myServerName', '-list'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令指定应在指定节点和服务器的文档库中启用跟踪的个别组件或所有组件：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-nodeName', 'myNodeName', '-serverName', 'myServerName', '-enable', 'componentName' | 'all'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令指定应在指定节点和服务器的文档库中禁用跟踪的个别组件或所有组件：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-nodeName', 'myNodeName', '-serverName', 'myServerName', '-disable', 'componentName' | 'all'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令显示在指定集群的文档库中启用跟踪的组件的最新列表：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-clusterName', 'myClusterName', '-list'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令指定应在指定集群的文档库中启用跟踪的个别组件或所有组件：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-clusterName', 'myClusterName', '-enable', 'componentName' | 'all'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令指定应在指定集群的文档库中禁用跟踪的个别组件或所有组件：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-clusterName', 'myClusterName', '-disable', 'componentName' | 'all'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令显示在指定部署环境的文档库中启用跟踪的组件的最新列表：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-deName', 'myDeName', '-list'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令指定应在指定部署环境的文档库中启用跟踪的个别组件或所有组件：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-deName', 'myDeName', '-enable', 'componentName' | 'all'])
以下 Jython 示例使用 maintainDocumentStoreTrace 命令指定应在指定部署环境的文档库中禁用跟踪的个别组件或所有组件：
wsadmin -user admin -password admin -lang jython
wsadmin>AdminTask.maintainDocumentStoreTrace(['-deName', 'myDeName', '-disable', 'componentName' | 'all'])
以下 Jython 示例在指定的目标对象上调用 maintainDocumentStoreTrace 命令：
wsadmin -user admin -password admin -lang jython
wsadmin>server = AdminConfig.getid('/Cell:/Node:myNodeName/Server:myServerName')
wsadmin>AdminTask.maintainDocumentStoreTrace(server, ['-enable', 'componentName' | 'all'])
以下 Jython 示例在指定的目标对象上调用 maintainDocumentStoreTrace 命令：
wsadmin -user admin -password admin -lang jython
wsadmin>cluster = AdminConfig.getid('/Cell:/ServerCluster:myClusterName')
wsadmin>AdminTask.maintainDocumentStoreTrace(cluster, ['-enable', 'myComponentName' | 'all'])
以下 Jython 示例在指定的目标对象上调用 maintainDocumentStoreTrace 命令：
wsadmin -user admin -password admin -lang jython
wsadmin>de = AdminConfig.getid("/Cell:/BPMCellConfigExtension:/BPMDeploymentEnvironment:myDeName/")
wsadmin>AdminTask.maintainDocumentStoreTrace(de, ['-list'])