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) 機能によって制御されるサービスを表します。これらのコマンドは、C 関数 scha_calls(3HA) の機能に対するコマンド行インタフェースを提供します。
get 関数はクラスタ構成情報にアクセスします。これらのコマンドすべては同じ標準的なインタフェースを持っています。これらのコマンドはすべて –O optag オペランドを取ります。このオペランドはアクセスされる情報を示します。これらのコマンドはすべて、結果を書式付き文字列として標準出力 (stdout) に送信します。コマンドとオペランド optag の値によっては、その他の引数を追加指定する必要があります。さまざまな optag の実行結果の書式については、「実行結果の書式」を参照してください。
注 -
すべての scha コマンドの 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。
2 番目の文字列はステータスメッセージ
|
string
|
%s\n
|
string_array
|
配列の各要素は、書式 %s\n で出力される。GLOBAL_RESOURCES_USED および INSTALLED_NODES プロパティーで、すべてのノードまたはリソースを示すアスタリスクを返すことができる。
|
unsigned_int
|
%u\n
|
unsigned_int_array
|
配列の各要素は、書式 %u\n で出力される。
|
|
optag の結果の型
次の表に、さまざまなコマンドに対する有効な 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
|
|
|
CHANGE_STATE_OFFLINE
|
CHANGE_STATE_ONLINE
|
CHECK_GIVEOVER
|
CHECK_RESTART
|
GIVEOVER
|
IGNORE_FAILED_START
|
RESOURCE_DISABLE
|
RESOURCE_IS_RESTARTED
|
RESOURCE_RESTART
|
RESTART
|
|
|
|
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
|
|
|
|
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
|
|
|
|
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
|
インタフェースの安定性
|
安定
|
|
関連項目
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)