db2cluster -管理 Db2 集群服务命令

db2cluster 命令用于执行与 Db2 集群服务相关的管理操作。

db2cluster 命令在功能上类似于交互式 db2haicu 工具，但它包含用于在 Db2 pureScale® 环境中进行管理的更广泛的选项数组。

权限

可以使用的 db2cluster 命令选项取决于您的权限级别。某些选项只能由 Db2 集群服务管理员指定。仅当您是 SYSADM、SYSCTL 或 SYSMAINT 组的成员时，才能指定其他选项，而可由系统上的任何用户标识运行的命令将更少。请参阅命令参数部分，以获取有关每个选项所需的权限的信息。此外，还有一组针对 db2cluster 命令的高级故障诊断选项，只能在服务指导下使用。

命令语法 - 标准选项

cm action

cfs action

cfs-create

cfs-add

命令语法 - 高级选项

cm action

cfs action

注意：

¹ 仅当包含 -advanced 选项时，这些命令选项才会显示在命令行帮助中，如下所示: db2cluster -cm -help -advanced 或 db2cluster -cfs -help -advanced

命令参数

-cm

指定基于资源的命令或者维护操作。

-set

指定集群管理器的仲裁设备，主机故障检测时间或首选主集群高速缓存设施。

-tiebreaker

指定要用作 Db2 集群服务仲裁器的设备类型。此选项仅可供 Db2 集群服务管理员使用。

-majority: 指定继续存在的主机组，大多数主机都具有工作配额。
-disk 磁盘名称: 指定共享磁盘分区，用于确定哪个主机组具有工作配额。

-option

HostFailureDetectionTime -value 值

指定用于检测集群中的主机故障或网络分区的时间长度（范围是 1 到 60 秒）。此选项仅可供 Db2 集群服务管理员使用。

force: 如果尝试在不使用 force 的情况下设置 HostFailureDetectionTime ，并且结果是指示集群文件系统仍处于活动状态的错误，请使用 force 选项重新提交该命令。附带 force 选项可确保在设置 HostFailureDetectionTime 时，集群文件系统保持关闭。

pprimary -value 值

指定将尝试以主角色启动的集群高速缓存工具 Db2 集群服务。只有 SYSADM、SYSCTL 或 SYSMAINT 组中的用户才能使用此选项。

autofailback -value

指定成员是立即自动故障回退到其根主机（已启用此选项），还是延迟进行自动故障回退（已禁用此选项），直到由管理员手动启用自动故障回退为止。缺省情况下，最初已启用自动故障回退。对此参数的更改将在实例重新启动之后生效。

off: 在根主机已变得可用的情况下，指定 off 参数将禁用成员立即自动故障回退到其根主机。在将已重新启动的根主机重新集成到集群之前，此设置使您有时间验证该根主机的运行状况。
on: 在根主机已变得可用的情况下，指定 on 参数将启用成员立即自动故障回退到其根主机。

-list

将返回有关下列各项的详细信息：

-tiebreaker

列示用作 Db2 集群服务仲裁器的设备类型。

zout: 按应用程序可以使用的格式来显示输出。

-alert

列示集群元素的任何警报。

-HostFailureDetectionTime

列出 Db2 集群服务检测主机故障或网络分区所需的时间。

zout: 按应用程序可以使用的格式来显示输出。

-LocalHostVersion

列出当前安装在调用此命令的主机上的 SA MP (或 IBM® Spectrum Scale) 版本。

-DomainCommittedVersin

列出当前在调用此命令的域中落实的 SA MP (或 IBM Spectrum Scale) 版本。

-pprimary

列出哪些集群高速缓存工具 Db2 集群服务被指定为首选主服务器。只有 SYSADM、SYSCTL 或 SYSMAINT 组中的用户才能使用此选项。

-autofailback

列示自动故障回退状态。

zout: 按应用程序可以使用的格式来显示输出。

-verify

-resources

确认实例的资源模型正确，并且资源模型中不存在不一致情况。

-maintenance

确保集群管理器在主机上处于脱机状态，以便可以更新二进制文件。

-全部: 查询集群中所有主机的维护状态。适用于 V11.1.3.3: 此选项仅可供 Db2 集群服务管理员使用。作为 Db2 集群服务管理员，必须通过设置 DB2INSTANCE 环境变量来指定实例名称。在 V11.1.4.4 和更高版本上，还可以实例所有者身份运行此选项。

