scconf (1M)

名称

scconf - 更新 Oracle Solaris Cluster 软件配置

用法概要

scconf -a [-Hv] [-h node_options] [-A adapter_options] [-B 
     switch_options] [-m cable_options] [-P privatehostname_options] 
     [-q quorum_options] [-D devicegroup_options] [-T 
     authentication_options]

scconf -c [-Hv] [-C cluster_options] [-A adapter_options] [-B 
     switch_options] [-m cable_options] [-P privatehostname_options] 
     [-q quorum_options] [-D devicegroup_options] [-S slm_options] 
     [-T authentication_options] [-w heartbeat_options]

scconf -r [-Hv] [-h node_options] [-A adapter_options] [-B 
     switch_options] [-m cable_options] [-P privatehostname_options] 
     [-q quorum_options] [-D devicegroup_options] [-T 
     authentication_options]

scconf -p [-Hv [v]]

scconf [-H]

描述

scconf 命令可管理 Oracle Solaris Cluster 软件配置。您可以使用 scconf 将项添加到配置中、更改以前配置的项的属性，以及从配置中删除项。在此命令的三种格式中，选项都按照它们在命令行上的键入顺序进行处理。与每个选项关联的所有更新必须已成功完成，然后才会考虑下一个选项。

当组成原始磁盘组或 Solaris Volume Manager 元集的磁盘使用基于控制器的复制来实现数据可用性时，还可以使用 scconf 命令来注册这些元集和磁盘组。 在使用 scconf 命令注册磁盘组和元集之前，请确保磁盘组中的所有磁盘要么都是复制的，要么都是非复制的，而不能同时包含这两种磁盘。另外，您必须执行带 –T 或 –t 选项的 scdidadm 命令，或者执行 cldevice replicate 命令。这些命令会将 DID 设备配置为使用基于控制器的复制。有关更多信息，请参见 scdidadm(1M) 手册页或 cldevice(1CL) 手册页。

只能从活动群集节点上运行 scconf 命令。使用哪个节点运行该命令没有区别，只要该节点在群集中处于活动状态即可。无论使用哪个节点，运行该命令的结果始终相同。

使用 scconf 的 –p 选项可以显示当前配置的列表。

scconf 命令的所有格式都接受 –H 选项。指定 –H 将会显示帮助信息，其他所有选项将被忽略且不执行。不带任何选项调用 scconf 时也会显示帮助信息。

仅可以在全局区域中使用此命令。

选项

基本选项

以下选项是 scconf 命令的所有格式共有的：

–H

如果在命令行上的任何位置指定了该选项，都将会显示帮助信息。其他所有选项将被忽略且不执行。不带任何选项调用 scconf 时也会显示帮助信息。

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

下列选项用于修饰 scconf 命令的基本格式和功能。不能在同一命令行上组合使用这些选项。

–a

指定 scconf 命令的 add 格式。

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

使用 –a 选项可以添加或初始化用于定义 Oracle Solaris Cluster 的软件配置的大多数项。将附加选项（例如，适配器、交换机或设备组选项）与 –a 一起使用可以指定要添加的元素及其关联属性。可以在同一命令行上组合使用任意数目的附加选项，只要这些附加选项是可以与 –a 选项一起使用的。

–c

指定 scconf 命令的 change 格式。

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

使用 –c 选项可以更改已配置为 Oracle Solaris Cluster 软件配置一部分的项的属性。将附加选项与 –c 一起使用可以指定新属性或更改的属性。可以在同一命令行上组合使用任意数目的附加选项，只要这些附加选项是可以与 –c 选项一起使用的。

–p

指定 scconf 命令的 print 格式。

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

–p 选项显示您可以使用 scconf 配置的当前 Oracle Solaris Cluster 配置元素及其关联属性的列表。可将此选项与一个或多个 –v 选项组合使用，以显示更详细的列表。

–r

指定 scconf 命令的 remove 格式。

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

使用 –r 选项可以从 Oracle Solaris Cluster 软件配置中删除项。将附加选项与 –r 一起使用可以指定要从配置中删除的项。可以在同一命令行上组合使用任意数目的附加选项，只要这些附加选项是可以与 –r 选项一起使用的。

附加选项

可将下列附加选项与前面所述的一个或多个基本选项组合使用。请参阅“用法概要”部分，以查看可与 scconf 的每种格式一起使用的选项。

附加选项如下：

–A adapter_options

