Oracle® Solaris Cluster 参考手册

退出打印视图

更新时间: 2014 年 7 月,E51743-01
 
 

cldevicegroup (1CL)

名称

cldevicegroup, cldg - 管理 Oracle Solaris Cluster 设备组

用法概要

/usr/cluster/bin/cldevicegroup -V
/usr/cluster/bin/cldevicegroup [subcommand] -?
/usr/cluster/bin/cldevicegroup subcommand [options] -v 
     [devicegroup …]
/usr/cluster/bin/cldevicegroup add-device -d device
     [,…] devicegroup
/usr/cluster/bin/cldevicegroup add-node -n node[,…] [-t 
     devicegroup-type[,…]] {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup create -n node[,…] -t 
     devicegroup-type [-d device[,…]] [-p name=value] 
     devicegroup ...
/usr/cluster/bin/cldevicegroup create -i {- | clconfigfile} [-d 
     device[,…]] [-n node[,…]] [-p name=value] [-t 
     devicegroup-type[,…]] {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup delete [-t devicegroup-type[,…]] 
     {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup disable [-t devicegroup-type[,…]] 
     {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup enable [-t devicegroup-type[,…]] 
     {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup export [-n node[,…]] [-o 
     {- | clconfigfile}] [-t devicegroup-type[,…]] 
     {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup list [-n node[,…]] [-t 
     devicegroup-type[,…]] [+ | devicegroup ...]
/usr/cluster/bin/cldevicegroup offline [-t devicegroup-type[,…]] 
     {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup online [-e] [-n node] [-t 
     devicegroup-type[,…]] {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup remove-device -d device
     [,…] devicegroup
/usr/cluster/bin/cldevicegroup remove-node -n node[,…] 
     [-t devicegroup-type[,…]] {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup set -p name=value [-p name=value]… 
     [-d device[,…]] [-n node[,…]] [-t devicegroup-type[,…]] 
     {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup show [-n node[,…]] [-t 
     devicegroup-type[,…]] [+ | devicegroup ...]
/usr/cluster/bin/cldevicegroup status [-n node[,…]] [-t 
     devicegroup-type[,…]] [+ | devicegroup ...]
/usr/cluster/bin/cldevicegroup switch -n node [-t 
     devicegroup-type[,…]] {+ | devicegroup ...}
/usr/cluster/bin/cldevicegroup sync [-t devicegroup-type[,…]] 
     {+ | devicegroup ...}

描述

cldevicegroup 命令管理 Oracle Solaris Cluster 设备组。cldg 命令是 cldevicegroup 命令的简短格式。这两个命令是相同的。您可以使用此命令的任一种格式。

此命令的一般格式如下所示:

cldevicegroup [subcommand] [options] [operands]

仅当 options 指定 –? 选项或 –V 选项时,才可以省略 subcommand

此命令的每个选项都有长格式和简短格式两种格式。在本手册页的“选项”部分给出了每个选项的两种格式,以及对该选项的描述。

除了 listshowstatus 以外,大多数子命令都需要至少一个操作数。许多子命令接受使用加号 (+) 作为操作数来表示 all 适用对象。有关详细信息,请参阅该手册页的“用法概要”和其他部分。

除以下子命令之外,每个子命令都可以用于所有设备组类型:

  • add-deviceremove-device 子命令只对 rawdisk 类型有效。

  • add-nodecreatedeleteremove-node 子命令仅对 rawdisk 类型有效。

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

子命令

支持以下子命令:

add-device

向现有原始磁盘设备组中添加新的成员磁盘设备。

对于现有的 rawdisk 类型的设备组,您只能使用 add-device 子命令。有关设备组类型的更多信息,请参见 – t 选项的描述。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何从原始磁盘设备组中删除磁盘设备的信息,请参见 remove-device 子命令的描述。

add-node

向现有设备组中添加新节点。

该子命令仅支持 rawdisk 设备组类型。无法使用 Oracle Solaris Cluster 命令向 svmsds 设备组添加节点。而应改用 Solaris Volume Manager 命令向 Solaris Volume Manager 磁盘集添加节点。磁盘集会自动在 Oracle Solaris Cluster 软件中注册为 svmsds 设备组。有关设备组类型的更多信息,请参见 – t 选项的描述。

如果某个设备组的 preferenced 属性设置为 true,则无法对该设备组使用该子命令。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何从设备组中删除节点的信息,请参见 remove-node 子命令的描述。

create

创建新设备组。

该子命令仅支持 rawdisk 设备组类型。无法使用 Oracle Solaris Cluster 命令创建 svm sds 设备组。而应改用 Solaris Volume Manager 命令创建 Solaris Volume Manager 磁盘集。磁盘集会自动在 Oracle Solaris Cluster 软件中注册为 svmsds 设备组。有关设备组类型的更多信息,请参见 – t 选项的描述。

如果使用 –i 选项指定配置文件,则可以提供加号 (+) 作为操作数。使用此操作数时,该命令会创建配置文件中指定的、且尚不存在的所有设备组。

对于 rawdisk 类型的设备组,结合使用 –d 选项和 create 子命令可以为此类设备组指定一个或多个设备。指定设备时,每个命令调用使用一个 –d 选项。无法使用一个命令调用创建多个原始磁盘设备组,除非使用 –i 选项。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何删除设备组的信息,请参见 delete 子命令的描述。

delete

删除设备组。

该子命令仅支持 rawdisk 设备组类型。

无法使用 Oracle Solaris Cluster 命令删除 svmsds 设备组。要删除 svmsds 设备组,请使用 Solaris Volume Manager 命令删除底层 Solaris Volume Manager 磁盘集。

删除设备组之前,设备组必须处于脱机状态。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何创建设备组的信息,请参见 create 子命令的描述。

disable

禁用脱机设备组。

重新引导后,设备组的禁用状态不变。

要禁用联机设备组,必须首先使用 offline 子命令将设备组脱机。

如果某个设备组当前处于联机状态,则 disable 操作将失败,且不会禁用指定的设备组。

无法使用 switchonline 子命令使禁用的设备组联机。必须首先使用 enable 子命令清除该设备组的禁用状态。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何启用设备组的信息,请参见 enable 子命令的描述。

enable

启用设备组。

重新引导后,设备组的禁用状态不变。

要使禁用的设备组联机,必须首先使用 enable 子命令清除设备组的禁用状态。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何禁用设备组的信息,请参见 disable 子命令的描述。

export

导出设备组的配置信息。

如果使用 –o 选项指定一个文件名,则会将配置信息写入该新文件。如果未提供 –o 选项,则会将输出写入标准输出。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

list

显示设备组列表。

默认情况下,该子命令会列出 autogen 属性设置为 false 的群集中的所有设备组。要显示群集中的所有设备组,还需要指定 –v 选项。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

offline

使设备组脱机。

如果设备组处于联机状态,必须先运行 offline 子命令将其脱机,然后再运行 disable 子命令。

要启动脱机设备组,可以执行以下任一操作:

  • 发出显式 online 子命令或 switch 子命令。

  • 访问该设备组中的某个设备。

  • 挂载一个依赖于该设备组的文件系统。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

有关如何使设备组联机的信息,请参见 online 子命令的描述。

online

使设备组在预先指定的节点上联机。

如果设备组处于禁用状态,则必须使用以下方式之一将其启用,然后才能使它联机:

  • 结合使用 –e 选项和 online 子命令。

  • 运行 enable 子命令,然后再运行 online 子命令。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

有关如何使设备组脱机的信息,请参见 offline 子命令的描述。

remove-device

从原始磁盘设备组中删除成员磁盘设备。

remove-device 子命令只对 rawdisk 类型的设备组有效。该子命令对 svmsds 设备组类型无效。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何向原始磁盘设备组中添加磁盘设备的信息,请参见 add-device 子命令的描述。

remove-node

从现有设备组中删除节点。

该子命令仅支持 rawdisk 设备组类型。无法使用 Oracle Solaris Cluster 命令从 svmsds 设备组中删除节点。而应改用 Solaris Volume Manager 命令从 Solaris Volume Manager 磁盘集中删除节点。磁盘集会自动在 Oracle Solaris Cluster 软件中注册为 svmsds 设备组。有关设备组类型的更多信息,请参见 – t 选项的描述。

如果设备组的 preferenced 属性设置为 true,则无法对其使用 remove-node 子命令。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关如何向设备组中添加节点的信息,请参见 add-node 子命令的描述。

set

修改与设备组关联的属性。

对于 rawdisk 类型的设备组,结合使用 –d 选项和 set 子命令可以为指定的设备组指定一个新的成员磁盘设备列表。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

show

生成设备组配置报告。

默认情况下,该子命令会报告 autogen 属性设置为 false 的群集中的所有设备组。要显示群集中的所有设备组,还需要指定 –v 选项。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

status

生成设备组状态报告。

默认情况下,该子命令会报告 autogen 属性设置为 false 的群集中的所有设备组。要显示群集中的所有设备组,还需要指定 –v 选项。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

switch

将设备组从 Oracle Solaris Cluster 配置中的一个主节点转移到另一个节点。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

sync

使用群集软件同步设备组信息。

每当更改任何卷属性(例如所有者、组或访问权限)时,请使用此子命令。

还可以使用 sync 子命令将设备组配置更改为复制的或非复制的配置。

创建 Solaris Volume Manager 磁盘集之后,如果其中包含为复制而配置的磁盘,则必须为相应的 svmsds 设备组运行 sync 子命令。Solaris Volume Manager 磁盘集会自动在 Oracle Solaris Cluster 软件中注册为 svmsds 设备组,但在此期间不会同步复制信息。

对于新创建的 rawdisk 设备组类型,无需手动同步磁盘的复制信息。向 Oracle Solaris Cluster 软件注册原始磁盘设备组时,软件会自动搜索磁盘的任何复制信息。

如果指定 + 操作数,则只会影响将 autogen 属性设置为 false 的设备组。为了对在引导时系统自动创建的设备组(已将 autogen 属性设置为 true)应用命令,您必须明确指定每个设备组。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

选项

支持以下选项:

–?
–-help

显示帮助信息。

该选项可以单独使用,也可以和子命令结合使用。

  • 如果单独使用该选项,则显示可用子命令的列表。

  • 如果将该选项与子命令结合使用,将会显示该子命令的用法选项。

使用该选项时,不会执行任何其他处理。

–d device[,…]
–-device=device[,…]
–-device device[,…]

指定要成为指定原始磁盘设备组的成员的磁盘设备的列表。

对于 rawdisk 类型的设备组,–d 选项仅在与 createset 子命令一起使用才有效。必须始终提供整个节点列表。无法使用此选项向成员磁盘列表中添加、或从中删除单个磁盘。

只能以 DID 全局设备名称指定磁盘,例如 d3。有关更多信息,请参见 did(7) 手册页。

–e
–-enable

启用设备组。此选项只有和 online 子命令结合使用时才有效。

如果指定的设备组已经启用,则 –e 选项将被忽略,命令会继续使该设备组联机。

–i {- | clconfigfile}
–-input={- | clconfigfile}
–-input {- | clconfigfile}

指定用于创建设备组的配置信息。此信息必须符合 clconfiguration(5CL) 手册页中定义的格式。此信息可包含在文件中或者通过标准输入提供。要指定标准输入,请提供减号 (-) 而不是文件名。

–i 选项只影响完全限定设备组列表中包含的设备组。

在命令中指定的选项将覆盖在配置文件中设置的任何选项。如果群集配置文件中缺少配置参数,则必须在命令行中指定这些参数。

–n node[,…]
–-node=node[,…]
–-node node[,…]

指定一个节点或一系列节点。

默认情况下,节点列表的顺序表示节点尝试作为主节点接管设备组的优先顺序。例外情况是,对于纯本地磁盘组,由于不受 Oracle Solaris Cluster 的控制,因此主节点和辅助节点的概念不适用。

如果设备组的 preferenced 属性设置为 false,则将忽略节点列表的顺序。第一个访问该设备组中设备的节点会自动成为该设备组的主节点。有关设置设备组节点列表 preferenced 属性的更多信息,请参见 –p 选项。

无法使用 –n 选项指定 svmsds 设备组的节点列表。必须使用 Solaris Volume Manager 命令或实用程序指定底层磁盘集的节点列表。

createset 子命令使用 –n 选项,以仅为 rawdisk 类型的设备组指定潜在主节点列表。必须指定设备组的整个节点列表。无法使用 –n 选项向节点列表中添加、或从中删除单个节点。

switch 子命令使用 –n 选项将单个节点指定为新的设备组主节点。

exportlistshowstatus 子命令使用 –n 选项将那些没有在指定节点上联机的设备组从输出中排除。

主节点和辅助节点的概念不适用于 localonly 磁盘组,这些磁盘组不受 Oracle Solaris Cluster 的控制。

–o {- | clconfigfile}
–-output={- | clconfigfile}
–-output {- | clconfigfile}

clconfiguration(5CL) 手册页所描述的格式显示设备组配置。可以将此信息写入文件或标准输出中。

如果将文件名作为参数提供给该选项,此命令将创建新的文件,配置会显示在该文件中。如果已经存在同名的文件,此命令将退出,并显示一个错误。不会对现有文件进行任何更改。

如果将减号 (-) 作为参数提供给该选项,命令会将配置信息显示到标准输出。命令的所有其他标准输出将受到抑制。

–o 选项仅与 export 子命令一起使用时才有效。

–p name= value
–-property=name =value
–-property name=value

设置设备组属性的值。

–p 选项仅在与 createset 子命令一起使用时才有效。允许 –pname–=value 的多个实例。

支持以下属性:

autogen

autogen 属性的值可以为 truefalse。对于手动创建的设备组,默认值为 false。对于系统创建的设备组,默认值为 true

autogen 属性是 listshowstatus 子命令的指示符。这些子命令不会列出 autogen 属性设置为 true 的设备,除非使用 –v 选项。

该属性只对 rawdisk 类型的设备组有效。有关设备组类型的更多信息,请参见 –t 选项。

failback

failback 属性的值可以为 truefalse。缺省值是 /

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

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

  • 如果 failback 属性设置为 true,则设备组将变为由原始主节点控制。

  • 如果 failback 属性设置为 false,则设备组继续由辅助节点控制。

默认情况下,failback 属性在创建设备组时处于禁用状态。failback 属性在 set 操作期间不会被更改。

localonly

localonly 属性的值可以为 truefalse。缺省值是 /

localonly 属性仅对 rawdisk 类型的磁盘组有效。

如果希望磁盘组仅由特定节点管理,则需要为磁盘组配置属性设置 localonly=true。纯本地磁盘组不受 Oracle Solaris Cluster 软件的控制。在纯本地磁盘组的节点列表中只能指定一个节点。如果将某个磁盘组的 localonly 属性设置为 true,则该磁盘组的节点列表必须只包含一个节点。

numsecondaries

numsecondaries 属性必须有一个大于 0 但小于节点列表中节点总数的整数值。默认值为 1

此属性设置可用于动态更改所需的设备组辅助节点数。如果当前主节点发生故障,设备组的辅助节点可以作为主节点进行接管。

可以使用 numsecondaries 属性在保持指定可用性级别的情况下更改设备组的辅助节点数。如果从设备组的辅助节点列表中删除了某个节点,则该节点将无法再作为主节点进行接管。

numsecondaries 属性仅适用于设备组中当前处于群集模式的节点。节点还必须能够与设备组的 preferenced 属性一起使用。如果设备组的 preferenced 属性设置为 true,则首先会从辅助节点列表中删除优先级最低的节点。如果设备组中没有任何节点标记为首选的,群集会随机选择节点进行删除。

当设备组的实际辅助节点数低于所需的级别时,会将从辅助节点列表中删除的符合条件的节点逐个添加回列表。每个节点必须满足以下所有条件,才有资格添加回辅助节点列表:

  • 节点当前位于群集中。

  • 节点属于设备组。

  • 节点当前不是主节点或辅助节点。

转换从设备组中优先级最高的节点开始。多个节点将按照优先顺序进行转换,直到符合所需的辅助节点数。

如果某个节点加入了群集,并且比设备组中现有辅助节点的优先级要高,则优先级较低的节点将从辅助节点列表中删除。新添加的节点会替代删除的节点。只有当群集中存在的实际辅助节点多于所需级别时,才会发生此类替代。

有关设置设备组节点列表 preferenced 属性的更多信息,请参见 preferenced 属性。

preferenced

preferenced 属性的值可以为 truefalse。缺省值为 true

在创建设备组的过程中,如果 preferenced 属性设置为 true,则节点列表的顺序也表示节点的优先顺序。节点的优先顺序决定每个节点尝试作为主节点接管设备组的顺序。

在创建设备组的过程中,如果该属性设置为 false,则第一个访问设备组中设备的节点会自动成为主节点。指定的节点列表中的节点顺序没有意义。将此属性设置回 true 而不重新指定节点列表,不会重新激活节点顺序。

set 操作期间,节点的优先顺序不会更改,除非同时指定 preferenced=true 属性,并使用 –n 选项为设备组提供具有优先顺序的整个节点列表。

–t devicegroup-type[,…]
–-type=devicegroup-type[,…]
–-type devicegroup-type[,…]

指定一个设备组类型或设备组类型列表。

对于 create 子命令,只能指定一个设备组类型。随后会创建使用此选项指定的类型的设备组。

对于所有接受 –t 选项的其他子命令,此选项将您提供给命令的设备组列表限定为仅包含指定类型的设备组。

并非所有子命令和选项对所有设备组类型都有效。例如,create 子命令仅对 rawdisk 设备组类型有效,而对 svmsds 设备组类型无效。

–t 选项支持以下设备组类型:

rawdisk

指定一个原始磁盘设备组。

原始磁盘是不属于卷管理器卷或元设备的一部分的磁盘。原始磁盘设备组支持在设备组中定义一组磁盘。默认情况下,系统在引导时,会为配置中的每一个设备 ID 伪驱动程序 (DID) 设备创建一个原始磁盘设备组。根据约定,原始磁盘设备组的名称是在初始化时分配的。这些名称是由 DID 设备名称派生而来的。对于每一个添加到原始磁盘设备组的节点,cldevicegroup 命令可以验证设备组中的每个设备是否已通过端口物理连接到该节点。

create 子命令创建原始磁盘设备组,并向该设备组添加多个磁盘设备。创建新的原始磁盘设备组之前,必须从引导时为设备创建的设备组中删除要添加到新设备组的各个设备。然后可以创建一个新的包含这些设备的原始磁盘设备组。可以使用 –d 选项指定这些设备的列表,同时使用 –n 选项指定潜在主节点优先列表。

要在单个指定的节点上管理一个设备组,请使用 –p 选项为该设备组配置属性设置 localonly=true。创建纯本地设备组时,只能在节点列表中指定一个节点。

delete 子命令从群集设备组配置中删除设备组名称。

set 子命令对原始磁盘设备组进行以下更改:

  • 更改潜在主节点的优先顺序

  • 指定一个新的节点列表

  • 启用或禁用故障恢复

  • 设置所需的辅助节点数

  • 向设备组中添加更多全局设备

如果某个原始磁盘设备名称已在原始磁盘设备组中注册,则无法同时在 Solaris Volume Manager 设备组中注册该原始磁盘设备名称。

sds

指定最初使用 Solstice DiskSuite 软件创建的设备组。除多属主磁盘集以外,该设备组类型等同于 Solaris Volume Manager 设备组类型 svm。有关更多信息,请参见 svm 设备组类型的描述。

svm

指定 Solaris Volume Manager 设备组。

Solaris Volume Manager 设备组是由以下几部分定义的:

  • 名称

  • 节点,可以通过它访问设备组

  • 磁盘集中设备的全局列表

  • 一组属性,控制潜在主节点优先选择和故障恢复行为等操作

Solaris Volume Manager 有多宿主磁盘集或共享磁盘集概念。共享磁盘集由两个或多个主机和磁盘驱动器组成。这些磁盘驱动器可供所有主机访问,并且在所有主机中具有相同的设备名称。该相同设备命名的要求是通过使用原始磁盘设备构成磁盘集来实现的。设备 ID 伪驱动程序 (DID) 允许多宿主磁盘在群集中拥有一致的名称。只有已经配置为磁盘集一部分的主机才能配置到 Solaris Volume Manager 设备组节点列表中。向共享磁盘集添加驱动器时,驱动器不得属于任何其他共享磁盘集。

Solaris Volume Manager metaset 命令创建磁盘集,并自动向 Oracle Solaris Cluster 软件将该磁盘集注册为 Solaris Volume Manager 设备组。创建设备组之后,必须使用 cldevicegroup 命令的 set 子命令设置节点优先列表以及 preferencedfailbacknumsecondaries 属性。

只能为每个设备组分配一个 Solaris Volume Manager 磁盘集。设备组的名称必须始终与磁盘集的名称相匹配。

无法使用 add-noderemove-node 子命令在 Solaris Volume Manager 设备组中添加或删除节点。可以使用 Solaris Volume Manager metaset 命令在底层 Solaris Volume Manager 磁盘集中添加或删除节点。

无法使用 delete 子命令从群集配置中删除 Solaris Volume Manager 设备组。而应改用 Solaris Volume Manager metaset 命令删除底层 Solaris Volume Manager 磁盘集。

只有 exportlistshowstatussync 子命令可用于 Solaris Volume Manager 多所有者磁盘集。必须使用 Solaris Volume Manager 命令或实用程序才能创建和删除 Solaris Volume Manager 设备组的底层磁盘集。

–V
–-version

显示该命令的版本。

指定此选项时,不要将其与子命令、操作数或其他选项结合使用。子命令、操作数或其他选项将被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。

–v
–-verbose

将详细消息显示到标准输出。

可以将此选项与命令的任何格式一起使用。

操作数

支持以下操作数:

devicegroup

指定一个设备组。

cldevicegroup 命令只接受 Oracle Solaris Cluster 设备组名称作为操作数。对于大多数接受多个设备组名称的命令格式,可以使用加号 (+) 指定所有可能的设备组。


注 -  + 操作数只包括手动创建的设备组,忽略所有自动创建的、autogen 属性设置为 true 的设备组。Oracle Solaris Cluster 软件在每次系统引导时会自动创建此类设备组。要对这些“隐藏”设备组应用命令,必须明确指定每个设备组。

退出状态

Intro(1CL) 手册页列出了该命令集中所有命令的一整套退出状态代码。

如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。

此命令返回下列退出状态代码:

0 CL_NOERR

没有错误

1 CL_ENOMEM

交换空间不足

3 CL_EINVAL

参数无效

6 CL_EACCESS

权限被拒绝

35 CL_EIO

I/O 错误

36 CL_ENOENT

没有这样的对象

39 CL_EEXIST

对象已存在

示例

示例 1 修改设备组

以下示例显示了如何将设备组 devgrp1preference 属性设置为 true,并将 numsecondaries 属性设置为 2。该命令还指定所需的节点列表 phys-schost-1,phys-schost-2,phys-schost-3

# cldevicegroup set -p preferenced=true -p numsecondaries=2 \
-n phys-schost-1,phys-schost-2,phys-schost-3 devgrp1
示例 2 修改原始磁盘设备组

以下示例显示了如何修改现有的原始磁盘设备组 rawdevgrp1。该命令在新成员设备列表中指定设备 d3d4,并将 localonly 属性设置为 true。节点 phys-schost-1 是允许用于纯本地原始磁盘设备组的唯一主节点。

# cldevicegroup set -d d3,d4 \
-p localonly=true -n phys-schost-1 rawdevgrp1
示例 3 重置设备组的 numsecondaries 属性

以下示例显示了如何通过不指定任何值给设备组 devgrp1numsecondaries 属性,将其重置为相应的系统默认值。

# cldevicegroup set -p numsecondaries= devgrp1
示例 4 切换设备组

以下示例说明如何将设备组 devgrp1 切换到新的主节点 phys-schost-2

# cldevicegroup switch -n phys-schost-2 devgrp1
示例 5 禁用设备组

以下示例显示了如何禁用设备组 devgrp1

# cldevicegroup disable devgrp1
示例 6 使设备组脱机

以下示例说明如何先将设备组 devgrp1 脱机再将其禁用。

# cldevicegroup offline devgrp1
# cldevicegroup disable devgrp1
示例 7 使设备组在其主节点上联机

以下示例说明如何使设备组 devgrp1 在其默认主节点上联机。该命令首先启用设备组。

# cldevicegroup online -e devgrp1
示例 8 使设备组在指定节点上联机

以下示例说明如何使设备组 devgrp1 在作为其新主节点的 phys-schost-2 上联机。

# cldevicegroup switch -n phys-schost-2 devgrp1
示例 9 向设备组添加新节点

以下示例显示了如何向设备组 devgrp1 添加一个新节点 phys-schost--3。此设备组不属于设备组类型 svm

# cldevicegroup add-node -n phys-schost-3 devgrp1
示例 10 删除设备组

以下示例说明如何从 Oracle Solaris Cluster 配置中删除设备组 devgrp1。此设备组不属于设备组类型 svm

# cldevicegroup delete devgrp1
示例 11 将复制信息与设备组配置进行同步

以下示例显示了如何让 Oracle Solaris Cluster 软件知道设备组 devgrp1 中的磁盘所使用的复制配置。

# cldevicegroup sync devgrp1

属性

有关以下属性的描述,请参见 attributes(5)

属性类型
属性值
可用性
ha-cluster/system/core
接口稳定性
Evolving(发展中)

另请参见

Intro(1CL)cldevice(1CL)cluster(1CL)metaset(1M)clconfiguration(5CL)rbac(5)did(7)

Oracle Solaris Cluster 系统管理指南

附注

超级用户可以运行此命令的所有格式。

此外,任何用户都可以运行带有以下选项的此命令:

  • –?(帮助)选项

  • –V(版本)选项

要运行带有其他子命令的此命令,超级用户以外的用户需要具有 RBAC 授权。请参见下表。

子命令
RBAC 授权
add-device
solaris.cluster.modify
add-node
solaris.cluster.modify
create
solaris.cluster.modify
delete
solaris.cluster.modify
disable
solaris.cluster.modify
enable
solaris.cluster.modify
export
solaris.cluster.read
list
solaris.cluster.read
offline
solaris.cluster.admin
online
solaris.cluster.admin
remove-device
solaris.cluster.modify
remove-node
solaris.cluster.modify
set
solaris.cluster.modify
show
solaris.cluster.read
status
solaris.cluster.read
switch
solaris.cluster.modify
sync
solaris.cluster.admin