-zout: 按应用程序可以使用的格式来显示输出。

-enter -maintenance

使发出此命令的主机处于维护方式。此选项仅可供 Db2 集群服务管理员使用。必须通过设置 DB2INSTANCE 环境变量来指定实例名称。如果在具有 Db2 群集服务管理员特权的情况下使用其他工具（例如，sudo 和 su 等等）来执行，那么应指定该工具的其他特定于平台的选项，以保留该环境变量。在内部，此选项将发出异步命令以停止主机上的集群管理器。该命令将轮询集群管理器的状态，以确定停止操作的完成时间。在响应缓慢的系统上，当集群管理器正在关闭时，它可能会超时并报告错误。可以使各个主机处于维护方式，一次使一个主机处于维护方式。从 v11.1.3.3开始，可以使用 db2cluster 命令一次将多个主机置于维护方式，同时维护定额。

-all: 使整个集群域处于维护模式，从而停止实例中所有主机上的集群管理器。如果使用 -all 选项来进入维护方式，那么必须使用 -all 选项来退出维护方式。

-exit -maintenance

使发出此命令的主机退出维护方式，如果域当前处于脱机状态，那么使其处于联机状态。此选项仅可供 Db2 集群服务管理员使用。必须通过设置 DB2INSTANCE 环境变量来指定实例名称。如果在具有 Db2 群集服务管理员特权的情况下使用其他工具（例如，sudo 和 su 等等）来执行，那么应指定该工具的其他特定于平台的选项，以保留该环境变量。如果使用 -all 选项使整个对等域处于维护方式，那么无法使用此选项在各个主机上退出维护方式。

-all: 使集群域退出维护方式，启动整个集群管理器对等域，从而使集群管理器在实例中的所有主机上都处于联机状态。如果您使用了 -all 选项来进入维护方式，那么必须使用 -all 选项来退出维护方式。

-commit

落实对 Db2 集群服务进行的更新，并使这些更新可供 Db2 数据库系统使用。此选项仅可供 Db2 集群服务管理员使用。

-clear -alert

清除针对所指定集群元素的当前警报。只有 SYSADM、SYSCTL 或 SYSMAINT 组中的用户才能使用此选项。

-member 成员标识
-cf cf-id
-host 主机名

-cfs

指定 cluster-file-system-based 命令或者维护操作。

-create

根据下列选项创建共享文件系统。

-filesystem fs-name: 指定所创建的共享文件系统的名称。
-disk disk1...diskN: 指定共享文件系统的存储路径。
-rdncy_grp_id id: 指的是独立于其他冗余组的一组资源，它们一起在 Db2 pureScale环境中提供主动/主动和瞬态故障转移功能。此选项的有效值为 1 和 2。值 1 和 2 分别被称为主项和辅助项。每个 GPFS 集群文件系统的仲裁磁盘都属于一个称为文件系统仲裁组的特殊组。在地理位置分散的 pureScale 集群 (GDPC) 中，拥有此文件系统仲裁组的主机也称为仲裁主机或站点。在单站点 pureScale 环境中，此标识表示的资源仅包含存储器。在地理位置分散的 pureScale 集群 (GDPC) 中，资源包括与存储器位于同一物理位置的成员和 CF。如果使用 -disk 选项指定了两组磁盘，那么相关联的冗余组标识不得相同。
-fstiebreaker fstbdisk -host tbhost: 指定目标文件系统的仲裁磁盘。仅当创建复制的文件系统时才使用此选项。如果指定了选项 -host tbhost，那么它表明集群中的其他主机只有通过此主机中的 TCP/IP 连接才能访问 fstbdisk。如果 fstbdisk 位于 SAN 存储器上，并且可供群集中的所有主机访问，那么不需要指定 -host tbhost 选项。
-mount 目录名称: 指定共享文件系统的安装点。如果未提供任何安装点，那么将在根文件系统名称 /db2fs 下创建文件系统。

-add

将其他磁盘添加到现有的共享文件系统群集。

