lssam
名前
lssam - 定義されたリソース・グループとそのメンバーをツリー形式でリストします。
概要
lssam [-h|-top] [-g Resource_group] [-s "selection_string"] [-nocolor] [-noequ] [-nomsg] [-V] [-T]
説明
lssam コマンドは、すべてのリソース・グループとすべてのリソース・グループ・メンバーをツリー形式でリストします。 一部の情報は色分けされています。例えば、リソースの
OpState
は、実際の値に応じて色分けされます。 色分けにより、問題があるかどうかが示されます。 色分けは構成可能ではないため、黒色または白色の背景を使用してください。 別の背景色を使用する場合は、オプション -nocolor を使用して、 lssamによって報告されたすべての情報を表示します。注: 以下の RSCT メッセージを受け取った場合、データは保留中です。 次のいずれかの照会によって、完全なデータが表示されます。
2610-444 Cannot obtain values for some dynamic attributes.
0 attributes are not being monitored. 1 attributes have data pending.
Options
- -h
- 助けて 標準出力にコマンドの使用法ステートメントを書き込みます。
- -g リソース・グループ
- 指定された最上位リソース・グループおよびそのメンバーのみをツリー形式で表示します。
- -nocolor
- 出力を色付きの強調表示なしに表示します。
- -s "selection_string"
- リソース・グループの選択文字列を指定します。 リソース・グループがトップレベル・リソース・グループでない場合は、選択文字列にトップレベル・リソース・グループが含まれている必要があります。 すべての選択文字列は、二重引用符または単一引用符で囲む必要があります。 選択文字列に二重引用符が含まれる場合は、選択文字列全体を単一引用符で囲みます。 以下に例を示します。
-s 'Name == "testing"' -s 'Name ?= "test"'
リソース・グループがトップレベル・リソース・グループでない場合は、選択文字列に対応するトップレベル・リソース・グループが含まれている必要があります。 以下に例を示します。
-s 'Name like "test" || Name like "top-level-rg" '
- -top
- 出力を画面上部に表示し、出力を毎秒リフレッシュします。
- -noequ
- 同値なしで出力を印刷します。
- -nomsg
- エラー・メッセージなしで出力を印刷します。
- -V
- リソースの詳細と関係を印刷します。
- -T
- 標準エラー出力にコマンドのトレース・メッセージを書き込みます。 ソフトウェア・サービス会社におい てのみ使用します。
Output
[ <OpState> "IBM.ResourceGroup:"<GroupName> ["Request="<RequestStateList>]
["Automation="<AutomationMode>]
["Control="<ControlState>]
["Binding="<BindingState>]
"Nominal="<NominalState>
[ "|-" <OpState> "IBM.ResourceGroup:"<GroupName> ["Request="<RequestStateList>]
["Automation="<AutomationMode>]
["Control="<ControlState>]
["Binding="<BindingState>]
["Opt="<RecoveryPolicy>]
"Nominal="<NominalState>
]*
[ "|-" <OpState> <ResourceClass>":"<FixedResourceName>":"<NodeName>
["Request="<RequestStateList>]
["Control="<ControlState>]
["Binding="<BindingState>]
["IP="<IPAddress>]
["MNT="<MountPoint>]
["TimeToStart="<TimeToStart>
"TimeToStop="<TimeToStop>]
["Node="<NodeState>]
["Opt="<RecoveryPolicy>]
]*
[ "|-" <OpState> <ResourceClass>":"<FloatingResourceName> ["Request="<RequestStateList>]
["Control="<ControlState>]
["Binding="<BindingState>]
["IP="<IPAddress>]
["MNT="<MountPoint>]
["TimeToStart="<TimeToStart>
"TimeToStop="<TimeToStop>]
["Opt="<RecoveryPolicy>]
[ "|-" <OpState> <ResourceClass>":"<ConstituentResourceName>":"<NodeName>
["Node="<NodeState>]
["Opt="<RecoveryPolicy>]
]+
]*
]*
[ <OpState> "IBM.Equivalency:"<EquivalencyName> ["SelectFromPolicy="<SelectFromPolicyList>]
[ "|-" <OpState> <ResourceClass>":"<FixedResourceName>":"<NodeName>
["Node="<NodeState>]
]+
]*
出力の解釈:
<OpState> - OpState of group/resource
Color-coding scheme:
"Unknown" - Blue
"Offline" - Blue
"Online" - Green
"Failed offline" - Red
"Stuck online" - Red
"Pending online" - Yellow
"Pending offline" - Yellow
"Ineligible" - Yellow
<GroupName> - Name of the resource group
<ResourceClass> - Name of the resource class
<FixedResourceName> - Name of a fixed resource
<FloatingResourceName> - Name of a floating resource
<ConstituentResourceName> - Name of a constituent resource
<NodeName> - Name of a node (short host name)
<RequestStateList> - If requests are present, one or more request states
with source indicator are shown
<RequestState>[":"<SourceIndicator>]
[ "("<RequestState>":"<SourceIndicator>[","<RequestState>":"<SourceIndicator> ]+")" ]
<RequestState> - Request action
Color-coding scheme:
"Online" - Green if inactive, yellow if active
"Offline" - Blue if inactive, yellow if active
"Lock" - Red
"Move" - Not color-coded if inactive, yellow if active
<SourceIndicator> - First letter of the request source:
"O" - Operator (if operator request is first in list, this indicator is not shown)
"A" - Automation
"E" - ExtSchedul
"U" - Unknown
<AutomationState> - Automation attribute from lssamctrl (in red color)
"Manual" - Automation disabled for this domain
<NodeState> - Some states of a node (in red color)
"Offline" - Node is offline
"Excluded" - Node is excluded (if a node is offline, "Excluded" is not shown)
<ControlState> - Some states of the AutomationDetails ControlState (in yellow color)
"StartInhibited" - Start of dependent resource is not satisfactory
(only displayed if OpState is Offline and DesiredState is Online)
"StopInhibited" - Stop of dependent resource is not satisfactory
(only displayed if OpState is Online and DesiredState is Offline)
"SuspendedPropagated" - A lock request is propagated to this resource
"StartInhibitedBecauseSuspended" - Start of dependent resource is not satisfactory
and a lock request is propagated to this resource
(only displayed if OpState is Offline and DesiredState is Online)
"StopInhibitedBecauseSuspended" - Stop of dependent resource is not satisfactory
and a lock request is propagated to this resource
(only displayed if OpState is Online and DesiredState is Offline)
"MemberInProblemState" - A constituent of the resource, a
resource, or a resource group is in a problem state
Problem state means that the resource is failed offline or not
startable due to another reason. Identify and solve the
problem of the resource and enter resetrsrc.
<BindingState> - Some states of the AutomationDetails BindingState (in red color)
"Unbindable" - Configuration is incorrect
"Sacrificed" - No system available to comply with configuration
"Sacrificial" - No system available to comply with configuration
<NominalState> - Nominal State
Color-coding scheme:
Online - Green
Offline - Blue
<EquivalencyName> - Name of the equivalency
The following information is only displayed if the option -V is specified:
<IPAddress> - IP Address displayed only for class IBM.ServiceIP when option -V is used.
<MountPoint> - Mount point displayed only for class IBM.AgFileSystem when option -V is used.
<TimeToStart> - Time to start displayed only for class IBM.Test when option -V is used and
TimeToStart or TimeToStop value does not equal to default 0 seconds.
<TimeToStop> - Time to stop displayed only for class IBM.Test when option -V is used and
TimeToStart or TimeToStop value does not equal to default 0 seconds.
<SelectFromPolicyList> - Specifies the policy to be used when making a selection from the
Equivalency element.
Only displayed when option -V is used.
( "ANY" | "ORDERED" ) [ ",Failback" ] [ ",NoFailure" ] [ ",NoControl" ]
"ANY" - The member selection has no specific order. This is the default which is not displayed if
its the only option.
"ORDERED" - The member selection starts at the beginning.
"Failback" - The resources are always started on and will failback to the first member available in the
ordered list. Only in combination with ORDERED.
"NoFailure" - The OpState of resources that have a dependency against the equivalency will not be forced
to Failed Offline, if they could not be started within the specified timeout interval.
"NoControl" - System Automation will neither start nor stop the members of the equivalency but only react
to changes of the OpState of these resources.
<RecoveryPolicy> - Specifies the policy which determines how a member failure is recovered.
(“LockOnResFailure” | “LockOnAnyFailure”)
“LockOnResFailure” - Submits a Lock request on the resource group if the member fails.
Automatically recover the member if the node hosting the member fails.
“LockOnAnyFailure” - Submits a Lock request on the resource group if the member or the hosting
node fails.
Note, that the attribute is not displayed if the default value “AutomaticRecovery” is set.
In this case a failure is automatically recovered.
Sample:
Online IBM.Equivalency:equ1 SelectFromPolicy=ORDERED,Failback
Description:
Equivalency equ1 is online and has the select from policy ORDERED and Failback.
Managed relationships between resources are displayed with arrows when option -V is used.
The arrow is displayed on the right side behind the resource tree and starts on the source
resource and points to the target resource.
The relationship type is displayed with two a character shortcut on the arrow. The following list explains
the two character shortcut for the relationship types.
"DO" - DependsOn - Specifies a combination of source StartAfter target, target StopAfter source, source
ForcedDownBy target, source Collocated to target and target Collocated to source.
"DA" - DependsOnAny - Specifies a combination of source StartAfter target, target StopAfter source and
source ForcedDownBy target.
"SA" - StartAfter - Specifies that the source resource is to be started after the target resource.
"SO" - StopAfter - Specifies that the source resource may not be stopped until after the target resource
has been brought offline.
"FD" - ForcedDownBy - Specifies that the source resource must be forced offline in the event that either
the target resource goes offline unexpectedly or the target resource itself is forced offline.
"CO" - Collocated - Specifies that the source resource is always located on the same node as the target
resource.
"AC" - AntiCollocated - Specifies that the source resource is always located on a different node as the
target resource.
"AF" - Affinity - Specifies that the source resource are to be located on the same node as its specified
affinity resource if possible.
"AA" - AntiAffinity - Specifies that the source resource are to be located on a different node as its
specified affinity resource if possible.
"IS" - IsStartable - Specifies that the source resource and its target resources are startable.
Sample:
Online IBM.ResourceGroup:samadapter-rg Nominal=Online
|- Online IBM.Application:samadapter -.
|- Offline IBM.Application:samadapter:p550sa05 |
'- Online IBM.Application:samadapter:p550sa06 DO
'- Online IBM.ServiceIP:samadapter-ip IP=9.152.135.231 <' -.
|- Offline IBM.ServiceIP:samadapter-ip:p550sa05 |
'- Online IBM.ServiceIP:samadapter-ip:p550sa06 DO
Online IBM.Equivalency:samadapter-nieq <'
|- Online IBM.NetworkInterface:eth0:p550sa06
'- Online IBM.NetworkInterface:eth0:p550sa05
Description:
Relationship: Source resource IBM.Application:samadapter
DependsOn target resource IBM.ServiceIP:samadapter-ip
Relationship: Source resource IBM.ServiceIP:samadapter-ip
DependsOn target resource IBM.Equivalency:samadapter-nieq
Floating resource: IBM.ServiceIP:samadapter-ip has the IP Address 9.152.135.231
終了状況
- 0
- コマンドは正常に実行されました。
- 1
- エラーが発生しました。
Security
このコマンドを実行するには、root 権限、または適切なアクセス権を持つユーザー ID が必要です。 詳しくは、 コマンド・ライン・インターフェースの非 root ユーザー ID のセットアップを参照してください。
例
すべてのリソース・グループとそのメンバーをリストするには、次のコマンドを入力します。
lssam
出力:
Online IBM.ResourceGroup:grp1 Nominal=Online
'- Offline IBM.Application:res1:node1
Offline IBM.ResourceGroup:grp2 Nominal=Offline
'- Offline IBM.Application:res2:node2
Online IBM.ResourceGroup:grp3 Request=Online Nominal=Offline
'- Online IBM.Application:res3
|- Online IBM.Application:res3:node1
'- Failed offline IBM.Application:res3:node2
ファイル
- /usr/sbin/rsct/bin/lssam
- lssam コマンドの場所。