scha_resourcegroup_get -O optag -G group [-Z zonecluster] [args]
scha_resourcegroup_get 命令可以访问受资源组管理器 (Resource Group Manager, RGM) 群集工具控制的资源组的相关信息。
该命令设计为在资源类型的回调方法的 shell 脚本实现中使用。这些资源类型代表由群集的 RGM 控制的服务。该命令提供的信息与 scha_resourcegroup_get(3HA) C 函数提供的信息相同。
该命令会以格式化字符串将信息生成到标准输出 (stdout),如 scha_cmds(1HA) 中所述。输出内容是单个字符串,或者是位于各自的行上的多个字符串。可以将输出存储在 shell 变量中,并使用 shell 工具或 awk(1) 进行解析,以进一步供脚本使用。
要使用该命令,您需要具有 solaris.cluster.resource.read 基于角色的访问控制 (role-based access control, RBAC) 授权。请参见 rbac(5)。
您还必须能够承担已向其分配 Oracle Solaris Cluster 命令权限配置文件的角色,才能使用该命令。经授权的用户可以通过 pfsh(1)、pfcsh(1) 或 pfksh(1) 配置文件 shell 在命令行中发出授权的 Oracle Solaris Cluster 命令。配置文件 shell 是一种特殊的 shell,通过该 shell,可以访问分配给 Oracle Solaris Cluster 命令权限配置文件的 Oracle Solaris Cluster 特权命令。当您运行 su(1M) 以承担某个角色时,即会启动配置文件 shell。也可以使用 pfexec(1) 发出授权的 Oracle Solaris Cluster 命令。
支持以下选项:
资源组的名称。
指定要访问的信息。根据您指定的 optag,可能需要包括一个附加操作数以指明要检索其信息的节点或区域。
下列 optag 值将检索相应的资源组属性。将生成资源组的指定属性的值。RG_STATE 属性在执行命令的特定节点上引用该值。
ALL_LOAD_FACTORS ALL_LOAD_FACTOR_NAMES AUTO_START_ON_NEW_CLUSTER DESIRED_PRIMARIES FAILBACK GLOBAL_RESOURCES_USED IMPLICIT_NETWORK_DEPENDENCIES LOAD_FACTOR MAXIMUM_PRIMARIES NODELIST PATHPREFIX PINGPONG_INTERVAL PREEMPTION_MODE PRIORITY RESOURCE_LIST RG_AFFINITIES RG_DEPENDENCIES RG_DESCRIPTION RG_IS_FROZEN RG_MODE RG_PROJECT_NAME RG_SLM_TYPE RG_SLM_PSET_TYPE RG_SLM_CPU RG_SLM_CPU_MIN RG_STATE RG_STATE_NODE RG_SYSTEM SUSPEND_AUTOMATIC_RECOVERY TARGET_NODES
指定包含资源组并想要对其执行操作的群集。当命令是在全局区域中执行但却需要在指定区域群集上进行操作时,此选项适用。无法在某区域群集内执行该命令来访问其他区域群集。
指定在名为 zoneclustername 的区域群集中执行查询。
如果省略 –Z 选项,则将在执行命令的群集中执行查询。
要查询每区域属性(例如,全局群集中的资源组状态)的值,请不要使用 –Z 选项,而应使用查询标记的每区域格式。 例如,使用 RG_STATE_NODE 而不是 RG_STATE,并提供 nodename:zonename 格式的附加命令行参数。
向下面的脚本传递了一个 –G 参数,该参数提供所需的资源组名称。随后,使用 scha_resourcegroup_get 命令来获取资源组中的资源的列表。
#!/bin/sh while getopts G: opt do case $opt in G) group="$OPTARG";; esac done resource_list=`scha_resourcegroup_get -O Resource_list -G $group` for resource in $resource_list do printf "Group: %s contains resource: %s\n" "$group" "$resource" done示例 2 使用 scha_resourcegroup_get 命令查询资源组上的所有负载因子
使用以下命令可以查看名为 rg1 的资源组上的所有负载因子。
# scha_resourcegroup_get -O ALL_LOAD_FACTORS -G rg1 factor1=50 factor2=1 factor3=0示例 3 使用 scha_resourcegroup_get 命令列出资源组的所有已定义负载因子名称
使用以下命令可以检索名为 rg1 的资源组上的所有已定义负载因子的列表。
# scha_resourcegroup_get -O ALL_LOAD_FACTOR_NAMES -G rg1 factor1 factor2 factor3示例 4 使用 scha_resourcegroup_get 命令查询资源组的特定负载因子
使用以下命令可以查看名为 rg1 的资源组上的某个特定负载因子。
# scha_resourcegroup_get -O LOAD_FACTOR -G rg1 factor1 50示例 5 使用 scha_resourcegroup_get 命令查询资源组的优先级
使用以下命令可以查看为资源组 rg1 设置的优先级。
# scha_resourcegroup_get -O PRIORITY -G rg1 501示例 6 使用 scha_resourcegroup_get 命令查询资源组的抢占模式
使用以下命令可以查看为资源组 rg1 设置的抢占模式。
# scha_resourcegroup_get -O PREEMPTION_MODE -G rg1 Has_Cost
返回以下退出状态代码:
命令已成功完成。
发生错误。
scha_calls(3HA) 中介绍了故障错误代码。
有关下列属性的说明,请参见 attributes(5):
|
awk(1)、clnode(1CL)、scha_cmds(1HA)、scha_calls(3HA)、scha_resourcegroup_get(3HA)、attributes(5)、rg_properties(5)、rbac(5)