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、最初の文字列はステータスであり、DEGRADED、FAULTED、OFFLINE、ONLINE、または UNKNOWN の enum 値のいずれかです。
2 番目の文字列はステータスメッセージ
|
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 コマンドで有効な 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 コマンドで有効な 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 コマンドで有効な 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 および scha_resourcetype_get コマンドで有効な 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 コマンドで有効な 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
|
インタフェースの安定性
|
安定
|
|
関連項目
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)