scswitch - Oracle® Solaris Cluster 参考手册

语言：

scswitch (1M)

名称

scswitch - 在 Oracle Solaris Cluster 配置中执行资源组和设备组的所有权与状态更改

用法概要

scswitch -c -h node[,...] -j resource[,...] -f flag-name

scswitch {-e | -n} [-M] -j resource[,...] [-h node[,...]]

scswitch -F {-g resource-grp[,...] | -D device-group[,...]}

scswitch -m -D device-group[,...]

scswitch -Q [-g resource-grp[,...]] [-k]

scswitch -R -h node[,...] -g resource-grp[,...]

scswitch -r [-g resource-grp[,...]]

scswitch -S -h node[,...] [-K continue_evac]

scswitch -s [-g resource-grp[,...]] [-k]

scswitch {-u | -o} -g resource-grp[,...]

scswitch -Z [-g resource-grp[,...]]

scswitch -z -D device-group[,...] -h node [,...]

scswitch -z [-g resource-grp[,...]] [-h node [,...]]

描述

注 - Oracle Solaris Cluster 软件包括面向对象的命令集。虽然 Oracle Solaris Cluster 软件仍支持原始的命令集，但是 Oracle Solaris Cluster 过程文档仅使用面向对象的命令集。有关面向对象的命令集的更多信息，请参见 Intro(1CL) 手册页。

scswitch 命令可将资源组或设备组（也称为磁盘设备组）移到新主节点。该命令还提供了各种选项，分别用于通过移动所有权从节点清除所有资源组和设备组、使资源组或设备组脱机和联机、启用或禁用资源、切换资源组的 Unmanaged 状态或者清除资源的错误标志。

可以从 Oracle Solaris Cluster 配置中的任何节点运行 scswitch 命令。如果某个设备组脱机，可使用 scswitch 使该设备组在节点列表中的任何主机上联机。但是，一旦该设备组联机，即不允许切换到备用节点。一次仅允许调用一个 scswitch 命令。

请勿试图中止已经运行的 scswitch 操作。

有关有效使用该命令的更多信息，请参见各个选项的描述。为便于管理，请在全局区域中使用此命令。

选项

基本选项

支持以下基本选项。可以与部分基本选项一起使用的选项在“附加选项”中有所介绍。

–c

清除指定节点中指定资源集的 –fflag-name 错误标志。对于 Oracle Solaris Cluster 软件的最新发行版，–c 选项仅对 Stop_failed 资源状态实现。清除 Stop_failed 资源状态会将资源在指定节点中置于脱机状态。

仅在全局区域中使用此选项。

如果对资源执行 Stop 方法失败，而且该资源的 Failover_mode 属性设置为 Hard，则资源组管理器 (Resource Group Manager, RGM) 将停止或重新引导节点，以强制该资源（以及该节点管理的所有其他资源）脱机。

如果对资源执行 Stop 方法失败，而且 Failover_mode 属性设置为 Hard 以外的其他值，则各个资源将进入 Stop_failed 资源状态，而资源组将置于 Error_stop_failed 状态。无法使任何节点上处于 Error_stop_failed 状态的资源组在任何节点上联机，也不能编辑此类资源组（不能添加或删除资源或者更改资源组属性或资源属性）。必须通过执行Oracle Solaris Cluster 数据服务规划和管理指南 中记录的过程来清除 Stop_failed 资源状态。

注意 - 请确保在清除 Stop_failed 资源状态之前，在指定节点中停止了资源及其监视器。清除 Stop_failed 资源状态而不完全中止资源及其监视器可能导致该资源的多个实例在群集中同时执行。如果使用的是共享存储，这种情况可能会导致数据损坏。如有必要，作为最后的解决方法，对关联的进程执行 kill(1) 命令。

–e

启用指定的 resource。

仅在全局区域中使用此选项。

启用了资源后，该资源将进入联机或脱机状态，具体取决于其资源组是联机还是脱机。

可以同时指定 –h 选项与 –e 选项，仅在指定的节点子集中启用资源。如果省略 –h 选项，则会在所有节点中启用指定资源。

–F

使指定资源组 (–g) 或设备组 (–D) 在所有节点上脱机。

指定 –F 选项与 –D 选项时，可以只从全局区域运行 –F 选项。

使用 –F 选项使设备组脱机时，主节点会停止或释放关联的 Solaris Volume Manager 磁盘集。将设备组置于脱机状态之前，必须停止对其中设备的所有访问并且卸载所有依赖该组的文件系统。要启动脱机的设备组，可以发出显式 scswitch 调用、访问该组中的设备或者挂载依赖该组的文件系统。