-filesystem fs-name: 指定要将磁盘添加到的共享文件系统的名称。
-host HostName: 这是所指定的磁盘列表所在的主机名。此选项仅对非pureScale 实例有效。
-disk 磁盘列表: 指定要添加到共享文件系统集群的磁盘。
-rdncy_grp_id id: 指的是独立于其他冗余组的一组资源，它们一起在 Db2 pureScale 环境中提供主动/主动和瞬态故障转移功能。此选项的有效值为 1 和 2。值 1 和 2 分别被称为主项和辅助项。每个 GPFS 集群文件系统的仲裁磁盘都属于一个称为文件系统仲裁组的特殊组。在地理位置分散的 pureScale 集群 (GDPC) 中，拥有此文件系统仲裁组的主机也称为仲裁主机或站点。在单站点 pureScale 环境中，此标识表示的资源仅包含存储器。在地理位置分散的 pureScale 集群 (GDPC) 中，资源包括与存储器位于同一物理位置的成员和 CF。如果使用 -disk 选项指定了两组磁盘，那么相关联的冗余组标识不得相同。
-fstiebreaker fstbdisk -host tbhost: 指定目标文件系统的仲裁磁盘。仅当创建复制的文件系统时才使用此选项。如果指定了选项 -host tbhost，那么它表明集群中的其他主机只有通过此主机中的 TCP/IP 连接才能访问 fstbdisk。如果 fstbdisk 位于 SAN 存储器上，并且可供群集中的所有主机访问，那么不需要指定 -host tbhost 选项。

-remove

从现有文件系统集群中除去磁盘。

-filesystem fs-name: 指定要从其中除去磁盘的共享文件系统的名称。
-host HostName: 这是所指定的磁盘列表所在的主机名。此选项仅对非pureScale 实例有效。
-disk 磁盘名称: 指定要从共享文件系统集群中除去的磁盘。如果所指定磁盘是文件系统中的最后一个磁盘，或者它是仲裁磁盘，那么该命令将失败。

-enableReplication

通过将当前分配给文件系统的磁盘列表分配给冗余组标识 1，将现有非复制文件系统转换为复制的文件系统。在此过程中，未启用 GPFS 复制。在为同一文件系统创建冗余组标识 2 之后，将立即启用 GPFS 复制。

-delete

删除共享文件系统。此选项仅可供 Db2 集群服务管理员使用。

-filesystem fs-name: 指定要删除的共享文件系统的名称。如果该文件系统不为空，那么该命令将失败。

-set

指定仲裁类型或者设置配置选项。此选项仅可供 Db2 集群服务管理员使用。

-tiebreaker

指定要用作 IBM Spectrum Scale 仲裁器的设备类型:

-majority: 指定继续存在的主机组，大多数主机都具有工作配额。
-disk 磁盘名称: 指定共享磁盘分区，用于确定哪个主机组具有工作配额。

-option 选项

显式设置集群文件系统的配置选项。大多数情况下，您不需要设置任何这些值，因为在创建集群时会自动将它们设置为最佳值。如果未将任何选项设置为其必需值，那么在安装和更新之后隐式运行的集群验证将返回错误消息。

adminMode: 指定是将集群中的所有节点 (还是仅部分节点) 用于发出 IBM Spectrum Scale 管理命令。缺省值和必需值都是 allToAll。
ccrEnable: 指定是否要使用集群配置存储库 (CCR) 类型。 Db2 管理的 Spectrum Scale pureScale 集群的缺省值和必需值为 yes。设置为“no”则将禁用 CCR。禁用 CCR 需要首先使整个集群处于维护方式。
maxFilesToCache: 指定要为最近使用的已关闭文件高速缓存的节点数。缺省值和最小必需值为 10000。
maxMBpS: 指定估计每秒钟可以将多少兆字节的数据传入或传出单个节点。缺省值为 150。如果需要进行更多 I/O，请增大此值。
pagepool: 指定每个节点上的高速缓存大小（以兆字节计）。缺省值和最小的必需值都是 2G。
remoteFileCopyCommand: 指定要由 IBM Spectrum Scale使用的远程文件副本程序的标准路径名。远程复制命令必须遵循与 scp 命令相同的语法格式，但可以实施备用认证机制。
remoteShellCommand: 指定要由 IBM Spectrum Scale使用的远程 shell 程序的标准路径名。远程 shell 命令必须遵循与 ssh 命令相同的语法格式，但可以实施备用认证机制。
sharedMemLimit (仅限AIX® ): 指定可用于存储各种 IBM Spectrum Scale 结构的内存量 (以兆字节为单位)。缺省值和最小的必需值都是 2047。
totalPingTimeout: 指定当主子网未用于 IBM Spectrum Scale 通信时， IBM Spectrum Scale 在排除其无法通信的节点之前等待的时间长度 (以秒计)。在使用 SCSI-3 持久预留 (PR) 的集群中，缺省值为 45；在未启用 PR 的集群中，缺省值为 75。
usePersistentReserve: 指定在磁盘上是要启用还是禁用 PR。缺省值为 YES。如果将设置更改为 NO，那么会将快速故障恢复替换为更长的 GPFS 租赁超时等待期，从而导致故障恢复速度较慢。
verifyGpfsReady: 指定要与 IBM Spectrum Scale 集群协调对等域，以确保 IBM Spectrum Scale 在适当的时间安装文件系统。缺省值和必需值都是 YES。
worker1Threads: 指定并发文件操作的最大数目。缺省值为 500。

