scha_cmds (1HA)

名称

scha_cmds - scha_cluster_get、scha_control、scha_resource_get、scha_resourcegroup_get、scha_resourcetype_get、scha_resource_setstatus的命令标准输出

用法概要

 scha-command -O optag...

描述

Oracle Solaris Cluster scha_cluster_get(1HA)、scha_control(1HA)、scha_resource_get(1HA)、scha_resourcegroup_get(1HA)、scha_resourcetype_get(1HA) 和 scha_resource_setstatus(1HA) 命令是资源类型的回调方法的命令行实现。请参见 rt_callbacks(1HA)。

资源类型代表群集的资源组管理器 (Resource Group Manager, RGM) 设备控制的服务。这些命令向 scha_calls(3HA) C 函数的功能提供命令行界面。

get 命令访问群集配置信息。所有这些命令具有相同的通用界面。这些命令都使用 –Ooptag 操作数。该操作数指示要访问的信息。这些命令都将结果作为格式化的字符串发送到标准输出 (stdout)。可能需要其他参数，具体取决于相应的命令和 optag 的值。有关不同 optag 结果的格式的信息，请参见“结果格式”部分。

scha_control(1HA) 命令也使用 –O optag 选项，该选项指示控制操作，但不会将输出生成到标准输出。

scha_resource_setstatus(1HA) 命令用于设置由 RGM 管理的资源的 STATUS 和 STATUS_MSG 属性。

结果格式

通过命令输出到标准输出的字符串的格式取决于 –O 选项中包含的 optag 指示的结果类型。下表中指定了每种类型的格式。formats(5) 中介绍了格式表示法。

结果类型 标准输出的格式 boolean TRUE\n 或 FALSE\n enum %s\n，enum 值的字符串名称。 extension %s\n，扩展属性的类型特性，为以下值之一：STRING、INT、 BOOLEAN、ENUM 或 STRINGARRAY。 根据类型信息，以每个类型的格式输出属性值，如下所示：STRING 作为 string 、INT 作为 int、BOOLEAN 作为 boolean、ENUM 作为 enum、 STRINGARRAY 作为 string_array。 int %d\n status %s\n%s\n，第一个字符串是状态，为以下 enum 值之一：DEGRADED、 FAULTED、OFFLINE、ONLINE 或 UNKNOWN。 第二个字符串是状态消息。 string %s\n string_array 数组中的每个元素按格式 %s\n 进行输出。可以为 GLOBAL_RESOURCES_USED 和 INSTALLED_NODES 属性返回指示所有节点或资源的星号。 unsigned_int %u\n unsigned_int_array 数组中的每个元素按格式 %u\n 进行输出。

optag 结果类型

下表指定不同命令的有效 optag 值，以及根据在前面的表中指定的格式输出的结果类型。

scha_cluster_get(1HA) 的 optag 值 结果类型 ALL_NODEIDS unsigned_int_array ALL_NODENAMES string_array ALL_PRIVATELINK_HOSTNAMES string_array ALL_RESOURCEGROUPS string_array ALL_RESOURCETYPES string_array CLUSTERNAME string NODEID_LOCAL unsigned_int NODEID_NODENAME unsigned_int NODENAME_LOCAL string NODENAME_NODEID string NODESTATE_LOCAL enum (UP、DOWN) NODESTATE_NODE enum (UP、DOWN) PRIVATELINK_HOSTNAME_LOCAL string PRIVATELINK_HOSTNAME_NODE string SYSLOG_FACILITY int

scha_control(1HA) 的 optag 值 CHANGE_STATE_OFFLINE CHANGE_STATE_ONLINE CHECK_GIVEOVER CHECK_RESTART GIVEOVER IGNORE_FAILED_START RESOURCE_DISABLE RESOURCE_IS_RESTARTED RESOURCE_RESTART RESTART

