clquorumserver (1CL)
名称
clquorumserver, clqs - 管理法定服务器用法概要
/usr/cluster/bin/clquorumserver -V
/usr/cluster/bin/clquorumserver subcommand -?
/usr/cluster/bin/clquorumserver subcommand [-v] [quorumserver]
/usr/cluster/bin/clquorumserver clear
-c clustername -I clusterID [-y] quorumserver
/usr/cluster/bin/clquorumserver show
[+ | quorumserver[…]]
/usr/cluster/bin/clquorumserver start
{+ | quorumserver[…]}
/usr/cluster/bin/clquorumserver stop
[-d] {+ | quorumserver[…]}
描述
使用 clquorumserver 命令执行以下任务：
-
清理一个或多个法定服务器的过时配置信息。
-
显示一个或多个法定服务器的配置。
-
启动一个或多个法定服务器。
-
停止一个或多个法定服务器。
clqs 命令是 clquorumserver 命令的简短格式。您可以使用此命令的任一种格式。
此命令的一般格式如下所示：
clquorumserver [subcommand] [options]
仅当 options 指定 –?、–v 或 –V 选项时，才能省略 subcommand。
法定服务器必须配置为群集的法定设备。有关配置法定服务器的信息，请参见 scqsd.conf(4) 和 scqsd(1M)。有关将 quorum_server 类型的法定设备添加到群集的信息，请参见 clquorum(1CL)。
子命令
支持以下子命令：
- clear
-
从法定服务器中删除过时的群集信息。法定服务器保存有关其充当法定设备的群集的信息。这些信息在以下情况下可能会变为无效：
-
在没有首先使用 clquorum remove 命令删除群集法定设备的情况下取消了群集的配置
-
在法定服务器主机处于关闭状态时从群集中删除了 quorum_server 类型的法定设备
注意 - 如果法定服务器尚未从群集中删除，使用此子命令清理有效的法定服务器可能会影响群集法定设备。
必须为特定法定服务器指定群集名称和群集 ID。有关详细信息，请参见 –c 和 –I 选项。
超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。有关更多信息，请参见 rbac(5)。
-
- show
-
显示有关法定服务器的配置信息。对于已将法定服务器配置为法定设备的每个群集，此子命令将显示相应的群集名称、群集 ID、保留关键字列表以及注册关键字列表。
可以使用加号 (+) 指定多个法定服务器。
如果未指定任何操作数，或者随操作数一起指定加号 (+)，该命令将输出正在运行的所有法定服务器的配置。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。有关更多信息，请参见 rbac(5)。
- start
-
启动法定服务器
- stop
-
停止法定服务器
选项
支持以下选项：
- –?
- –-help
-
显示帮助信息。
此选项可以单独使用，也可以与子命令结合使用。
-
如果单独使用该选项，则显示可用子命令的列表。
-
如果将该选项与子命令结合使用，将会显示该子命令的用法选项。
使用该选项时，不会执行任何其他处理。
-
- –c clustername
- –-clustername clustername
-
指定将法定服务器用作法定设备的群集的名称。可以通过对群集节点运行某些 Oracle Solaris Cluster 命令（例如 cluster show）来获取群集名称。
运行 clear 子命令时，必须指定此选项。
- –d
- –-disable
-
禁止重新引导后自动重新启动法定服务器。
- –I clusterID
- –-clusterID clusterID
-
指定群集 ID。群集 ID 是一个 8 位十六进制数字。可以通过对群集节点运行某些 Oracle Solaris Cluster 命令（例如 cluster show）来获取群集 ID。
运行 clear 子命令时，必须指定此选项。
- –V
- –-version
-
显示该命令的版本。
指定此选项时，不要将其与子命令、操作数或其他选项结合使用。子命令、操作数或其他选项将被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。
- –v
- -–-verbose
-
将详细信息显示到标准输出 (stdout)。
可以在任何格式的此命令中指定该选项。
- –y
- –-yes
-
该选项仅与 clear 子命令一起使用。它预先回答 clear 子命令提示的确认问题。如果不使用此选项，clear 子命令将提出问题来确认您是否要清理群集信息，您需要回答 yes 或 no。仅当您回答 yes 时，该子命令才会继续处理。如果使用此选项，clear 子命令将不会提出任何确认问题，而是直接删除指定的法定服务器的相应群集信息。
操作数
支持以下操作数：
- quorumserver
-
指定法定服务器的标识符。可以通过端口号或实例名称来标识法定服务器。端口号供群集节点用于与法定服务器进行通信。可以在法定服务器配置文件 /etc/scqsd/scqsd.conf 中指定实例名称。请参见 scqsd.conf(4)。
退出状态
如果命令对于所有指定的操作数均成功执行，则返回零 (CL_NOERR)。如果某个操作数出错，命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。
返回以下退出值：
- 0 CL_NOERR
无错误
您发出的命令已成功完成。
- 1 CL_ENOMEM
交换空间不足
某个群集节点耗尽了交换内存或其他操作系统资源。
- 3 CL_EINVAL
参数无效
您键入的命令不正确，或者使用 –i 选项提供的群集配置信息语法不正确。
- 6 CL_EACCESS
权限被拒绝
指定的对象不可访问。要发出命令，可能需要拥有超级用户或 RBAC 访问权限。有关更多信息，请参见 su(1M) 和 rbac(5) 手册页。
- 18 CL_EINTERNAL
遇到内部错误
内部错误表示软件缺陷或其他缺陷。
- 35 CL_EIO
I/O 错误
发生了物理输入/输出错误。
- 36 CL_ENOENT
没有这样的对象
由于以下某个原因，找不到您所指定的对象：
该对象不存在。
您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。
您尝试使用 –i 选项访问的配置文件包含错误。
示例
示例 1 显示一个法定服务器的配置信息以下命令显示使用端口 9000 的法定服务器的配置信息。
# clquorumserver show 9000示例 2 显示多个法定服务器的配置信息
以下命令显示按实例名称列出的法定服务器的配置信息。
# clquorumserver show qs1 qs2 qs3示例 3 显示所有正在运行的法定服务器的配置信息
以下命令显示正在运行的所有法定服务器的配置信息。
# clquorumserver show +示例 4 启动法定服务器
以下命令启动配置的所有法定服务器。
# clquorumserver start +
以下命令启动正在侦听端口 9000 的法定服务器。
# clquorumserver start 9000
以下命令启动法定服务器实例 qs1。
# clquorumserver start qs1示例 5 按端口号停止法定服务器
以下命令停止正在侦听端口 9000 的法定服务器。
# clquorumserver stop 9000示例 6 清理法定服务器中过时的群集信息
此示例将从法定服务器中删除有关名为 sc-cluster 的群集的信息。
以此种方式取消配置法定服务器时，请谨慎操作。通常，应使用 clquorum remove 从群集配置中删除法定服务器设备并清理有关单个集中法定服务器的配置信息。仅当在 clquorum remove 操作期间群集与法定服务器主机之间的通信丢失时，才需要使用此命令。
# clquorumserver clear -c sc-cluster -I 0x4308D2CF 9000 The quorum server to be unconfigured must have been removed from the cluster. Unconfiguring a valid quorum server could compromise the cluster quorum. Do you want to continue? (yes or no)
属性
有关以下属性的描述，请参见 attributes(5)：
|
另请参见
Intro(1CL)、clquorum(1CL)、cluster(1CL)、scqsd(1M)、scqsd.conf(4)。
附注
超级用户可以运行此命令的所有格式。
任何用户都可以运行带有以下选项的此命令：
-
–?（帮助）选项
-
–V（版本）选项
要运行带有其他子命令的此命令，超级用户以外的用户需要具有 RBAC 授权。请参见下表。
|