添加、删除或更改群集传输适配器的属性。要使这些操作成功，给定适配器所在的节点不需要在群集中处于活动状态。下面描述了接受 –A 的该命令三种格式使用 –A adapter_options 的方式。

• 使用以下语法为命令的 add 格式指定 –A adapter_options：

  –A name=adaptername,node=
  node[,vlanid=vlanid][,state=
  state] \
  [,other_options]

• 使用以下语法为命令的 change 格式指定 –A adapter_options：

  –A name=adaptername,node=
  node[,state=state] \
  [,other_options]

• 使用以下语法为命令的 remove 格式指定 –A adapter_options：

  –A name=name,node=node
  

–A 选项支持以下子选项：

name=adaptername

指定特定节点上某个适配器的名称。每次指定 –A 选项时，都必须包括该子选项。

adaptername 是基于 device name 构造的，后面紧接一个 physical-unit 编号（例如 hme0）。

node=node

指定特定节点上某个适配器的名称。每次指定 –A 选项时，node 子选项都是必需的。

可以使用节点名称或节点 ID 指定 node。

state=state

更改适配器的状态。可以将该子选项与命令的 change 格式一起使用。state 可设置为 enabled 或 disabled。

将适配器添加到配置后，其状态始终设置为 disabled。默认情况下，将电缆添加到适配器上的任一端口会将端口和适配器的状态都更改为 enabled。请参见 –m cable_options。

禁用一个适配器还会禁用与该适配器关联的所有端口。但是，启用一个适配器不会启用该适配器的端口。要启用某个适配器端口，必须启用该端口连接到的电缆。

trtype=type

指定传输类型。–A 与命令的 add 格式一起使用时，必须包括该子选项。

dlpi 就是一个传输 type 示例。请参见 sctransp_dlpi(7p)。

[vlanid=vlanid]

指定带标记的 VLAN 适配器的 VLAN ID。

[other_options]

如果有其他选项适用于特定的适配器类型，则可以在命令的 add 和 change 格式中与 –A 一起使用这些选项。有关特殊选项的信息，请参阅群集传输适配器手册页。

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.transport.modify RBAC 授权。请参见 rbac(5)。

–B switch_options

添加、删除或更改群集传输交换机（又称传输结点）的属性。

这种设备的示例包括但不限于以太网集线器、其他各种类型的交换机和环网。

下面描述了接受 –B 的三种命令格式使用 –Bswitch_options 的方式。

• 使用以下语法为命令的 add 格式指定 –B switch_options：

  –B type=type,name=name
  [,other_options]

• 使用以下语法为命令的 change 格式指定 –B switch_options：

  –B name=name[,state=
  state][,other_options]

• 使用以下语法为命令的 remove 格式指定 –B switch_options：

  –B name=name
  
  

–B 选项支持以下子选项：

name=name

指定群集传输交换机的名称。每次指定 –B 选项时，都必须包括 name 子选项。

name 的长度为最多 256 个字符。它由字母或数字组成，第一个字符为字母。每个传输交换机名称在群集名称空间中必须唯一。

state=state

更改群集传输交换机的状态。该子选项可以与 –B change 命令一起使用。state 可设置为 enabled 或 disabled。

将交换机添加到配置后，其状态始终设置为 disabled。默认情况下，将电缆添加到交换机上的任一端口会将端口和交换机的状态都更改为 enabled。请参见 –m cable_options。

禁用一个交换机还会禁用与该交换机关联的所有端口。但是，启用一个交换机不会启用该交换机的端口。要启用某个交换机端口，必须启用该端口连接到的电缆。

type=type

指定群集传输交换机类型。–B 与命令的 add 格式一起使用时，必须包括该子选项。

以太网集线器就是 switch 类型的群集传输交换机的示例。scconf_transp_jct_etherswitch(1M) 手册页中提供了更多信息。

[other_options]

如果有其他选项适用于特定的交换机类型，则可以在命令的 add 和 change 格式中与 –B 一起使用这些选项。有关特殊选项的信息，请参阅 scconf_transp_jct_etherswitch(1M) 群集传输交换机手册页。

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.transport.modify RBAC 授权。请参见 rbac(5)。

–C cluster_options

更改群集自身的名称。该选项只能与命令的 change 格式一起使用。

按以下方式为命令的 change 格式指定 cluster_options：

–C cluster=clustername

此命令格式会将群集的名称更改为 clustername。

–D devicegroup_options