–m

使指定的设备组从群集脱机以进行维护。生成的状态在重新引导后保持不变。

仅在全局区域中使用此选项。

在将设备组置于维护模式之前，必须停止对其中设备的所有访问并且卸载所有依赖该组的文件系统。如果某个设备组当前正被访问，则该操作将失败，指定的设备组不会从群集脱机。

可使用 –z 选项使设备组恢复联机。只有对 scswitch 命令的显式调用才能使设备组脱离维护模式。

–n

禁用指定的资源。

仅在全局区域中使用此选项。

在当前主节点上联机的已禁用资源将立即从这些主节点脱机。无论其资源组状态如何，禁用的资源都将保持脱机状态。

可以同时指定 –h 选项与 –e 选项，仅在指定的节点子集中禁用资源。如果省略 –h 选项，则会在所有节点中禁用指定资源。

–o

使不受管理的指定资源组脱离不受管理状态。

一旦资源组处于受管理状态，RGM 即会尝试将该资源组联机。

–Q

将指定的资源组置于停顿状态。

如果省略 –g 选项，–Q 选项将应用于所有资源组。

此选项可阻止指定资源组在 Start 或 Stop 方法失败时不断在节点间切换。在资源组进入停顿状态而不再在任何节点上停止或启动之前，这种 scswitch 命令格式不会退出。

如果在 scswitch -Q 命令执行期间，对组中的任何资源执行 Monitor_stop、Stop、Postnet_stop、Start 或 Prenet_start 方法失败，则该资源的行为类似于其 Failover_mode 属性设置为 None 时，无论其实际设置如何。一旦其中某个方法失败，该资源即进入错误状态（Start_failed 或 Stop_failed 资源状态），而不会启动节点的故障转移或重新引导。

当 scswitch -Q 命令退出时，指定的资源组可能处于联机或脱机状态或者处于 ONLINE_FAULTED 或 ERROR_STOPPED_FAILED 状态。可通过执行 clresourcegroup status 命令确定其当前状态。

如果某个节点在 scswitch -Q 命令执行期间消亡，则可能会中断其执行，使资源组处于非停顿状态。如果执行中断，scswitch -Q 将返回一个非零退出代码，并向标准错误中写入一条错误消息。在此情况下，您可以重新发出 scswitch -Q 命令。

可以同时指定 –k 选项与 –Q 选项来加速资源组的停顿。如果指定了 –k 选项，该命令会立即中止对受影响资源组中的资源运行的所有方法。如果未指定 –k 选项，系统会允许方法继续运行，直到这些方法退出或超过所配置的超时时间。

–R

使指定资源组在指定的主节点中脱机，然后使其恢复联机。

指定的节点必须是资源组的当前主节点。

–r

继续先前由 –s 选项暂停的对指定资源组的自动恢复操作。

如果省略 –g 选项，–r 选项将应用于所有资源组。

在您没有明确发出命令继续执行自动恢复过程之前，已暂停的资源组不会自动重新启动或进行故障转移。无论是联机还是脱机，已暂停的数据服务都仍将处于其当前状态。您仍可在指定的节点上将资源组手动切换到不同的状态。此外，您依然可以启用或禁用资源组中的单个资源。

有关如何暂停对资源组的自动恢复操作的信息，请参见 –s 选项的描述。

–S

将所有资源组和设备组切换为在指定的 node 上脱机。

在全局区域中执行时，此选项可以清除群集中的任何指定节点。

系统尝试根据为每个组配置的首选项选择新的主节点。所有清除的组未必由同一个主节点重新控制。如果无法成功从指定节点清除该节点管理的所有组，此命令将退出并显示错误。

资源组在重定位到新的主节点之前会首先脱机。如果系统无法在新的主节点中启动某个清除的资源组，该资源组可能保持脱机状态。

如果无法将设备组的主所有权更改为其他某个节点，该设备组的主所有权仍将由原始节点持有。

–s

暂停自动恢复操作并停止指定的资源组。

如果省略 –g 选项，–s 选项将应用于所有资源组。

除非您使用此选项显式恢复监视暂停的资源组，否则该资源组不会自动启动、重新启动或进行故障转移。即使资源组的监视仍处于暂停状态，数据服务也将保持联机。您仍然可以手动切换该资源组，使其在指定节点中联机或脱机。此外，您依然可以启用或禁用资源组中的单个资源。

为了检查并修复群集中存在的问题，您可能需要暂停资源组的自动恢复过程。也就是说，您可能需要对资源组服务进行维护。