-value 值: 为该选项指定值。

-filesystem fs-name

指定要将配置选项应用于哪个文件系统。

-list

将返回有关下列各项的详细信息：

-tiebreaker

列出正在用作 IBM Spectrum Scale 仲裁器的设备类型。

zout: 按应用程序可以使用的格式来显示输出。

-filesystem

将返回有关下列各项的详细信息：

zout: 按应用程序可以使用的格式来显示输出。

-filesystem fs-name

将返回有关下列各项的详细信息：

-configuration: 列示可以更改的文件系统和配置参数的当前配置。
-disk: 列示文件系统中的当前磁盘。

-LocalHostVersion

列出当前安装在调用此命令的主机上的 IBM Tivoli® System Automation for Multiplatforms (SA MP) (或 IBM Spectrum Scale) 的版本。

-DomainCommittedVersion

列出当前在调用此命令的域中落实的 SA MP (或 IBM Spectrum Scale) 版本。

-verify

-configuration

验证 IBM Spectrum Scale 集群的代码版本和发行版级别，并检查集群文件系统的某些配置设置，包括以下选项:

如果未将任何这些选项设置为建议值以获得最佳集群文件系统性能，那么 db2cluster 命令将返回警告消息，该消息包含有关未以最佳方式设置相关选项的信息。

-maintenance

确保共享文件系统集群主机处于脱机状态，以允许对二进制文件进行更新。

zout: 按应用程序可以使用的格式来显示输出。

-mount -filesystem fs-name

使所指定的文件系统可用于操作系统，以便用户进行读/写访问。

-rebalance -filesystem fs-name

在文件系统中的所有磁盘之间重新分配磁盘上的数据。对于要重新均衡的文件系统，应该在系统活动较少的时间段内运行此选项。

-replicate -filesystem fs-name

触发所指定文件系统的数据复制。

-unmount -filesystem fs-name

使所指定的文件系统不可供操作系统访问。

-enter -filesystem -maintenance

使发出此命令的主机处于维护方式。此选项仅可供 Db2 集群服务管理员使用。 cfs 操作 db2cluster -cfs -enter -maintenance 命令要求主机已进入 CM 维护状态。

-all: 使共享文件系统集群中的所有主机处于维护方式。

-exit -maintenance

使发出此命令的主机退出维护方式。此选项仅可供 Db2 集群服务管理员使用。 cfs 操作 db2cluster -cfs -exit -maintenance 命令要求主机不处于 CM 维护状态。

-all: 确保共享文件系统集群中的所有主机都已启动。

-commit

落实对 Db2 集群服务进行的更新，并使这些更新可供 Db2 数据库系统使用。此选项仅可供 Db2 集群服务管理员使用。

-add

将目标成员或 CF 与集群管理器域中的冗余组标识相关联。仅当目标成员或 CF 先前没有任何冗余组标识关联时，此操作才有效。

-member N -rdncy_grp_id 标识

将目标成员与所指定的冗余组标识相关联。使用此选项来首次关联此关系。如果目标成员具有现有关联，请使用 -set 选项对其进行修改。

-cf N -rdncy_grp_id 标识

将目标 CF 与所指定的冗余组标识相关联。使用此选项来首次关联此关系。如果目标 CF 具有现有关联，请使用 -set 选项对其进行修改。

-host 主机名