向配置添加设备组，更改或重设现有设备组的属性，或者从 Oracle Solaris Cluster 设备组配置中删除组。其他设备组选项 (other_options) 在添加或更改设备组及其选项方面发挥着重要作用。配置任何设备组时，请特别注意与类型相关的设备组选项的手册页（例如 scconf_dg_svm(1M) 和 scconf_dg_rawdisk(1M)）。并非所有设备组类型都支持 –D 选项的所有三种格式。例如，svm 设备组通常只能与命令的 change 格式一起使用来更改特定属性，例如节点优先级列表的顺序。

命令的 add 格式可用于创建设备组，或者向现有设备组添加节点。对于某些设备组类型，add 格式还可用于向组中添加设备。命令的 change 格式可以注册更新，以更改与某个组关联的特定属性。命令的 remove 格式可用于删除整个设备组，或者删除组的一个或多个组件。

接受 –D 的三种 scconf 命令格式使用 –D devicegroup_options 的方式如下：

添加：

–D type=type,name=
name[,nodelist=node[:
node]…]
        [,preferenced={true | false}]
        [,numsecondaries=integer]
        [,failback={enabled | disabled}][,other_options]

更改：

–D name=name[,nodelist=
node[:node]…]
        [,preferenced={true | false}]
        [,numsecondaries=integer]
        [,failback={enabled | disabled}][,other_options]

删除：

–D name=name,nodelist=
node[:node]…

–D 选项支持以下子选项：

name=name

设备组的名称。使用命令的所有三种格式时都必须提供该名称。

nodelist=node[: node]…

潜在主节点的列表，将组添加到群集时，某些设备组类型需要该列表。有关更多信息，请参阅与类型相关的设备组的手册页。

将 preferenced 子选项设置为 true 时，nodelist 子选项是必需的。

使用命令的 add 格式时，默认情况下，nodelist 是一个有序列表，指明了节点尝试作为设备组的主节点进行接管时应遵循的优先顺序。但是，如果 preferenced 子选项设置为 false（请参见下一子部分），则访问组中设备的第一个节点自动成为该组的主节点。向现有设备组添加节点时，不能使用 preferenced 子选项。但是，首次创建组时可以使用 preferenced 子选项，或者将其与命令的 change 格式一起使用。

要更改主节点顺序优先级，必须在 nodelist 中按所需顺序指定群集节点的完整列表。还必须将 preferenced 子选项设置为 true。

与命令的 remove 格式一起使用时，nodelist 子选项可用于从设备组中删除指定的节点。只要不提供 nodelist，就可以删除整个设备组。单单从一个设备组中删除所有节点并不一定会删除该组。

type=type

设备组的类型。要指明需要创建的设备组的类型（例如 rawdisk），必须将该类型与命令的 add 格式一起使用。

[failback={enabled |  disabled}]

与命令的 add 或 change 格式一起使用时，可启用或禁用设备组的 failback 行为。

指定当设备组主节点脱离群集并在随后返回时系统的行为。

当节点脱离群集时，设备组将故障转移到辅助节点。当发生故障的节点重新加入群集时，设备组可继续由辅助节点控制，也可以故障恢复到原始主节点。

如果 failback 为 enabled，则设备组将变为由原始主节点控制。如果 failback 为 disabled，则设备组将继续由辅助节点控制。

failback 默认为 disabled。

[numsecondaries=integer ]

使您可以根据需要动态更改设备组的辅助节点数。设备组是一种 HA 服务，它要求一个节点充当主节点，一个或多个节点充当辅助节点。如果当前主节点发生故障，设备组的辅助节点能够接管并充当主节点。

该整数值应大于 0，但小于指定组中的节点总数。默认值为 1。

系统管理员可以使用 numsecondaries 子选项来更改设备组的辅助节点数，同时保持指定的可用性级别。如果设备组中的某个节点已从辅助节点列表中删除，则将它重新转换为辅助节点之前，它无法接管并充当主节点。更改辅助节点数之前，需要评估此操作对辅助全局文件系统的影响。

numsecondaries 子选项只应用于设备组中当前处于群集模式的节点，并可与节点的 preferenced 子选项一起使用。如果启用了设备的 preferenced 子选项，则首先会从辅助节点列表中删除优先级最低的节点。如果设备组中没有任何节点标记为首选的，群集会随机选择节点进行删除。

如果由于节点故障，设备组的实际辅助节点数减少到所需级别以下，则会将以前从辅助节点列表中删除的节点添加回辅助节点列表，前提是这些节点当前位于群集中，属于该设备组，并且当前不是主节点或辅助节点。最先会转换设备组中优先级最高的节点，一直转换到与所需辅助节点数相符。

