scrgadm -p[v[v]] [-t resource_type_name] [-g resource_group_name]
[-j resource_name]
scrgadm -a -t resource_type_name [-h RT_installed_node_list] [-f
registration_file_path]
scrgadm -a -g RG_name [-h nodelist] [-y property=value…]
scrgadm -a -j resource_name -t resource_type_name -g RG_name [-y
property=value…] [-x "extension_property[{node_specifier}]=
value…"]
scrgadm -a -L -g RG_name -l hostnamelist [-j resource_name] [-n
netiflist] [-y property=value…]
scrgadm -a -S -g RG_name -l hostnamelist [-j resource_name] [-n
netiflist] [-X auxnodelist] [-y property=value…]
scrgadm -c -t resource_type_name [-h RT_installed_node_list]
[-y RT_system={TRUE|FALSE}]
scrgadm -c -g RG_name [-h nodelist] -y property=value…
scrgadm -c -j resource_name [-y property…] [-x "
extension_property[{node_specifier}]=value…"]
scrgadm -r -t resource_type_name
scrgadm -r -g RG_name
scrgadm -r -j resource_name
资源类型指定该类型的所有资源的通用属性和回调方法。在创建特定类型的资源之前，必须先使用该命令的以下格式注册资源类型：
# scrgadm –a – t resource_type_name
资源组包含一组资源，其中的所有资源在给定的一个节点或一组节点上一起联机或脱机。先创建一个空资源组，再向其中放置任何资源。要创建资源组，请使用以下命令：
# scrgadm –a – g RG_name
有以下两种类型的资源组：故障转移资源组和可伸缩资源组。
故障转移资源组每次只能在一个节点上处于联机状态。故障转移资源组可以包含任何类型的资源，尽管在故障转移资源组中配置的可伸缩资源每次只能在一个节点上运行。
要创建名为 MyDatabaseRG 的故障转移资源组，请使用以下命令：
# scrgadm –a – g MyDatabaseRG
一个可伸缩资源组可以同时在几个节点上处于联机状态。可伸缩资源组只能包含支持伸缩性的资源，而不能包含由其资源类型定义约束为仅故障转移行为的资源。
要创建名为 MyWebServerRG 的可伸缩资源组，请使用以下命令：
# scrgadm –a – g MyWebServerRG \ –y Maximum_primaries=integer \ –y Desired_primaries=integer
新创建的资源组处于 UNMANAGED 状态。在组中创建资源后，请使用 scswitch 命令将资源组置于 MANAGED 状态。
要在资源组中创建给定类型的资源，请使用以下命令：
# scrgadm –a – j resource_name – t resource_type_name – g RG_name
创建资源可导致底层 RGM 机制执行若干操作。底层 RGM 机制在资源上调用 VALIDATE 方法以验证资源的属性设置是否有效。如果 VALIDATE 方法成功完成，且资源组已置于 MANAGED 状态，则 RGM 将通过在资源上调用 INIT 方法初始化资源。如果已启用资源且其资源组处于联机状态，随后 RGM 会使资源联机。
要删除受管理的资源组，请先从该资源组中删除所有的资源。要删除资源，请先使用 scswitch 命令禁用它。通过在资源上调用 FINI 方法删除资源可导致 RGM 在该资源之后清理。
仅可以在全局区域中使用此选项。
操作选项指定命令执行的操作。在命令行上仅允许一个操作选项。
支持以下操作选项：
添加新配置。与以下选项一起使用：
创建资源组。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
创建资源。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
添加资源类型。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
修改现有的配置。仅设置指定属性的值。其他属性保留其当前值。与以下选项一起使用：
修改资源组。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
修改资源。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
修改资源类型。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
删除配置。与以下选项一起使用：
删除资源组。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
删除资源。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
删除资源类型。
仅可以在全局区域中使用此选项。
要将该命令选项与 –a、–c 或 –r 一起使用，需要具有 solaris.cluster.resource.modify RBAC 授权。请参见 rbac(5)。
显示现有的配置信息。
仅可以在全局区域中使用此选项。 与以下选项一起使用：
显示特定的资源组配置信息。
要将该命令选项与 –p 一起使用，需要具有 solaris.cluster.resource.read RBAC 授权。请参见 rbac(5)。
显示特定的资源配置信息。
要将该命令选项与 –p 一起使用，需要具有 solaris.cluster.resource.read RBAC 授权。请参见 rbac(5)。
显示特定的资源类型配置信息。
要将该命令选项与 –p 一起使用，需要具有 solaris.cluster.resource.read RBAC 授权。请参见 rbac(5)。
显示更详细的输出。
要将该命令选项与 –p 一起使用，需要具有 solaris.cluster.resource.read RBAC 授权。请参见 rbac(5)。
如果未指定 –g、–j 或 –t 中的任一选项，则默认情况下将提供有关群集中当前配置的所有资源类型、资源组和资源的信息。
支持多个 –g、–j 和 –t 选项，可以将其与 –v 选项的任意组合结合使用。
在单个命令行上最多可以使用两个 –v 选项。
目标选项标识目标对象。支持以下目标选项：
资源组。
资源。与 –a 选项一起使用时，必须在命令中指定 –t 和 –g 目标选项，以指示要实例化的资源的类型以及包含该资源的资源组的名称。
资源类型。
支持以下选项：
对 –a 有效。指定资源类型注册 (resource type registration, RTR) 文件的路径名称。 按照约定，RTR 文件驻留在 /opt/cluster/lib/rgm/rtreg 目录下。如果 RTR 文件不在此目录中，则必须指定该选项。
对 –a 和 –c 有效。指定在其上安装此资源类型的节点名称的逗号分隔列表。此类型的资源只能在其节点列表是该列表的子集的资源组中实例化。
–h 选项对 –a 选项是可选的。如果未指定 –h，则表示已在所有节点上安装该资源类型。如果这样做，此类型的资源就可以在任何资源组中进行实例化。
与 –c 选项一起使用时，必须与新的已安装节点列表或转义通配符 (\*) 一起指定 –h。通配符指示已在所有节点上安装该资源类型。
对 –a、–c 和 –r 有效。资源类型由用来为该资源类型指定标准和扩展属性值的资源类型注册文件定义。如果将有效的资源类型注册文件放置在通常安装注册文件的已知目录 (/opt/cluster/lib/rgm/rtreg) 中，则支持简写表示法：
# scrgadm -a -t SUNW.rt:2.0
因此，不需要使用以下表示法：
# scrgadm -a -t rtn -f full_path_to_SUNW.rt:2.0
要查看当前注册的资源类型的名称，请使用以下命令：
# scrgadm –p
从 Sun Cluster 3.1 开始，资源类型名称的语法如下：
vendor_id.resource_type :version
资源类型名称的三个组成部分是在 RTR 文件中指定为 Vendor_id、Resource_type 和 RT_version 的属性。scrgadm 命令用于插入句点和冒号分界符。仅当需要区分由不同供应商提供的两个同名注册文件时，可选的 Vendor_id 前缀才是必需的。RT_version 用于从一个数据服务版本升级到另一个数据服务版本。
要确保 Vendor_id 唯一，请使用要创建资源类型的公司的股票代码。与 –t 选项一起使用的 resource_type_name 可以是完整的资源类型名称，也可以是省略了 Vendor_id 的缩写。例如，–tSUNW.iws 和 – tiws 都是有效的。如果群集中有两个仅 Vendor_id 前缀不同的资源类型名称，则使用缩写名称将发生故障。
如果 RT_version 字符串包含空白、制表符、斜杠 (/)、反斜杠 (\)、星号 (*)、问号 (?)、左方括号 ([) 或右方括号 (]) 字符，则 scrgadm 命令无法注册资源类型。
将 resource_type_name 与 –t 选项一起指定时，如果仅注册一个版本，则可以省略版本部分。
在 Sun Cluster 3.1 发行版之前创建的资源类型名称继续符合以下语法：
vendor_id.resource_type
将资源类型的 RT_system 属性设置为 TRUE 或 FALSE。RT_system 属性的默认值为 FALSE。有关 RT_system 属性的描述，请参见 rt_properties(5)。
支持以下选项：
对 –a 和 –c 有效。此选项是 –y Nodelist= nodelist 的快捷方式。
对 –a 和 –c 有效。允许使用多个 –y property= value 实例。value 的格式由每个 property 指定。在以下示例中，property1 采用单个字符串作为 value，而 property2 采用逗号分隔的字符串数组：
–y property1= value1 –y property2=value2a,value2b
要将字符串属性设置为空值，请使用此选项而不指定值，如下所示：
–y property=
识别 –y 属性名称时不区分大小写。
有关资源组属性的描述，请参见 rg_properties(5)。
支持以下选项：
对 –a 和 –c 有效。允许使用多个 –xextension_property= value 或 –x “extension_property{ node_specifier}=value” 实例。
node_specifier 是可选限定符，它指示仅在指定的一个或多个节点上设置或更改 extension_property 的值。在群集中的其他节点上，不会设置或更改指定属性的值。如果不包括 node_specifier，则在群集中的所有节点上设置或更改指定属性的值。node_specifier 的语法示例如下：
-x "myprop{phys-schost-1}=100"
使用大括号 ({ }) 指示要在其上设置属性的一个或多个特定节点。
还可以使用以下的 node_specifier 语法同时在两个不同的节点上指定不同的值：
-x "myprop{phys-schost-1}=100" -x "myprop{phys-schost-2}=10"
或者，可以使用以下语法同时在两个不同的节点上设置或更改一个值：
-x "myprop{phys-schost-1,phys-schost-2}=100"
value 的格式由每个 extension_property 指定。在以下示例中，extension_property1 采用单个字符串作为 value，而 extension_property2 采用逗号分隔的字符串：
–x "extension_property1{
node_specifier}=value1" \
–x "extension_property2{
node_specifier}=value2a,
value2b"
有关可用于特定数据服务的扩展属性的信息，请参阅该数据服务的手册页。
对 –a 和 –c 有效。允许使用多个 –y property= value 实例。value 的格式由每个 property 指定。在以下示例中，property1 采用单个字符串作为 value，而 property2 采用逗号分隔的字符串数组：
–y property1= value1 –y property2=value2a,value2b
要将属性设置为空值，请使用此选项而不指定值，如下所示：
–y property=
识别 –yproperty 名称时不区分大小写。
有关资源属性的描述，请参见 r_properties(5) 手册页。
这些选项适用于逻辑主机名资源。没有用于删除 LogicalHostname 资源的特殊命令：
# scrgadm –r – j resource_name
resource_name 是在创建 LogicalHostname 资源时通过可选的 –j 选项提供的名称。如果在创建 LogicalHostname 资源时省略了 –j 选项和 resource_name，则该名称由 scrgadm 生成。
支持以下选项：
使用 IP 地址而不是主机名作为 –l hostnamelist 选项的第一个参数时，–j 选项是必需的。
在创建资源时将 –j 与 –a 一起使用可显式命名 LogicalHostname 资源，与 –r 一起使用可从资源组中删除资源。如果未使用 –j 选项显式命名 resource，则 scrgadm 命令将创建资源并将 hostnamelist 中的第一个主机名分配给该资源。
指示在命令行上使用的选项适用于逻辑主机名。如果发出该命令时任一群集节点不是活动群集的成员，则还必须使用 –n netiflist 选项。
指定要共享的 IPv4 或 IPv6 地址。即使可以指定 IP 地址，也要使用主机名。hostnamelist 是要通过此 LogicalHostname 资源使其变为可用的主机名的列表（以逗号分隔）。
指定网络接口的列表。如果在任一群集节点不是活动群集成员时发出命令，则 –L 选项需要 –n 选项。
netiflist 采用以下格式：
netif@node[,…]
netif 可以作为网络适配器名称（如 le0）或作为 IP 网络多路径组名称（如 sc_ipmp）提供。node 可以是节点名称或节点标识符。资源组的 nodelist 中的所有节点都必须列在 netiflist 中。如果省略了 –n netiflist，则将对 nodelist 中的每个节点进行尝试以发现通过 hostnamelist 标识的子网上的网络适配器。对于尚未在 IP 网络多路径组中的已发现网络适配器，会创建单适配器 IP 网络多路径组。同样，对于指定的适配器，会创建单适配器 IP 网络多路径组（如果该组尚不存在）。
有关更多信息，请参阅 附注 部分。
有关详细信息，请参阅“资源特定的选项”部分。
LogicalHostname 特定的所有选项也适用于 SharedAddress 资源，但更改和添加了以下内容：
指示在命令行上使用的选项适用于共享地址。
指定节点名称或标识符的逗号分隔列表。此列表上的条目必须是群集的成员。这些节点是可能托管指定的共享地址但在发生故障转移时从未充当主节点的节点。
此列表与 nodelist 互斥。请参见“资源组特定的选项”下 nodelist 的描述。
返回以下退出值：
命令已成功完成。
可能会向标准错误写入警告消息，即使此命令已成功完成也是如此。
发生错误。
当它以非零状态退出时，将向标准错误写入错误消息。
不允许对 RT_System 属性为 TRUE 的资源类型执行某些操作。同样，不允许对 RG_System 属性为 TRUE 的资源组（及其资源）执行某些操作。请参见 rt_properties(5) 和 rg_properties(5)。
有关下列属性的说明，请参见 attributes(5)：
|
Intro(1CL), clreslogicalhostname(1CL ), clresource(1CL), clresourcegroup(1CL), clresourcetype(1CL), clressharedaddress(1CL), ifconfig(1M), scstat(1M), scswitch(1M), r_properties(5), rbac(5), rg_properties(5), rt_properties(5)
在 LogicalHostname 和 SharedAddress 添加操作执行过程中，无法发现尚未配置为可用的网络适配器或将其放置到 IP 网络多路径组中。请参见 ifconfig(1M)。
如果 scrgadm 以非零状态退出并显示错误消息 cluster is reconfiguring，则说明尽管出现错误状态，但请求的操作可能已成功完成。如果对结果有疑问，则可以在重新配置完成后使用相同的参数再次执行 scrgadm。