-san_access: 指定目标主机有权访问 SAN 网络上的共享存储器。如果未指定值，那么这是所有成员和 CF 的缺省值。
-no_san_access: 指定目标主机无权访问 SAN 网络上的共享存储器。指定此值以仅添加专用仲裁主机。

-list

显示目标成员或 CF 与集群管理器域中的当前冗余组标识的关联。如果未指定 -member 或 -cf 选项，那么它将显示每个成员和 CF 的冗余组标识关联。

-rdncy_grp_id: 显示所有成员和 CF 当前冗余组标识的关联。
-member N -rdncy_grp_id: 显示目标成员与冗余组标识的关联。
-cf N -rdncy_grp_id: 显示目标 CF 的冗余组标识的关联。

-delete

解除集群管理器域中目标成员或 CF 的冗余组标识的关联。仅当目标成员或 CF 当前具有冗余组标识关联时，此操作才有效。

-member N -rdncy_grp_id: 解除目标成员的当前冗余组标识的关联。
-cf N -rdncy_grp_id: 解除目标 CF 的当前冗余组标识的关联。

-set

将目标成员或 CF 与集群管理器域中的另一冗余组标识相关联。仅当目标成员或 CF 当前具有冗余组标识关联时，此操作才有效。

-member N -rdncy_grp_id 标识

将目标成员的当前冗余组标识的关联修改为所指定的关联。如果目标成员当前没有冗余组标识关联，请勿使用此选项。

-cf N -rdncy_grp_id 标识

将目标 CF 的当前冗余组标识的关联修改为所指定的关联。如果目标 CF 当前没有冗余组标识关联，请勿使用此选项。

-host 主机名

修改目标主机的预期用途。此选项用于通过向所定义成员授予 SAN 访问权来将专用仲裁主机转换为成员。

-san_access: 指定目标主机有权访问 SAN 网络上的共享存储器。如果未指定值，那么这是所有成员和 CF 的缺省值。
-no_san_access: 指定目标主机无权访问 SAN 网络上的共享存储器。指定此值以仅添加专用仲裁主机。

-remove

-host 主机名: 从集群管理器域中移除单个主机。

-enter -maintenance -mount mount_name

使发出此命令的主机上的所指定安装点处于维护方式。安装名称必须以“/”开头。必须以实例所有者身份发出此命令。

-all: 使所有成员主机上的所指定安装点处于维护方式。此命令要求在集群中的任何成员主机上，安装都不处于主机级别维护方式。必须以实例所有者身份发出此命令。

请参阅将与数据库级别安装资源相关联的安装点置于维护方式，以获取有关此操作的更多详细信息。

-exit -maintenance -mount mount_name

在发出此命令的主机上的所指定安装点退出维护方式。安装名称必须以“/”开头。此命令要求安装在当前主机上处于维护方式。必须以实例所有者身份发出该命令。

-all: 在集群中所有成员主机上的所指定安装点退出维护方式。此命令要求安装在所有成员主机上处于维护方式。必须以实例所有者身份发出此命令。

请参阅将与数据库级别安装资源相关联的安装点置于维护方式，以获取有关此操作的更多详细信息。

-verify

缺省为 -verify -req

-req

执行全面的检查列表以验证 pureScale 集群的运行状况。因此，将对每个失败的条件产生警报，并将警报显示在实例监视命令 db2instance -list 中。执行的验证包括（但不限于）下列各项：

对等域和 IBM Spectrum Scale 集群中的配置设置
主机之间的 RDMA 通信
每个文件系统的复制设置
文件系统中每个磁盘的状态
通过 db2locssh 和 db2scp 在所有节点中使用 db2sshid 进行远程访问

-rdma_ping

验证主机之间的 RDMA 通信。此选项仅对属于 SYSADM ， SYSCTL 或 SYSMAINT 组的用户可用。

注: 从 V 11.1 Mod Pack 4 和修订包 5开始，必须将 db2locssh 或无密码的 root 用户 SSH 配置为使用 -rdma_ping 选项。对于 Db2的较早版本，必须配置无密码根 ssh。

-host

host-name 指定主机。 -host 最多可以使用两次，这允许选择两个主机。可以使用短域名或者标准域名来指定 host-name。指定单个主机时，将验证该主机上的所有适配器与集群中其他每个主机（包括它们自身）上的所有适配器之间的 RDMA 通信。如果指定了两个主机，那么将验证主机的每个适配器之间的 RDMA 通信。