还可以指定 –k 选项来立即中止对受影响资源组中的资源运行的所有方法。使用 –k 选项可以加速资源组的停顿。如果未指定 –k 选项，系统会允许方法继续运行，直到这些方法退出或超过所配置的超时时间。

有关如何使资源组的自动恢复操作继续的信息，请参见 –r 选项的描述。

–u

将指定的受管理资源组置于不受管理状态。

使用 –u 选项的一个先决条件是，必须首先禁用属于指定资源组的所有资源。

–Z

此选项的作用如下：

启用指定资源组中的所有资源
将这些资源组更改为受管理状态
使这些资源组在所有默认主节点上联机

如果省略 –g 选项，–Z 选项将应用于所有资源组。

如果未指定 –g 选项，则除了已暂停的资源组之外，scswitch 命令会尝试将所有资源组联机。

–z

请求更改指定资源组或设备组的主节点。

如果省略 –g 选项，–z 选项将应用于所有资源组。

–z 选项与 –D 选项一起使用时，可将一个或多个指定设备组切换到指定节点。对于一个设备组的切换，只能指定一个主节点名。指定了多个设备组时，–D 选项会按照指定顺序切换这些设备组。如果 –z –D 操作遇到错误，该操作将会停止，不会执行进一步的切换。

–z 选项仅与 –g 选项一起使用时可使指定资源组（必须已经受管理）在其首选的节点中联机。这种 scswitch 命令格式不会违反资源组的强 RG_affinities 而使该资源组联机，而且，如果资源组的关联性无法在任何节点中得到满足，该命令将输出一条警告消息。与 –Z 选项不同，此选项不会启用任何资源、启用对任何资源的监视或者使任何资源组脱离不受管理状态。

–z 选项与 –g 和 –h 选项一起使用时，可使指定资源组在 –h 选项指定的节点中联机，并使这些资源组在其他所有群集节点中脱机。如果使用 –h 选项指定的节点列表为空 (-h "")，–z 选项会使 –g 选项指定的资源组从其所有当前主节点或区域脱机。– h 选项指定的所有节点必须是群集的当前成员，而且必须是 –g 选项指定的所有资源组的潜在主节点。–h 选项指定的节点的数目不得超过 g 选项指定的任何资源组的 –Maximum_primaries 属性设置。

单独使用时 (scswitch -z)，–z 选项会将在其首选节点中未暂停的所有受管理资源组切换为联机。

如果配置一个或多个资源组的 RG_affinities 属性并发出 scswitch -z -g 命令（带有或不带 –h 选项），则可能还会切换除 –g 选项之后指定的资源组以外的其他资源组。rg_properties(5) 中介绍了 RG_affinities。

附加选项

可将以下附加选项与上述基本选项组合使用，如下所述：

–D

指定一个或多个设备组的名称。

此选项仅能与 –F、–m 和 –z 选项一起使用。

要将此命令选项与 –F、–m 或 –z 选项（连同 –h 选项）一起使用，您需要具有 solaris.cluster.device.admin 基于角色的访问控制 (role-based access control, RBAC) 授权。请参见 rbac(5)。

您还必须能够承担已向其分配 Oracle Solaris Cluster 命令权限配置文件的角色，才能使用该命令。经授权的用户可以通过 pfsh、pfcsh 或 pfksh 配置文件 shell 在命令行上发出 Oracle Solaris Cluster 特权命令。配置文件 shell 是一种特殊的 shell，通过该 shell，可以访问分配给 Oracle Solaris Cluster 命令权限配置文件的 Oracle Solaris Cluster 特权命令。当您运行 su 以承担某个角色时，即会启动配置文件 shell。还可以使用 pfexec 发出 Oracle Solaris Cluster 特权命令。

–f

指定错误 flag-name。

此选项仅能与 –c 选项一起使用。

当前支持的唯一错误标志是 Stop_failed。

要将此命令选项与 –c 选项一起使用，您需要具有 solaris.cluster.resource.admin RBAC 授权。请参见 rbac(5)。

–g

指定一个或多个资源组的名称。

此选项仅能与 –F、–o、–Q、–r、–R、–s、–u、–z 和 –Z 选项一起使用。

要将此命令选项与以下选项一起使用，您需要具有 solaris.cluster.resource.admin RBAC 授权：

–F 选项
–o 选项
–Q 选项
–R 选项连同 –h 选项
–r 选项
–s 选项
–u 选项
–Z 选项
–z 选项 –h 选项

请参见 rbac(5)。

–h

指定一个或多个群集节点的名称。

此选项仅能与 –c、–e、–n、–R、–S 和 –z 选项一起使用。

与 –c、–e、–n、–R 或 –z 选项一起使用时，–h 选项可接受以逗号分隔的节点列表。