如果设备组中某个节点的优先级高于现有辅助节点，并加入了群集，那么，优先级最低的节点将从辅助节点列表中删除，并由新添加的节点取代。仅当实际辅助节点数超过所需级别时，才会发生这种取代。

要将所需辅助节点数设置为系统默认值（您不必知道该默认值），请发出下列命令之一：

# scconf -aD type=svm,name=foo, \
nodelist=node1:node2,numsecondaries=

或

# scconf -cD name=foo,numsecondaries=

在创建设备组时，numsecondaries 子选项只能与 –a 选项一起使用。要向现有设备组添加主机，不能将 numsecondaries 子选项与 –a 选项一起使用。

[preferenced={true | false}]

指示设备组潜在主节点的优先顺序状态。只要 preferenced 子选项未设置为 false，新建设备组的节点列表就会按照节点尝试作为设备组主节点进行接管时遵循的顺序来指明优先顺序。

如果将 preferenced 子选项设置为 true，则还必须使用 nodelist 子选项指定整个节点列表。

如果 preferenced 子选项没有与用于创建设备组的 add 一起指定，则它在默认情况下设置为 false。但是，如果 preferenced 子选项没有与 change 一起指定，则在指定了 nodelist 时它在默认情况下设置为 true。

preferenced 子选项不能与用于向已建立的设备组添加节点的 add 格式一起使用。在此情况下，将使用已建立的节点优先级列表设置。

[other_options]

可以将其他与设备组类型相关的选项与命令的 add 或 change 格式一起使用。有关更多信息，请参阅相应的手册页（例如 scconf_dg_svm(1M) 和 scconf_dg_rawdisk(1M)）。

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.device.modify RBAC 授权。请参见 rbac(5)。

–h node_options

在群集配置数据库中添加或删除一个节点。与 scconf 的 add 格式一起使用时，将在群集配置数据库中添加新名称以及内部生成的节点 ID。此外，将为新节点分配一个磁盘预留键，以及一个值为零的法定选票计数。为通过群集互连访问节点而分配的名称将初始化为 clusternodenodeid-priv。请参见 –p 选项，以了解有关显示配置元素及其关联属性的更多信息。

scconf 不能单独用来向群集添加新节点。scconf 只可用于更新配置数据库本身。scconf 不会将配置数据库复制到新节点或者在新节点上创建必要的节点标识符。要向群集添加节点，请使用 scinstall(1M)。

与 scconf 的 remove 格式一起使用时，必须先删除对节点的所有引用（包括最后一条传输电缆）、所有资源组引用以及所有设备组引用，然后才能使用 scconf 从群集配置中彻底删除该节点。

要删除的节点不能是为任何法定设备而配置的。此外，不能从三节点群集中删除某个节点，除非至少配置了一个共享的法定设备。

Oracle Solaris Cluster 文档中的系统管理过程更详细地介绍了如何删除群集节点。

每次指定 –h 选项都必须指定 node=node 子选项。对于命令的 add 格式，指定的 node 必须是节点名称。

使用以下语法为命令的 add 格式指定 –hnode_options ：

–h node=nodename

对于命令的 remove 格式，可以使用节点名称或节点 ID 指定 node。使用以下语法为命令的 remove 格式指定 –h node_options：

–h node=node

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.node.modify RBAC 授权。请参见 rbac(5)。

–m cable_options

帮助建立群集互连拓扑。该选项的作用是可以配置用于连接群集传输适配器和交换机上的各个端口的电缆。每条新电缆通常可以映射两个群集传输适配器之间的连接，或者映射某个适配器与某个传输交换机端口之间的连接。接受 –m 的该命令的每种格式使用 –m cable_options 的方式如下：

• 使用以下语法为命令的 add 格式指定 –m cable_options：

  –m endpoint=[node:]
  name[@port],
      endpoint=[node:]name[@
  port][,noenable]

• 使用以下语法为命令的 change 格式指定 –m cable_options：

  –m endpoint=[node:]
  name[@port],state=
  state

• 使用以下语法为命令的 remove 格式指定 –m cable_options：

  –m endpoint=[node:]
  name[@port]

–m 选项支持以下子选项：

endpoint=[node:] name[@port]

每次指定 –m 选项时都必须包括该选项。对于命令的 add 格式，必须指定两个 endpoint 选项。选项参数的 name 组件用于指定电缆某一个端点上的群集传输适配器或群集传输交换机的名称。如果指定了 node 组成部分，则 name 是群集传输适配器的名称。否则，name 是群集传输交换机的名称。