-netname: net-name 指定主机上的网络名。限制仅对主机的特定适配器运行 RDMA 验证，而不是对主机上的所有适配器运行 RDMA 验证。该网络名在所指定主机上必须存在。

-perf

指示将执行与性能相关的任务。

-collect: 将仅执行诊断数据收集，而不进行任何分析。
-db: 将对其执行性能评估的现有数据库名称。
-interval: 必须始终对活动的两个快照实时进行性能分析。首次运行该命令时生成第一个快照，经过所指定的时间间隔（以秒计）之后生成第二个快照。输入范围是 1 到 2147483648 之间。

-maintenance -mount mount_name: 列示所指定的安装点处于维护方式的主机。必须以实例所有者身份发出此命令。

高级命令参数

-cm

-add

将主机或数据库安装添加到集群管理器域。要添加主机，必须从已经位于对等域中的联机主机运行该命令。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-host 主机名: 将主机添加到集群管理器域（一次添加一个主机）。该软件必须已安装在已添加到集群并且可供使用的主机上。
-database_mounts 数据库名称: 对未使用所使用的实例创建的数据库添加安装资源。例如，如果数据库是从 V9.7 进行迁移，或者数据库是使用另一个实例创建的，然后进行编目以与当前实例配合使用，那么您将使用此选项。

-create

创建对等域或资源模型。除非服务指示需要此选项，否则通常不需要此选项。

-domain domain-name -host 主机名

创建对等域。命令中指定的主机必须是本地主机，并且必须已安装 Db2 集群服务软件。如果您想要将对等域的名称更改为缺省名称之外的名称，请指定域名：db2domain。此选项仅可供 Db2 集群服务管理员使用。

-resources

根据 db2nodes.cfg 文件中的信息来为实例创建集群管理器资源模型。只有 SYSADM、SYSCTL 或 SYSMAINT 组中的用户才能使用此选项。

完成此命令之后，HA 注册表中就会填充资源元数据。

如果 HA 注册表中已经存在资源元数据，那么此命令将失败。调用带有 -delete -resources -force 的 db2cluster 命令以除去 HA 注册表元数据，或者调用 db2cluster -repair -resources 以使用 HA 注册表中的资源元数据重新创建资源模型。

-unhealthy_host_response -option

指定 Db2 集群服务将在主机迂到可能影响集群其余部分的吞吐量或可用性的过多负载或页面调度时执行下列其中一项操作。此响应的条件为如下所示：

PctTotalPgSpFree < 95% and VMPgInRate > 20 per second

其中 PctTotalPgSpFree 是可用页面空间的百分比（表示页面文件使用率大于 5%），而 VMPgInRate 是页面调进速度。

-reboot_host: 重新引导主机。主机上的任何常驻成员都将在访客主机上以轻度方式重新启动，直到其原始主机成功重新引导为止。如果主集群高速缓存设施位于主机上，那么辅助集群高速缓存设施将作为新的主项接管; 在旧主项的主机成功重新引导后，它将作为辅助集群高速缓存设施重新加入集群。
-offline_member: 强制主机上的任何成员或集群高速缓存工具脱机。在手动清除生成的警报之前，处于脱机状态的集群高速缓存工具将不会重新启动。处于脱机状态的成员将在访客主机上以轻度方式重新启动，并且直到手动清除生成的警报后才会在其原始主机上重新启动。
-option -apply_to_current_host: 指定要将不正常的主机响应应用于当前主机。

注: 此选项应谨慎使用，并且只能以 Db2 集群服务管理员身份运行。有关更多信息，请参阅相关链接部分。

-remove

从集群管理器域中移除主机或数据库安装。要移除主机，必须从位于对等域中的联机主机运行该命令。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-host 主机名: 从集群管理器域中移除单个主机。必须已从主机中除去任何成员或集群高速缓存工具。
-database_mounts 数据库名称: 移除数据库的安装资源。

-delete

删除对等域或资源模型。除非服务指示需要此选项，否则通常不需要此选项。

-domain 域名

删除对等域。此选项仅可供 Db2 集群服务管理员使用。

-force: 即使域中存在任何联机集群资源，也可以使用 force 选项来强制删除实例域资源。
注: -force 选项将删除资源模型的所有元数据，因此实例配置将丢失。

-resources