要为 –z 选项指定一个空节点列表，请指定两个双引号 "" 作为 –h 选项的参数。

对于配置为具有多个主节点的资源组，–h 选项列出的节点名称必须全部是 –g 选项指定的每个资源组的有效潜在主节点。

如果某个资源组未能在 –h 选项指定的节点上成功启动，则该资源组可能会故障转移到其他节点。此行为由 Failover_mode 资源属性的设置决定。有关更多信息，请参见 r_properties(5)。

与 –S 选项一起使用时，–h 选项可指定要清除其资源组和设备组的单个节点的名称。

要将此命令选项与 –c、–R 选项（连同 –g 选项）、–S 或 –z 选项（连同 – g 选项）一起使用，您需要具有 solaris.cluster.resource.admin RBAC 授权。此外，要将此命令选项与 –z 选项（连同 –D 选项）一起使用，您需要具有 solaris.cluster.device.admin RBAC 授权。请参见 rbac(5)。

–j

指定一个或多个 resource 的名称。

此选项仅能与 –c、–e 和 –n 选项一起使用。

要将此命令选项与 –c、–e 或 –n 选项一起使用，您需要具有 solaris.cluster.resource.admin RBAC 授权。请参见 rbac(5)。

–K

指定从某个节点成功清除资源组后阻止资源组切换回该节点的秒数。

如果正从节点清除，则资源组无法故障转移或自动切换到该节点，而且，在清除完成后，在此选项指定的时间（秒）内也无法进行故障转移或自动切换。可以通过在达到 continue_evac 指定的秒数之前使用 scswitch -z -g -h 命令将资源组切换到清除了资源组的节点中，覆盖 –K 计时器。完成此种切换后，–K 计时器将立即被视为过期。但是，不带 –h 标志的 scswitch -z -g 或 – Z 命令将继续使用 –K 计时器，并阻止将任何资源组切换到清除了资源组的节点。

此选项仅能与 –S 选项一起使用。必须指定介于 0 和 65535 之间的整数值。如果未指定值，将使用默认值 60 秒。

您需要具有 solaris.cluster.resource.admin RBAC 授权才能使用该命令选项。请参见 rbac(5)。

–k

立即中止对指定资源组中的资源运行的资源组管理器 (Resource Group Manager, RGM) 资源方法。

可将此选项与 –Q 和 –s 选项一起使用。如果未指定 –k 选项，系统会允许方法继续运行，直到这些方法退出或超过所配置的超时时间。

–M

启用 (–e) 或禁用 (–n) 对指定资源的监视。如果禁用了资源，则无需禁用其监视，因为该资源及其监视器都会保持脱机。

此选项仅能与 –e 和 –n 选项一起使用。

要将此命令选项与 –e 或 –n 选项一起使用，您需要具有 solaris.cluster.resource.admin RBAC 授权。请参见 rbac(5)。

示例

示例 1 切换资源组

以下命令将 resource-grp-2 切换为由 schost-1 管理。

schost-1# scswitch –z –h schost-1 –g resource-grp-2

示例 2 使受管理资源组联机而不启用监视或资源

以下命令将使 resource-grp-2 联机（如果该 resource-grp-2 已经受管理），但是不会启用当前禁用的任何资源或对这些资源的监视。

schost-1# scswitch –z –g resource-grp-2

示例 3 切换配置为具有多个主节点的资源组

以下命令将配置为具有多个主节点的资源组 resource-grp-3 切换为由 schost-1,schost-2,schost-3 管理。

schost-1# scswitch –z –h schost-1,schost-2,schost-3 –g resource-grp-3

示例 4 从节点移出其所有资源组和设备组

以下命令将 schost-1 的所有资源组和设备组切换到一个新的主节点集。

schost-1# scswitch –S –h schost-1

示例 5 从节点永久移出其所有资源组和设备组

以下命令将 schost-1 的所有资源组和设备组切换到一个新的主节点集。该命令还指定在允许资源组和设备组切换回 schost-1 之前需等待 120 秒。

在以下命令中使用 –K 选项可阻止资源组在成功从 schost-1 清除后自动切换回 schost-1。资源组可能尝试切换回 schost-1 的一个示例情况是该资源组未能成功在其新主节点上启动。另一个示例情况是资源组具有使用 RG_affinities 属性配置的强负关联性。

schost-1# scswitch –S –h schost-1 -K 120

示例 6 禁用资源

schost-1# scswitch –n –j resource-1,resource-2

示例 7 启用资源

schost-1# scswitch –e –j resource-1

示例 8 使资源组进入不受管理状态