如果未指定 port 组件，则会尝试采用默认端口名称。适配器的默认端口始终是 0。交换机端点的默认端口名称等于电缆另一端连接的节点的节点 ID。有关 port 分配和其他要求的更多信息，请参阅群集传输适配器和群集传输交换机手册页（例如 scconf_transp_jct_etherswitch(1M)）。添加电缆之前，必须已配置电缆两个端点上的适配器和交换机（参见 –A 和 –B）。

noenable

在将电缆添加到配置时可以使用。默认情况下，当您添加一条电缆时，该电缆及其连接到的两个端口，以及这些端口所在的适配器或交换机的状态都将设置为 enable。但是，如果在添加电缆时指定了 noenable，则添加的电缆及其两个端点将处于禁用状态。端口所在的适配器或交换机的状态保持不变。

state=state

更改电缆及其连接到的两个端点的状态。启用某条电缆后，该电缆及其两个端口，以及与这两个端口关联的适配器或交换机全部都被启用。但是，如果禁用某条电缆，只会禁用该电缆及其两个端口。与这两个端口关联的适配器或交换机的状态保持不变。默认情况下，将电缆添加到配置中时，该电缆及其端点的状态始终设置为 enabled。要添加处于 disabled 状态的电缆，请在添加操作过程中使用 noenable 子选项。

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.transport.modify RBAC 授权。请参见 rbac(5)。

–P privatehostname_options

对于节点，该选项可添加或更改专用主机名。

与命令的 add (–a) 格式一起使用时，–P 选项将指定下列操作之一：

• 当指定了某个节点时，该命令将会分配指定的主机名别名，以用于通过专用群集互连或传输对指定的节点进行 IP 访问。如果未分配或者已重置主机名别名，则节点的默认专用主机名为 clusternodenodeid-priv。

• 该主机名必须未被企业中的其他任何节点使用。

  为群集配置的专用 IP 地址范围必须支持群集中使用的专用 IP 地址数目的增长。请确保专用 IP 地址范围能够支持所添加的专用 IP 地址，再分配其中某个专用 IP 地址。有关更多信息，请参见 scprivipadm(1M) 手册页。

与命令的 change (–c) 格式一起使用时，–P 选项将更改指定节点的主机名别名。

绝不应当将专用主机名存储在 hosts(4) 数据库中。一个特殊的 nsswitch 工具（请参见 nsswitch.conf(4)）可针对专用主机名执行所有主机名查找操作。

接受 –P 的该命令的每种格式使用 privatehostname_options 的方式如下：

添加：

–P node=node[,privatehostname=hostalias]

更改：

–P node=node[,privatehostname=hostalias]

删除：

-P node=node

–P 选项支持以下子选项：

node=node

提供要为其分配指定专用主机名或主机别名（通过 privatehostname 子选项提供）的节点的名称或 ID。

privatehostname=hostalias

提供用于通过专用群集互连或传输访问节点的主机别名。如果未指定 privatehostname 子选项，则将指定 node 的专用主机名重置为默认值。

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.transport.modify RBAC 授权。请参见 rbac(5)。

–q quorum_options

管理共享群集法定设备和各个群集法定属性。请特别注意与类型相关的法定设备选项的手册页（例如 scconf_quorum_dev_scsi(1M)）。

---

注意  -  使用基于控制器的复制的设备不能用作 Oracle Solaris Cluster 环境中的法定设备。如果使用 –q 选项指定了一个使用基于控制器的复制的设备，scconf 命令将返回错误。

---

命令的 add 和 remove 格式可在配置中添加和删除共享法定设备。命令的 change 格式可更改各个群集法定配置属性或状态。适用于这三种命令格式的 –q quorum_options 可用于更改群集法定配置，如下所述：

添加：

–q name=devicename,
type={scsi}

For SCSI quorum devices only:
-q autoconfig[,noop]

更改：

-q node=node,{
maintstate | reset}
–q name=devicename,{
maintstate | reset}
–q reset
-q installmode

For SCSI quorum devices only:
-q autoconfig[,noop]

删除：

–q name=devicename

如果在执行法定相关操作时 scconf 中断或发生故障，群集配置数据库中的法定配置信息可能会出现不一致。如果发生这种情况，再次运行相同的 scconf 命令或使用 reset 子选项运行该命令以重置法定信息。

–q 选项支持以下子选项：

autoconfig

与命令的 add 格式一起使用时，在双节点群集中会自动选择并分配一个法定设备。该法定设备是从可用设备中选择的。如果已配置了一个法定设备，该命令将会中止。