删除集群管理器资源模型。删除资源后，在正确重新创建资源模型之前，无法启动 Db2 实例。只有 SYSADM、SYSCTL 或 SYSMAINT 组中的用户才能使用此选项。 db2nodes.cfg 的内容将与 HA 注册表元数据进行比较。如果它们存在差异，那么该命令将失败。产生差异的主要原因是，一个或多个成员当前已故障转移到访客主机。在这种情况下，应确定故障原因并进行修复，以便成员可以故障回退到其根主机。

-force: 绕过 db2nodes.cfg 比较，并删除资源模型中存在的 HA 注册表元数据。仅当 IBM 支持人员指示您使用此选项时，才应使用此选项。

-unhealthy_host_response

在经历过多负载或页面调度的主机上删除自动响应 (重新引导主机重新引导或使主机上的任何成员或集群高速缓存工具处于脱机状态)。如果发生此情况，那么实例将不执行任何操作，并且该条件将由成员或集群高速缓存工具 (缺省行为) 记录。

-list

将返回有关下列选项的信息：

-domain

将返回集群管理器对等域的名称。

-host host-name1...host-nameN

列示位于对等域中的主机。

-state: 将返回位于对等域中的主机的状态。

configuration

列示可以更改的文件系统和配置参数的当前配置。

-tiebreaker

列示用作 Db2 集群服务仲裁器的设备类型。

zout: 按应用程序可以使用的格式来显示输出。

alert

列示集群元素的任何警报。

pprimary

列出将哪些集群高速缓存工具 Db2 集群服务指定为首选主服务。只有 SYSADM、SYSCTL 或 SYSMAINT 组中的用户才能使用此选项。

-repair

修复实例的不一致的资源模型或域。 Db2 实例资源是根据上次正确的实例配置 (即，上次成功执行 db2start 命令的实例配置) 重新创建的。

-resources

指定此项以修复实例的资源模型。

-domain domain-name

指定此项以修复集群管理器域。使用与现有集群管理器域相同的拓扑配置来重新创建该域。除了初始化 Db2 集群服务仲裁和主机故障检测时间外，这还包括现有集群主机集。当前仅支持每个集群中有一个实例，并且必须通过设置 DB2INSTANCE 环境变量来指定此实例。此命令只能以 Db2 集群服务管理员身份运行。有关更多信息，请参阅相关链接部分。

-force: 删除集群管理器域，然后重新创建集群管理器域。集群主机故障检测时间设置为缺省值 8 秒。此外，如果 db2nodes.cfg 与 HA 注册表的内容不匹配，那么将更正该文件。

-start

启动下列其中一个选项：

-domain 域名: 启动对等域。如果该域在当前主机上已启动，那么只能启动其他节点。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。
-filesystem fs-name -disk: 启动所有位于其中的磁盘Down目标文件系统中的状态。
-host host-name1...host-nameN: 指定要启动对等域的主机。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-stop

停止下列其中一个选项：

-domain 域名: 在整个对等域中停止集群管理器。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。
-host host-name1...host-nameN: 如果实例已停止，那么在所指定主机上停止集群管理器。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-force: 强制关闭整个群集管理器对等域，而不执行诸如确保保持工作配额的检查。将此选项与 -host 选项一起运行时，将仅关闭所指定的主机。

-cfs

-create -domain domain-name -host 主机名

创建共享文件系统集群。命令中指定的主机必须是本地主机，并且必须已安装 Db2 集群服务软件。如果您想要将共享文件系统集群的名称更改为缺省名称之外的名称，请指定域名：db2gpfsdomain。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-add

向共享文件系统集群添加主机或网络弹性。必须从已经位于对等域中的联机主机运行该命令。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-host 主机名

将主机添加到共享文件系统集群（一次添加一个主机）。该软件必须已安装在将添加到集群并且可供使用的主机上。

-network_resiliency

为集群文件系统所使用的适配器添加条件和响应资源。当适配器更改状态（脱机或联机）时，集群管理器将调用响应脚本，该脚本将执行相应的操作。

-gpfsadapter: 指定应该对 IBM Spectrum Scale 适配器进行操作。不是一定需要指定此适配器，因为这是当前唯一可以对其进行操作的网络弹性资源。

-remove -host 主机名

从共享文件系统集群中移除单个主机。必须已从主机中除去任何成员或集群高速缓存工具。必须从位于共享文件系统集群中的联机主机运行此命令。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-delete