scha_resource_get(1HA) 的 optag 值 结果类型 AFFINITY_TIMEOUT int ALL_EXTENSIONS string_array BOOT_TIMEOUT int CHEAP_PROBE_INTERVAL int CHEAP_PROBE_INTERVAL int EXTENSION extension EXTENSION_NODE extension FAILOVER_MODE enum (NONE、HARD、 SOFT、RESTART_ONLY、LOG_ONLY ) FINI_TIMEOUT int GROUP string INIT_TIMEOUT int LOAD_BALANCING_POLICY string LOAD_BALANCING_WEIGHTS string_array MONITORED_SWITCH enum (DISABLED、ENABLED) MONITORED_SWITCH_NODE enum (DISABLED、ENABLED) MONITOR_CHECK_TIMEOUT int MONITOR_START_TIMEOUT int MONITOR_STOP_TIMEOUT int NETWORK_RESOURCES_USED string_array NUM_RESOURCE_RESTARTS int NUM_RG_RESTARTS int ON_OFF_SWITCH enum (DISABLED、ENABLED) ON_OFF_SWITCH_NODE enum (DISABLED、ENABLED) PORT_LIST string_array POSTNET_STOP_TIMEOUT int PRENET_START_TIMEOUT int R_DESCRIPTION string RESOURCE_DEPENDENCIES string_array RESOURCE_DEPENDENCIES_OFFLINE_RESTART string_array RESOURCE_DEPENDENCIES_RESTART string_array RESOURCE_DEPENDENCIES_WEAK string_array RESOURCE_PROJECT_NAME string RESOURCE_STATE enum (ONLINE、OFFLINE、 START_FAILED、STOP_FAILED、MONITOR_FAILED、 ONLINE_NOT_MONITORED、STARTING、STOPPING) RESOURCE_STATE_NODE enum（有关值，请参见 RESOURCE_STATE） RETRY_COUNT int RETRY_INTERVAL int SCALABLE boolean START_TIMEOUT int STATUS status STATUS_NODE status STOP_TIMEOUT int THOROUGH_PROBE_INTERVAL int TYPE string TYPE_VERSION string UDP_AFFINITY boolean UPDATE_TIMEOUT int VALIDATE_TIMEOUT int WEAK_AFFINITY boolean

scha_resource_get (1HA) 和 scha_resourcetype_get (1HA) 的 optag 值 结果类型 API_VERSION int BOOT string FAILOVER boolean FINI string GLOBAL_ZONE boolean INIT string INIT_NODES enum (RG_PRIMARIES、RT_INSTALLED_NODES ) INSTALLED_NODES string_array。返回一个星号 (*) 以指示所有节点。 IS_LOGICAL_HOSTNAME boolean IS_SHARED_ADDRESS boolean MONITOR_CHECK string MONITOR_START string MONITOR_STOP string PER_NODE boolean PKGLIST string_array POSTNET_STOP string PRENET_START string PROXY boolean RT_BASEDIR string RT_DESCRIPTION string RT_SYSTEM boolean RT_VERSION string SINGLE_INSTANCE boolean START string STOP string UPDATE string VALIDATE string

scha_resourcegroup_get (1HA) 的 optag 值 结果类型 AUTO_START_ON_NEW_CLUSTER boolean DESIRED_PRIMARIES int FAILBACK boolean GLOBAL_RESOURCES_USED string_array（返回星号 (*) 以指示所有资源） IMPLICIT_NETWORK_DEPENDENCIES boolean MAXIMUM_PRIMARIES int NODELIST string_array PATHPREFIX string PINGPONG_INTERVAL int RESOURCE_LIST string_array RG_AFFINITIES string_array RG_DEPENDENCIES string_array RG_DESCRIPTION string RG_IS_FROZEN boolean RG_MODE enum (FAILOVER、SCALABLE) RG_PROJECT_NAME string RG_SLM_CPU decimal RG_SLM_CPU_MIN decimal RG_SLM_PSET_TYPE enum (DEFAULT、DEDICATED_STRONG 、DEDICATED_WEAK) RG_SLM_TYPE enum (AUTOMATED、MANUAL) RG_STATE enum (UNMANAGED, ONLINE, OFFLINE, PENDING_ONLINE, PENDING_OFFLINE, ERROR_STOP_FAILED, ONLINE_FAULTED, PENDING_ONLINE_BLOCKED) RG_STATE_NODE enum（有关值，请参见 RG_STATE） RG_SYSTEM boolean SUSPEND_AUTOMATIC_RECOVERY boolean

退出状态

一组退出状态代码适用于所有 scha 命令。

退出状态代码是 scha_calls(3HA) 中介绍的相应 C 函数的 scha_err_t 返回代码数字值。

属性

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

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

另请参见

awk(1)、rt_callbacks(1HA)、scha_cluster_get(1HA)、scha_control(1HA)、scha_resource_get(1HA)、scha_resourcegroup_get(1HA)、scha_resourcetype_get(1HA)、scha_resource_setstatus(1HA)、scha_calls(3HA)、attributes(5)、formats(5)、r_properties(5)、rg_properties(5)、rt_properties(5)