与命令的 change 格式一起使用时，在双节点群集中会自动选择并分配一个设备，用于取代所有现有法定设备。该法定设备是从可用设备中选择的。

群集中的所有可用设备都必须符合成为法定设备的条件。autoconfig 子选项不会评估某个可用设备是否符合成为法定设备的条件。

如果群集包含两个以上的节点，autoconfig 子选项将不会更改法定配置。如果计划将某个 NAS 设备配置为法定设备，请不要使用 autoconfig 子选项。

installmode

强制群集返回到安装模式。在 installmode 下，节点在引导时不会尝试重置其法定配置。并且，在这种模式下，很多管理功能都被阻止。首次安装一个群集后，它是以 installmode 进行设置的。当所有节点首次加入该群集，并且共享法定设备已添加到配置中后，请发出 scconf -c -q reset 以将选票计数重置为默认值，并清除 installmode 设置。

name=devicename

指定在群集中添加或删除共享法定设备时要使用的已连接共享存储设备的名称。该子选项还可以与命令的 change 格式一起使用来更改法定设备的状态。

每个法定设备必须至少与群集中的两个节点建立网络连接或端口连接。不可以将非共享磁盘用作法定设备。

将 scconf 的 change 格式与 –qname 一起使用可以将设备置于维护状态，或者将设备的法定配置重置为默认值。在维护状态下，设备的选票计数为零，因此，不参与法定构成。重置为默认值后，设备的选票计数更改为 N-1，其中 N 是可与设备建立端口连接的、选票计数非零的节点的数目。

node=node

与命令的 add 格式一起使用时，选择要配置的应与所添加的共享法定设备建立端口连接的节点。该子选项还可以与命令的 change 格式一起使用来更改节点的法定状态。

将 node 子选项与法定更新命令的 change 格式一起使用时，该子选项用于将节点置于维护状态或者将节点的法定配置重置为默认值。

将节点置于维护状态之前，必须先关闭该节点。如果尝试将某个群集成员置于维护状态，scconf 将返回错误。

在维护状态下，节点的选票计数为零，因此，不参与法定构成。此外，配置为与节点建立端口连接的任何共享法定设备的选票计数将会减 1，以反映节点的新状态。节点重置为默认值后，其选票计数将重置为 1，而共享法定设备的选票计数将重新往上调整。除非群集处于 installmode 模式，否则，在引导时将自动重置每个节点的法定配置。

可以使用节点名称或节点 ID 指定 node。

type=type

与命令的 add 格式一起使用时，指定要创建的法定设备的类型。

scsi

指定共享磁盘法定设备。有关特定于 SCSI 类型的选项，请参见 scconf_quorum_dev_scsi(1M)。

{maintstate}

当与命令的 change 格式一起使用并用作 globaldev 或 node 子选项的标志时，可将共享的法定设备或节点置于法定维护状态。在维护状态下，共享的设备或节点不再参与法定构成。当您需要长时间关闭某个节点或设备以进行维护时，此功能十分有用。当某个节点重新引导回群集后，在正常情况下，该节点会从维护模式中自行删除。

随同一 –q 选项同时指定 maintstate 和 reset 是非法的。

[,noop]

与 autoconfig 子选项一起使用时有效。该命令在标准输出中显示将由 autoconfig 子选项添加或更改的法定设备的列表。autoconfig,noop 子选项不会更改法定配置。

{reset}

当随命令的 change 格式用作一个标志时，可重置共享法定设备或共享节点的已配置法定选票。该选项可以与 globaldev 或 node 子选项结合使用，也可以作为自身的子选项。

如果单独使用，则会将整个法定配置重置为默认的选票设置。此外，如果设置了 installmode，则会通过全局法定配置重置来将其清除。除非已成功配置了至少一个共享法定设备，否则无法在双节点群集上重置 installmode。

otheroptions

可以使用其他特定于法定设备类型的选项。有关详细信息，请参见 scconf_quorum_dev_scsi(1M)。

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.quorum.modify RBAC 授权。请参见 rbac(5)。

–S slm_options

与 sconf 命令的 change 格式一起使用时，可设置属性以配置系统资源控制。如果未向这些属性分配值，这些属性将自动设置为默认值。

–S 选项的语法为：

–S [node=node] \
[,globalzoneshares=integer] \
[,defaultpsetmin=integer]

–S 选项支持以下子选项：

globalzoneshares=globalzoneshares