删除共享文件系统集群或者网络弹性。此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-domain 域名

删除共享文件系统集群。

-network_resiliency

删除集群文件系统所使用的适配器的条件和响应资源。

-gpfsadapter: 指定要删除的网络 -network_resiliency 的 IBM Spectrum Scale 适配器。

-start

此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-host host-name1...host-nameN: 在所指定的主机上启动共享文件系统进程。
-all: 在所有主机上启动共享文件系统进程。
-trace: 启用 IBM Spectrum Scale 组件的 AIX 跟踪。

-stop

此选项仅对 Db2 集群服务管理员可用，通常不需要此选项，除非服务指示。

-host 主机名

在所指定的主机上停止共享文件系统守护程序。

-force: 指定不进行检查以确保保持工作配额。

-all

在所有主机上停止共享文件系统守护程序。

-trace

停止 IBM Spectrum Scale 组件的 AIX 跟踪。

-list

将返回有关下列选项的信息：

-domain

将返回共享文件系统集群的名称。

-host host-name1...host-nameN

列示位于共享文件系统集群中的主机。

-state: 将返回位于共享文件系统集群中的主机的状态。

-network_resiliency

列示集群中的网络弹性条件和响应资源的名称。

-gpfsadapter: 列出网络 -network_resiliency的 IBM Spectrum Scale 适配器。
-resources: 列示集群中的网络弹性条件和响应资源的内容。

示例

Example 1

要列示文件系统，请使用以下 db2cluster 命令：

db2cluster -cfs -list -filesystem

Example 2

要列示集群元素的任何警报，请使用以下 db2cluster 命令：

db2cluster -cm -list -alert

以下是您运行该命令时产生的样本输出：

Alert: Db2 member '0' failed to start on its home host 'HostA'. 
The cluster manager will attempt to restart the Db2 member 
in restart light mode on another host. Check the db2diag.log 
for messages concerning failures on host 'HostA' for member '0'."

Action: This alert must be cleared manually with the command: 
'db2cluster -cm -clear -alert'.

Impact: Db2 member '%0' will not be able to service requests 
until this alert has been cleared and the Db2 member 
returns to its home host.

Example 3

要查询集群中所有主机的维护状态，请使用以下 db2cluster 命令：

DB2INSTANCE=<instanceName> <SQLLIB>/bin/db2cluster -cm -verify -maintenance -all

以下是您运行该命令时产生的样本输出：

Host(s) in maintenance: 'hostA'
Host(s) not in maintenance: 'hostB,hostD'
Host(s) not reachable from current host: 'hostC'. Run 'db2cluster -cm -verify -maintenance' locally to determine the state. Address any accessibility issue first before re-running the command.

Example 4

要通过从一个主机上的所有适配器 ping 到集群中的所有其他适配器来测试 -rdma_ping 选项：

db2cluster -verify -req -rdma_ping -host coralpib257

Example 5

要通过从一个主机上的所有适配器 ping 到另一个主机上的所有适配器来测试 -rdma_ping 选项：

db2cluster -verify -req -rdma_ping -host coralpib257 -host coralpib258

Example 6

要测试从一个主机上的所有适配器到另一个主机上的特定适配器的 -rdma_ping 选项，请执行以下操作:

db2cluster -verify -req -rdma_ping -host coralpib257 -host coralpib258 -netname coralpib258-ib0

Example 7

要通过从特定适配器 ping 到集群中的所有其他适配器来测试 -rdma_ping 选项：

db2cluster -verify -req -rdma_ping -host coralpib257 -netname coralpib257-ib0

Example 8

要通过从一个主机上的特定适配器 ping 到另一个主机上的特定适配器来测试 -rdma_ping：

db2cluster -verify -req -rdma_ping -host coralpib257 -netname coralpib257-ib0 -host coralpib258 -netname coralpib258-ib0

使用说明

如果 ALERT 列在运行命令 db2instance -list后具有 YES 条目，那么可以使用 db2cluster -cm -list -alert 命令来查找有关更正操作的更多信息。

db2cluster -管理 Db2 集群服务 命令

权限

命令语法 - 标准选项

命令语法 - 高级选项

命令参数

高级命令参数

示例

使用说明

db2cluster -管理 Db2 集群服务命令