schost-1# scswitch –u –g resource-grp-1,resource-grp-2

示例 9 使资源组脱离不受管理状态

schost-1# scswitch –o –g resource-grp-1,resource-grp-2

示例 10 切换设备组

以下命令将 device-group-1 切换为由 schost-2 管理。

schost-1# scswitch –z –h schost-2 –D device-group-1

示例 11 将设备组置于维护模式

以下命令将 device-group-1 置于维护模式。

schost-1# scswitch –m –D device-group-1

示例 12 使资源组停顿

以下命令将资源组 RG1 和 RG2 置于停顿状态。

schost-1# scswitch –Q -g RG1,RG2

示例 13 通过切换资源组清除 Start_failed 资源状态

Start_failed 资源状况指示 Start 或 Prenet_start 方法对某个资源失败或超时，但该资源的资源组仍已联机。即使该资源处于故障状况，可能不提供服务，其资源组仍然会联机。如果资源的 Failover_mode 属性设置为 None 或者设置为阻止资源组故障转移的另一个值，则可能会出现此状况。

与 Stop_failed 资源状况不同，Start_failed 资源状况不会阻止您或 Oracle Solaris Cluster 软件对资源组执行操作。您无需发出 scswitch -c 命令来清除 Start_failed 资源状态。只需执行一个可重新启动资源的命令。

以下命令清除 resource-grp-2 资源组中的资源发生的 Start_failed 资源状态。该命令通过将资源组切换到 schost-2 节点来清除此状态。

schost-1# scswitch –z –h schost-2 –g resource-grp-2

示例 14 通过重新启动资源组清除 Start_failed 资源状态

以下命令清除 resource-grp-2 资源组中的资源发生的 Start_failed 资源状态。此命令通过在 schost-1 节点上重新启动该资源组来清除此状态。

有关 Start_failed 资源状态的更多信息，请参见 r_properties(5) 手册页。

schost-1# scswitch –R –h schost-1 –g resource-grp-2

示例 15 通过禁用然后启用资源清除 Start_failed 资源状态

以下命令通过禁用然后重新启用 resource-1 资源来清除该资源发生的 Start_failed 资源状态。

有关 Start_failed 资源状态的更多信息，请参见 r_properties(5) 手册页。

schost-1# scswitch –n –j resource-1
schost-1# scswitch –e –j resource-1

退出状态

此命令停顿，直到请求的操作全部完成或发生错误为止。

返回以下退出值：

0: 命令已成功完成。
非零值: 发生错误。scswitch 将错误消息写入标准错误。

如果 scswitch 命令退出时退出状态为非零值并且显示错误消息 "cluster is reconfiguring"（群集正在重新配置），尽管出错，请求的操作仍然可能已经成功完成。如果您对结果不确定，可以在重新配置完成后使用相同参数再次执行 scswitch 命令。

如果 scswitch 命令退出时退出状态为非零值并且显示错误消息 "Resource group failed to start on chosen node and may fail over to other node(s)"（资源组未能在所选节点上启动，可能故障转移到其他节点），该资源组在 scswitch 命令退出后仍将继续重新配置一段时间。资源组的其他 scswitch 或 clresourcegroup 操作将失败，直到该资源组在所有节点上达到终端状态，例如 Online、Online_faulted 或 Offline 状态。

如果对多个资源或资源组调用 scswitch 命令并且发生多个错误，退出值可能只反映其中一个错误。为了避免这种情况，请一次只对一个资源或资源组调用 scswitch 命令。

对于 RG_system 属性为 True 的资源组（及其资源），不允许执行某些操作。有关更多信息，请参见 rg_properties(5)。

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型	属性值
可用性	`ha-cluster/system/core`
接口稳定性	过时

另请参见

kill(1)、pfcsh(1)、pfexec(1)、pfksh(1)、pfsh(1)、Intro(1CL)、cldevicegroup(1CL)、clresourcegroup(1CL)、su(1M)、attributes(5)、rbac(5)、r_properties(5)、rg_properties(5)

Oracle Solaris Cluster 数据服务规划和管理指南

警告

如果您通过将 –z 或 –F 选项与 –g 选项一起使用来使资源组脱机，则该资源组的 Offline 状态在节点重新引导后不会保持。即使某个节点消亡或加入群集或者如果正在切换其他资源组，该资源组可能仍会联机。即使您之前将该资源组切换为脱机状态，它也会在节点中联机。即使所有资源都被禁用，该资源组还是会进入联机状态。

要禁止资源组自动联机，可使用 –s 选项暂停该资源组的自动恢复操作。要继续自动恢复操作，可使用 –r 选项。