设置分配给全局区域的份额数。globalzoneshares 的下限为 1，上限为 65,535。要了解该上限，请参见 prctl(1) 手册页中有关 zone.cpu-shares 属性的信息。globalzoneshares 的默认值为 1。在正在运行的群集上，如果不再存在任何使用全局区域中配置的 CPU 控制的联机资源组，则分配给全局区域的 CPU 份额数将设置为 globalzoneshares 的值。

defaultpsetmin=defaultpsetmin

设置默认处理器集中可用的最小 CPU 数。默认值为 1。defaultpsetmin 的最小值为 1。Oracle Solaris Cluster 将在可用 CPU 数的限值内分配 CPU 数目，该数目尽可能地接近您为 defaultpsetmin 设置的数目。如果分配的数目小于您请求的数目，Oracle Solaris Cluster 将定期尝试分配您请求的 CPU 数目。此操作可能会销毁某些 dedicated_weak 处理器集。有关 dedicated_weak 处理器集的信息，请参见 scrgadm(1M) 手册页。

node=node

标识要设置其属性的节点。通过指定节点的名称，在您希望从 CPU 控制受益的每个节点上设置这些属性。每次使用 –S 选项时，只能指定一个节点。

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

–T authentication_options

为尝试将自身添加到群集配置的节点建立验证策略。具体而言，就是当某台计算机请求将自身作为群集节点添加到群集中时（参见 scinstall(1M)），执行检查以确定该节点是否有权加入。如果该节点具有权限，将对该正在加入的节点进行验证。默认情况下，允许任何计算机将自身加入群集。

接受 –T 的三种命令格式使用 –Tauthentication_options 的方式如下：

添加：

–T node=nodename[,...][,authtype=
authtype]

更改：

–T authtype=authtype

删除：

–T {node=nodename[,...] | all}

–T 选项支持以下子选项：

all

可以通过指定 scconf -r -T all 来清除包含所有节点名称的列表。清除验证列表意味着任何节点都可以在群集中安装和配置自身。

node=nodename

在可以将自身安装和配置为群集中节点的节点列表中添加或删除主机名。命令的 add 格式至少需要一个 node 子选项，该子选项对于 remove 格式是可选的。如果验证列表为空，任何主机都可以请求将自身添加到群集配置。但是，如果列表至少包含一个名称，将会使用验证列表验证所有这种请求。

可接受非法的 nodename，包括以点 (.) 表示的节点名称。如果将以 . 表示的 nodename 添加到验证列表，则点字符是一个特殊字符，其他所有名称将被删除。此功能可阻止主机尝试在群集中安装和配置自身。

authtype=authtype

与命令的 add 或 change 格式一起使用。

当前支持的验证类型 (authtype) 只有 des 和 sys（或 unix）。默认的验证类型为提供最少的安全验证的 sys。

如果使用 des（或 Diffie-Hellman）验证，则应该在实际运行 scinstall 命令添加节点之前，将要添加的每个群集节点的条目添加到 publickey 数据库中。

要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.node.modify RBAC 授权。请参见 rbac(5)。

–v

与 –p 选项一起使用时，可请求更详细的群集配置列表。如果与其他选项一起使用，在遇到错误时可能会显示更多信息。

要将该命令选项与 –p 一起使用，需要具有 solaris.cluster.device.read、solaris.cluster.transport.read、solaris.cluster.resource.read、solaris.cluster.node.read、solaris.cluster.quorum.read 和 solaris.cluster.system.read RBAC 授权。请参见 rbac(5)。

–w heartbeat_options

更改某个群集的全局心跳参数，这可以有效地更改群集的所有适配器的心跳参数。

Oracle Solaris Cluster 依赖经由专用互连的心跳来检测群集节点之间的通信故障。减小心跳超时可使 Oracle Solaris Cluster 更快地检测故障，因为减小心跳超时后，检测故障所需的时间更少。这样，Oracle Solaris Cluster 在发生故障后可以更快地恢复，从而提高群集可用性。

–w 选项支持以下子选项：

heartbeat_quantum=quantum_milliseconds

定义发送心跳的频率。默认情况下，Oracle Solaris Cluster 使用 1 秒（1,000 毫秒）心跳量程。指定一个介于 100 和 10,000 毫秒之间的值。

heartbeat_timeout=timeout_milliseconds

一个时间间隔，经过该时间间隔后，如果未从对等节点收到心跳，则将相应的路径声明为已关闭。默认情况下，Oracle Solaris Cluster 使用 10 秒（10,000 毫秒）心跳超时。指定一个介于 2,500 和 60,000 毫秒之间的值。

