Oracle® Solaris Cluster 参考手册

退出打印视图

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

scha_resource_setstatus (1HA)

名称

scha_resource_setstatus - 设置资源状态

用法概要

scha_resource_setstatus -R resource -G group -s status [-m msg] 
     [-Z zonename]

描述

scha_resource_setstatus 命令可设置由资源组管理器 (Resource Group Manager, RGM) 管理的资源的 StatusStatus_msg 属性。该命令供资源的监视器用来指示它所识别的资源状态。该命令提供的功能与 scha_resource_setstatus(3HA) C 函数的功能相同。

执行 scha_resource_setstatus(1HA) 命令时,会使用所指定的值更新资源的 StatusStatus_msg 属性。Oracle Solaris Cluster 将在群集系统日志中记录对资源状态所做的更改,您可以使用群集管理工具查看该日志。

需要具有 solaris.cluster.resource.admin 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

指定包含该资源的资源组。

–m msg

指定要分配给资源的 Status_msg 属性的文本字符串。如果未指定该选项,资源的 Status_msg 值将设置为 NULL

–R resource

指定要设置其状态的资源。

–s status

指定 status 的值:OKDEGRADEDFAULTEDUNKNOWNOFFLINE

–Z zonename

指定在其中配置要运行的资源组的区域群集的名称。

如果 Global_zone 属性设置为 TRUE,则即使在区域群集中配置了包含资源的资源组,也会在全局区域中执行方法。–Z 选项设置的是运行资源组的非全局区域而不是运行方法的全局区域的状态。

请仅对 Global_zone 属性设置为 TRUE 的资源类型使用 –Z 选项。如果 Global_zone 属性设置为 FALSE,则不需要此选项。有关 Global_zone 属性的更多信息,请参见 rt_properties(5) 手册页。

示例

示例 1 设置资源 R1 的状态并生成 Status_msg

以下命令将资源组 RG2 中资源 R1 的状态设置为 OK,并将 Status_msg 设置为 Resource R1 is OK

scha_resource_setstatus -R R1 -G RG2 -s OK -m "Resource R1 is OK"
示例 2 设置资源 R1 的状态但不生成 Status_msg

以下命令将资源组 RG2R1 的状态设置为 DEGRADED,并将 Status_msg 设置为 NULL

scha_resource_setstatus -R R1 -G RG2 -s DEGRADED
示例 3 设置区域 Zone1 中资源 R1 的状态并生成 Status_msg

以下示例显示了一个作为 shell 脚本实现的资源类型方法或监视器。该 shell 脚本显示了如何将区域 $localzone 中资源组 $rg 中的资源 $resource 的状态设置为 OK。该 shell 脚本还将 Status_msg 设置为 “Resource R1 is OK”。在本例中,必须指定 -Z 选项,因为资源类型属性 Global_zone 被假定设置为 TRUE

resource=
rg=""
localzone=""
zflag=""
while getopts R:G:Z:
do
      case $c in
      R)   resource=$OPTARG;;
      G)   rg=$OPTARG;;
      Z)   zflag="-Z"
           localzone=$OPTARG;;
      esac
done
...
scha_resource_setstatus -R $resource -G $rg $zflag $localzone -s OK -m
    "Resource R1 is OK"

退出状态

返回以下退出状态代码:

0

命令已成功完成。

非零值

发生错误。

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

属性

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

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

另请参见

scha_cmds(1HA)scha_calls(3HA)scha_resource_setstatus(3HA)attributes(5)rbac(5)rt_properties(5)