Oracle® Solaris Cluster 参考手册

退出打印视图

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

scha_resourcegroup_get (1HA)

名称

scha_resourcegroup_get - 访问资源组信息

用法概要

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 命令。

选项

支持以下选项:

–G group

资源组的名称。

–O optag

指定要访问的信息。根据您指定的 optag,可能需要包括一个附加操作数以指明要检索其信息的节点或区域。


注 -  optag 值(例如 DESIRED_PRIMARIES FAILBACK区分大小写。指定 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
–Z zoneclustername

指定包含资源组并想要对其执行操作的群集。当命令是在全局区域中执行但却需要在指定区域群集上进行操作时,此选项适用。无法在某区域群集内执行该命令来访问其他区域群集。

zoneclustername

指定在名为 zoneclustername 的区域群集中执行查询。

如果省略 –Z 选项,则将在执行命令的群集中执行查询。

要查询每区域属性(例如,全局群集中的资源组状态)的值,请不要使用 –Z 选项,而应使用查询标记的每区域格式。 例如,使用 RG_STATE_NODE 而不是 RG_STATE,并提供 nodename:zonename 格式的附加命令行参数。


注 -  RG_STATE_NODE 需要一个不带标志的参数以指定节点。该 optag 值将为指定的节点生成资源组的 RG_STATE 属性值。如果该不带标志的参数指定非全局区域,则格式为 nodename:zonename

示例

示例 1 使用 scha_resourcegroup_get 的样例脚本

向下面的脚本传递了一个 –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

退出状态

返回以下退出状态代码:

0

命令已成功完成。

非零值

发生错误。

scha_calls(3HA) 中介绍了故障错误代码。

属性

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

属性类型
属性值
可用性
ha-cluster/developer/api
接口稳定性
Stable(稳定)

另请参见

awk(1)clnode(1CL)scha_cmds(1HA)scha_calls(3HA)scha_resourcegroup_get(3HA)attributes(5)rg_properties(5)rbac(5)