---

注 -  如果使用 –w 减小心跳参数值，则即使在理想的条件下，也总是会存在路径虚假超时风险并且可能会发生节点紧急情况。始终测试并全面将心跳参数的较低值限定在相关工作负载条件之下后，才能在群集中真正实施这些值。

---

用法

使用 –w 选项，一次只能更改一个心跳子选项。减小心跳参数的值时，请先更改 heartbeat_quantum，然后更改 heartbeat_timeout。增大心跳参数的值时，请先更改 heartbeat_timeout，然后更改 heartbeat_quantum。

您需要具有 solaris.cluster.system.modify RBAC 授权才能使用 –w。请参见 rbac(5)。

示例

示例 1 减小心跳

以下示例说明了如何将心跳量程从 Oracle Solaris Cluster 默认值 1,000 毫秒减小为 100 毫秒。该示例还说明了如何将心跳超时从 Oracle Solaris Cluster 默认值 10,000 毫秒减小为 2,500 毫秒。

phys-schost-1# scconf -c -w heartbeat_quantum=100
phys-schost-1# scconf -c -w heartbeat_timeout=2500

由于 heartbeat_timeout 必须总是大于或等于 heartbeat_quantum 的五倍，因此首先需要设置 heartbeat_quantum。否则将不符合要求。换言之，如果 heartbeat_quantum 当前设置为默认值 1,000 毫秒，而您将 heartbeat_timeout 设置成了 2,500 毫秒，那么，heartbeat_timeout 就小于 heartbeat_quantum 的五倍。scconf 命令因此将会失败。

但是，将 heartbeat_quantum 设置为适当的值后，如果要求尚未满足，还可以将 heartbeat_timeout 设置为更小的值。

示例 2 增大心跳

以下示例说明了如何将心跳超时和心跳量程参数从您在前一示例中设置的值增大到 Oracle Solaris Cluster 默认值。

phys-schost-1# scconf -c -w heartbeat_timeout=10000
phys-schost-1# scconf -c -w heartbeat_quantum=1000

先设置 heartbeat_timeout，以满足 heartbeat_timeout 总是大于或等于 heartbeat_quantum 的五倍这一要求。将 heartbeat_timeout 设置为所需值后，可以将 heartbeat_quantum 设置为更大的新值。

示例 3 典型的安装后设置操作

下列命令提供了您可能会在新的双节点群集上执行的一组典型的安装后设置操作示例。这些命令将会向群集添加一个共享法定设备，清除 installmode，配置另一组群集传输连接，并阻止其他计算机尝试将自身添加到该群集：

phys-red# scconf -a -q globaldev=d0
phys-red# scconf -c -q reset
phys-red# scconf -a \ 
    -A trtype=dlpi,name=hme1,node=phys-red \ 
    -A trtype=dlpi,name=hme1,node=phys-green \ 
    -m endpoint=phys-red:hme1,endpoint=phys-green:hme1
phys-red# scconf -a -T node=.

退出状态

返回以下退出值：

0

命令已成功完成。

非零值

发生错误。

属性

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

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

另请参见

Intro(1CL)、cldevice(1CL)、scconf_dg_rawdisk(1M)、scconf_dg_svm(1M)、scconf_quorum_dev_scsi(1M)、scconf_transp_adap_e1000g(1M)、scconf_transp_jct_etherswitch(1M)、scconf_transp_jct_ibswitch(1M)、scdidadm(1M)、scprivipadm(1M)、hosts(4)、nsswitch.conf(4)、publickey(4)、attributes(5)、sctransp_dlpi(7p)

警告

仅当群集中的所有节点均在运行时才使用 –w 选项。如果群集中有任一节点关闭，请不要使用 –w。否则，节点可能会挂起或发生紧急情况。

包含一个或多个单 CPU 节点或者包含八个以上节点的群集如果以较小的心跳参数值运行，将更有可能会遇到超时和节点紧急情况。

附注

使用 scconf 更改配置后，应该备份每个节点上的根文件系统，或者保留所有更改的日志。如果需要恢复在正常系统备份之间的配置更改，可以使用日志来返回到最近的配置。

随 scconf 命令指定的选项列表始终按照您在命令行上指定它们的顺序执行。但是，只要可能，scconf 就会根据群集配置数据库将某些传输选项（–A、–B 和 –m）作为单个事务进行处理。请尽量在单个命令行上将此类型的所有相关选项组合在一起，以减少群集的开销。