clmgr コマンド

目的

clmgr コマンドは、端末またはスクリプトを使用 して PowerHA® SystemMirror® for Linux のクラスター操作を実行するための、 整合性のある、信頼できるインターフェースを提供します。

構文

このコマンドでは、以下の構文を使用します。
clmgr {[-c|-d <DELIMITER>] [-S] | [-x]}  
[-v][-f][-T <#####>]
[-l {error|standard|low|med|high|max}][-a 
{<ATTR#1>,<ATTR#2>,...}] <ACTION> <CLASS> [<NAME>]
[-h | <ATTR#1>=<VALUE#1> <ATTR#2>=<VALUE#2> <ATTR#n>=<VALUE#n>]

clmgr {[-c|-d <DELIMITER>] [-S] | [-x]} 
[-v][-f] [-T <#####>]
[-l {error|standard|low|med|high|max}][-a {<ATTR#1>,<ATTR#2>,...}]
ACTION={add|modify|delete|query|online|offline|...}
CLASS={cluster|node|network|resource_group|...}

clmgr {-h|-?} [-v] [<ACTION>[ <CLASS>]]
clmgr [-v] help
clmgr コマンドは、以下の基本形式を使用します。
clmgr <ACTION> <CLASS> [<NAME>] [<ATTRIBUTES...>]
コマンド・ライン・インターフェースから、clmgr コマンドについて組み込みのヘルプ・オプションを使用することができます。 例えば、いずれのフラグやパラメーターも指定せずに clmgr コマンドを実行すると、使用可能な ACTION フラグのリストが表示されます。CLASS オブジェクトを指定せずに clmgr ACTION コマンドを入力すると、指定された ACTION フラグで使用可能なすべての CLASS オブジェクトのリストが表示されます。 いずれの NAME オプションあるいは ATTRIBUTES オプションも指定せずに clmgr ACTION CLASS コマンドを入力した場合の出力は異なります。これは、ACTION と CLASS の組み合わせによっては、追加のパラメーターが不要な場合があるからです。 このシナリオでヘルプ情報を表示するには、clmgr ACTION CLASS コマンドに明示的に -h フラグを付加する必要があります。 clmgr コマンドの個々の属性について、コマンド・ラインからヘルプ情報を表示することはできません。

説明

clmgr コマンドの構文は、使いやすさのために一貫性のあるものになっています。さらに、clmgr コマンドの戻りコードは、スクリプト記述を容易にするために一貫性のあるものになっています。クラスター情報を収集するために、データ照会にも複数の出力形式が用意されています。

すべての clmgr コマンド操作は、clutils.log ファイルに記録されます。このログには、実行されたコマンドの名前、コマンドの開始時刻停止時刻、コマンドを開始したユーザー名が含まれます。

フラグ

ACTION
実行する操作を記述します。
注: ACTION フラグには大/小文字の区別がありません。すべての ACTION フラグについて、短いエイリアスが用意されています。 例えば、rmdelete アクションのエイリアスです。 エイリアスはコマンド・ラインで使用するために便宜上提供されたものであって、それをスクリプトで使用することはできません。
以下の 4 つの ACTION フラグは、サポートされるほとんどすべての CLASS オブジェクトで使用可能です。
  • add (エイリアス: a、cr*、make、mk、bu*、bld)
  • query (エイリアス: q*、ls、get、l、sh*)
  • modify (エイリアス: mod、ch、set)
  • delete (エイリアス: de*、rem*、rm、er*)
以下の ACTION フラグは、通常、サポートされる CLASS オブジェクトのサブセットでのみサポートされます。
  • クラスター、ノード、リソース・グループの場合:
    • start (エイリアス: online、on*)
    • stop (エイリアス: offline、of*、dea*)
  • リソース・グループ:
    • move (エイリアス: mov*、mv)
  • ログ:
    • manage (エイリアス: ma、mg)
  • クラスター
    • verify (エイリアス: ve)
  • ログ:
    • view (エイリアス: vi)
  • Smart Assist:
    • setup
    • update
  • スナップショット:
    • manage (エイリアス: ma、mg)
    • view (エイリアス: vi)
  • Application、service_ip、file_system、resource_group:
    • reset
CLASS
ACTION フラグとして指定した値が実行される対象のオブジェクトのタイプ。
注: CLASS フラグには大/小文字の区別がありません。すべての CLASS オブジェクトについて、短いエイリアスが用意されています。 例えば、clCluster のエイリアスです。 エイリアスはコマンド・ラインで使用するために便宜上提供されたものであって、それをスクリプトで使用することはできません。
サポートされる CLASS オブジェクトの完全なリストは、以下のとおりです。
  • cluster (エイリアス: cl*)
  • node (エイリアス: no*、nd)
  • interface (エイリアス: int*)
  • network (エイリアス: ne*, nw)
  • resource_group (resource_g*、rg)
  • service_ip (se*、si)
  • persistent_ip (エイリアス: pe*、pi)
  • application (エイリアス: ac、app*、as)
  • dependency (エイリアス: de*)
  • file_collection (エイリアス: file_c*、fc)
  • file_system (エイリアス: file_s*、fs)
  • snapshot (エイリアス: sn*、ss、ba*)
  • user (エイリアス: us*、ur)
  • group (エイリアス: gr*, gp)
  • equivalency (エイリアス: eq*)
  • nfs_client (エイリアス: nfs、nfsc、nfs_c*)
  • log (エイリアス: logs)
  • smart_assist (エイリアス: sm*、sa)
  • logical_volume (エイリアス: lv、logi*)
NAME
ACTION フラグを実行する必要がある対象の (タイプ CLASSの) 特定のオブジェクト。
ATTR=VALUE
ACTION と CLASS の組み合わせに固有な属性のペアと値のペアを持つオプションのフラグ。このペアは、構成の設定を指定したり、特定の操作を調整したりするために使用します。
このフラグを query ACTION フラグと一緒に使用する場合、ATTR=VALUE の指定を使用して、属性ベースの検索およびフィルタリングを実行することができます。 この場合、単純なワイルドカード文字を使用することができます。 アスタリスク (*) ワイルドカード文字は、あらゆる文字を検索します。 例えば、検索語「HO*」を使用した場合、返される検索結果は、「HOT」、「HOST」、および「HOSTNAME」です。疑問符 (?) ワイルドカード文字は、単一文字を検索します。例えば、検索語「HA?」を使用した場合、返される検索結果は、「HAT」、「HAM」です。
注: ATTR 属性は、完全に入力する必要はありません。指定された操作で使用可能な一連の属性からその属性を一意的に識別するために必要な数の先頭文字だけを指定する必要があります。
-a
指定された属性のみを表示し、queryadd、および modify ACTION フラグでのみ有効です。属性名には大/小文字の区別がなく、標準の UNIX ワイルドカード文字 (アスタリスク (*) や疑問符 (?) など) と一緒に使用することができます。
-c
すべてのデータをコロン区切りのフォーマットで表示し、queryadd、および modify ACTION フラグでのみ有効です。
-d
queryadd、および modify ACTION フラグでのみ有効で、すべてのデータを、指定の区切り文字で区切られた形式で表示するよう要求します。
-f
対話式プロンプトを無効にし、現在の操作を試みることを強制します (操作の強制が可能である場合)。
-h
ヘルプ情報を表示します。
-l
保守容易性について以下のトレース・ログ値をアクティブにします。
エラー
エラーが検出された場合はログ・ファイルの更新のみを行います。
Standard
clmgr の各操作について基本情報をログに記録します。
Low
各関数の入り口および出口の基本トレースを実行します。
Med
med トレースを実行するほか、関数の入り口パラメーター値と関数からの戻り値を追加記録します。
High
high トレースを実行するほか、実行の各行のトレースも記録しますが、ルーチン関数とユーティリティー関数は省略します。
Max
maximum トレースを実行するほか、ルーチン関数とユーティリティー関数を追加記録します。さらに、関数の開始メッセージと終了メッセージに時刻と日付のタイム・スタンプを追加記録します。
注: トレース・データはすべて clutils.log ファイルに書き込まれます。このフラグは、問題をトラブルシューティングするために使用されます。
-S
列見出しを付けずにデータを表示します。query ACTION フラグおよび -c フラグでのみ有効です。
-T
トランザクション ID は記録される出力すべてに適用されます。これは、1 つ以上のアクティビティーを、分析の目的でログ・ファイルから抽出できる出力の単一セクションにグループ化するときに役立ちます。 このフラグは、問題をトラブルシューティングするために使用されます。
-v
最大の詳細さで情報を出力します。
注: query ACTION フラグで特定のオブジェクト名を指定しないでこの フラグを使用すると、指定されたクラスのすべてのインスタンスが表示されます。例えば、clmgr -v query node コマンドを実行した場合、すべてのノードおよびその属性が表示されます。 このフラグを add または modify の ACTION と一緒に使用した場合、操作の完了後に、その結果の属性が表示されます (操作が正常に完了した場合のみ)。
-x
すべてのデータを単純な XML フォーマットで表示し、query、add、および modify ACTION フラグでのみ有効です。

clmgr 操作の構文

クラスター

clmgr add cluster
         [ <cluster_label> ]
         [ NODES=<host>[,<host#2>,...] ]
add => create, make, mk
cluster => cl
 
         

clmgr modify cluster 
         [ SPLIT_POLICY={manual|none|tiebreaker} ]
         [ TIEBREAKER={disk|nfs} ]
         [ DISK_WWID=<#DISK_WWID> ]
         [ NFS_SERVER=<#NFS_SERVER> ]
         [ NFS_SERVER_MOUNT_POINT=<NFS_SERVER_MOUNT_POINT_PATH> ]
         [ NFS_LOCAL_MOUNT_POINT=<NFS_LOCAL_MOUNT_POINT_PATH> ]
         [ NFS_FILE_NAME=<#NFS_FILE_NAME> ]
 modify => change, set
 cluster => cl
             

clmgr offline cluster
         [ STOP_RSCT={no|yes} ]
offline => stop
cluster => cl

clmgr online cluster
         [ MANAGE={auto|manual} ]    
online => start
cluster => cl

clmgr query cluster [ ALL | {CORE,SPLIT} ]
query => get, list, ls, show
cluster => cl

clmgr delete cluster [ NODES={ALL|<node#1>,<node#n>,...} ]
delete => erase, remove, rm
cluster => cl

clmgr verify cluster
verify => validate


     
ノード
変更情報の開始

clmgr add node <node>
		      [ START_ON_BOOT={TRUE|FALSE} ]
add => create, make, mk
node => no

clmgr query node {<node>|LOCAL}[,<node#2>,...]
clmgr -v query node
query => get, list, ls, show
node => no

clmgr delete node {<node>[,<node#2>,<node#n>,...] | ALL}
delete => erase, remove, rm
node => no

clmgr online node <node>[,<node#2>,<node#n>,...]
         [ MANAGE={auto|manual} ]
         [ WHEN={now|reboot|both} ]
 online => start
 node => no

clmgr offline node <node>[,<node#2>,<node#n>,...]
         [ MANAGE={offline|move}]
         [ STOP_RSCT={no|yes}]
         [ WHEN={now|reboot|both} ]
 offline => stop
 node => no


     
変更情報の終了
ネットワーク

clmgr add network <network>
          [TYPE={ether|disk}]
          [PVID={#PVID}]
          [NODES=<node_P1>[,<node_P2>,...]
add => create, make, mk
network => ne, nw

clmgr delete <network>[,<network#2>,<network#n>,...]
delete => erase, remove, rm
network => ne, nw

clmgr query network <network>[,<network#2>,<network#n>,...]

clmgr -v query network
query => get, list, ls, show
network => ne, nw

clmgr modify network <network>
         [ node=<nodeA1[,nodeA2,...]> ]
modify => change, set
network => ne, nw


インターフェース

clmgr add interface NETWORK= <network>
          NODE=<node>
          INTERFACE=<interface>
add => create, make, mk
interface => in, if        

clmgr delete interface NETWORK= <network>
  	NODE=<node>
         INTERFACE=<interface>
delete => erase, remove, rm
interface => in, if


リソース・グループ

clmgr add resource_group <resource_group>[,<rg#2>,...]
         NODES=<node_P1>[,<node_P2>,...]
         [ STARTUP={OFAN|OAAN}]
         [ FALLOVER={FNPN|BO}]
         [ FALLBACK={NFB|FBHN}]
         [ SERVICE_LABEL=ser_ip#1[,ser_ip#2,... ]]
         [ APPLICATIONS=app#1[,app#2,...]]
         [ FILESYSTEM=fs#1[,fs#2,...]]
         [ PRIORITY=<0-200>]

 add => create, make, mk
 resource_group => rg

STARTUP:
    OFAN ---- Online on First Available Node
    OAAN ---- Online on All Available Nodes (concurrent)
        
FALLOVER:
    FNPN ---- Fallover to Next Priority Node (default value)
    BO ------ Bring Offline (On Error Node Only)

FALLBACK:
    NFB ----- Never Fallback (default value)
    FBHN --- Fallback to Home Node


 

clmgr modify resource_group <resource_group>
         [ NAME=<new_resource_group_label>]
         [ NODES=nodeA1[,nodeA2,...]]
         [ STARTUP={OFAN|OAAN}]
         [ FALLOVER={FNPN|BO}]
         [ FALLBACK={NFB|FBHN}]
         [ SERVICE_LABEL=service_ip#1[,service_ip#2,...]]
         [ APPLICATIONS=app#1[,app#2,...]]
         [ FILESYSTEM=fs#1[,fs#2,...]]
         [ PRIORITY= <0-200>]
modify => change, set
resource_group => rg


            
clmgr query resource_group <resource_group>[,<rg#2>,<rg#n>,...]

clmgr -v query resource_group
query => get, list, ls, show
resource_group => rg

clmgr delete resource_group {<resource_group>[,<rg#2>,<rg#n>,...] | ALL}
delete => erase, remove, rm
resource_group => rg

clmgr online resource_group { <resource_group>[,<rg#2>,<rg#n>,...] | ALL }
online => start
resource_group => rg

clmgr offline resource_group { <resource_group>[,<rg#2>,<rg#n>,...] | ALL }
offline => stop
resource_group => rg


注: ALL 属性は、すべてのリソース・グループをオンラインまたはオフラインにしようと試みます。
            
clmgr move resource_group <resource_group>[,<rg#2>,<rg#n>,...]
          NODE=<node>
move => mv
resource_group => rg

clmgr reset resource_group <resource_group>
          [NODE=<node_name>]
resource_group => rg


永続 IP/ラベル
	
clmgr add persistent_ip <persistent_label>
          NETWORK=<network>
          NODE=<node>
          [ NETMASK=<###.###.###.###> ]
add => create, make, mk
persistent_ip => pi

clmgr delete persistent_ip {<persistent_label>[,<persistent_label#2>,<persistent_label#n>,...] | ALL}
delete => erase, remove, rm
persistent_ip => pi
 
clmgr modify persistent_ip <persistent_label>
         [ NAME=<new_persistent_label> ]
         [ NETWORK=<new_network> ]
         [ NETMASK=<###.###.###.###> ]
modify => change, set
persistent_ip => pi

clmgr query persistent_ip [<persistent_label>[,<persistent_label#2>,<persistent_label#n>,...] ]
clmgr -v query persistent_ip
query => get, list, ls, show
persistent_ip => pi


注: persistent_ip のエイリアスは pi です。
サービス IP/ラベル
            
clmgr add service_ip <service_ip_label>
         NETWORK=<network>
         [ NETMASK=<###.###.###.###>]
add => create, make, mk
service_ip => si

clmgr modify service_ip <service_label>
         [ NAME=<new_service_label> ]
         [ NETWORK=<new_network> ]
         [ NETMASK=<###.###.###.###> ]
modify => change, set
service_ip => si
												             
clmgr query service_ip <sLabel#1>[,<sLabel#2>,<sLabel#n>,...]
clmgr -v query service_ip
query => get, list, ls, show
service_ip => si

clmgr delete service_ip {<sLabe#l>[,<Label#2>,<Label#n>,...] | ALL}
delete => erase, remove, rm
service_ip => si

clmgr reset service_ip <service_ip>
         [NODE=<node_name>]
service_ip => si


アプリケーション

clmgr add application <application>
         TYPE=Process
         STARTSCRIPT="/path/to/start/script"
         STOPSCRIPT="/path/to/stop/script"
         PROCESS="/process/to/monitor"
         [OWNER="<owner_name>"]
         [RESOURCETYPE=“1,2” ]
         [STARTCOMMANDTIMEOUT=""]
         [STOPCOMMANDTIMEOUT=""]
         [CLEANUPMETHOD="</script/to/cleanup>" ]
         [PROTECTIONMODE="0,1" ]

 clmgr add application <application>
         TYPE=Custom
         STARTSCRIPT="/path/to/start/script"
         STOPSCRIPT="/path/to/stop/script"
         MONITORMETHOD="/program/to/monitor"
         [OWNER="<owner_name>" ]
         [RESOURCETYPE=“1,2” ]
         [STARTCOMMANDTIMEOUT=""]
         [STOPCOMMANDTIMEOUT=""]
         [MONITORCOMMANDTIMEOUT=""]
         [MONITORINTERVAL="1 .. 1024" ]
         [CLEANUPMETHOD="</script/to/cleanup>" ]
         [PROTECTIONMODE="0,1" ]
add => create, make, mk
application => app

clmgr modify application <application name>
         [ NAME=<new_label> ]
         [ TYPE={Process|Custom} ]
         [ STARTSCRIPT="/path/to/start/script" ]
         [ STOPSCRIPT="/path/to/stop/script" ]
         [ OWNER="<owner_name>" ]
         [ STARTCOMMANDTIMEOUT="" ]
         [ STOPCOMMANDTIMEOUT="" ]
         [ PROTECTIONMODE="0,1 ]
         PROCESS="process_name"
         [ CLEANUPMETHOD="</script/to/cleanup>" ]
         MONITORMETHOD="/program/to/monitor"
         [ MONITORINTERVAL="1 .. 1024" ]
         [ MONITORCOMMANDTIMEOUT="" ]
         [ CLEANUPMETHOD="</script/to/cleanup>" ]
modify => change, set
application => app

clmgr query application <application>[,<app#2>,<app#n>,...] 
clmgr -v query application
query => get, list, ls, show
application => app

clmgr delete application {<app>[,<app#2>,<app#n>,...] ALL}
delete => erase, remove, rm
application => app

clmgr reset application <application>
         [NODE=<node_name>]


注: app という値は application の省略語です。 application のエイリアスは ac および app です。
依存関係

clmgr add dependency <dependency_name>
          TYPE={[<DEPENDSON|DEPENDSONANY|STARTAFTER|STOPAFTER|COLLOCATED|ANTICOLLOCATED|FORCEDDOWNBY|ISSTARTABLE]}
          SOURCE="<rg#1>"
          TARGET="<rg#2>[,<rg#3>,...,<rg#n>]"
add => create, make, mk
dependency => de

clmgr delete dependency {<dependency>[,<dep#2>,<dep#n>,...] |
             ALL}
delete => erase, remove, rm
dependency => de

clmgr query dependency <depname>[,<dep#2>,<dep#n>,...]
clmgr -v query dependency
query => get, list, ls, show
dependency => de

clmgr modify dependency <dependency_name>
         [NAME="<new_label>" ]
         [TYPE={[<DEPENDSON|DEPENDSONANY|STARTAFTER|STOPAFTER|  
         COLLOCATED|ANTICOLLOCATED|FORCEDDOWNBY|ISSTARTABLE]}
         [TARGET="<rg#1>[,<rg#2>,...,<rg#n>]" ]
modify => change, set
dependency => de


ファイル・コレクション

clmgr add file_collection
         <file_collection>
         [ FILES="/path/to/file1,/path/to/file2,..." ]
         [ SYNC_WHEN_CHANGED={no|yes} ]
         [ DESCRIPTION="<file_collection_description>" ]
add => create, make, mk
file_collection => fi, fc

clmgr delete file_collection {<file_collection>[,<fc#2>,<fc#n>,...]
             | ALL }
 delete => erase, remove, rm
 file_collection => fi, fc

clmgr modify file_collection
          <file_collection>
          [ NAME="<new_file_collection_label>" ]
          [ ADD="/path/to/file1,/path/to/file2,..."]
          [ DELETE={"/path/to/file1,/path/to/file2,..."}]
          [ SYNC_WHEN_CHANGED={no|yes} ]
          [ DESCRIPTION="<file_collection_description>"]

modify => change, set
file_collection => fi, fc

clmgr query file_collection <file_collection>[,<fc#2>,<fc#n>,...]
clmgr -v query file_collection
query => get, list, ls, show
file_collection => fi, fc

clmgr sync file_collection <file_collection>

clmgr update file_collection [ SYNC_INTERVAL="10 .. 1440" ]
clmgr update file_collection
filecollection => fi, fc


Snapshot
	
clmgr add snapshots <snapshot>
          [ DESCRIPTION="<snapshot_description>" ]
add => create, make, mk
snapshot => sn, ss

clmgr delete snapshot {<snapshot>[,<snapshot#2>,<snapshot#n>,...] | ALL}
delete => erase, remove, rm
snapshot => sn, ss

clmgr manage snapshot restore <snapshot>
manage => mg
snapshot => sn, ss

clmgr modify snapshot <snapshot>
         [ NAME="<new_snapshot_label>" ]
         [ DESCRIPTION="<snapshot_description>" ]
modify => change, set
snapshot => sn, ss

clmgr query snapshot <snapshot>[,<snapshot#2>,...]
clmgr -v query snapshot
query => get, list, ls, show
snapshot => sn, ss

clmgr view snapshot <snapshot>
         [ TAIL=<number_of_trailing_lines> ]
         [ HEAD=<number_of_leading_lines> ]
view => cat
snapshot => sn, ss


ログ
            
clmgr modify log {<log>}
         [ TRACE_LEVEL={default|medium|max} ]
modify => change, set

clmgr query log <log>[,<log#2>,<log#n>]
clmgr query -v log
query => get, list, ls, show

clmgr view log [ {<log>} ]
         [ TAIL=<number_of_trailing_lines> ]
         [ HEAD=<number_of_leading_lines> ]
view => cat

clmgr manage logs collect
         [ DIRECTORY="<directory_for_collection>" ] ¥
         [ NODES=<node>[,<node#2>,<node#n>,...] ]
manage => mg


ユーザー
	
clmgr add user <user_name>
         [ ID=<###|upto 4294967294> ]
         [ ADMINISTRATIVE={false|true} ]
         [ CHANGE_ON_NEXT_LOGIN={true|false} ]
         [ PRIMARY=<group> ]
         [ GROUPS=<group#1>[,<group#2>,...] ]
         [ ROLES=<role> ]
         [ Registry={local}]
         [ HOME=<full_directory_path> ]
         [ SHELL=<defined_in_/etc/shells> ]
         [ EXPIRATION=<days from epoch | YYYY-MM-DD> ]
         [ LOCKED={false|true} ]
         [ DAYS_TO_WARN={#|0} ]
         [ LOCKOUT_DELAY=<days_btwn_expiration_and_lockout> ]
         [ MAX_PASSWORD_AGE=<in days> ]
         [ MIN_PASSWORD_AGE=<in days> ]

clmgr add user <user_name>
         [ ID=<###|upto 4294967294> ]
         [ ADMINISTRATIVE={false|true} ]
         [ CHANGE_ON_NEXT_LOGIN={true|false} ]
         [ PRIMARY=<group> ]
         [ GROUPS=<group#1>[,<group#2>,...] ]
         [ ROLES=<role> ]
         [ Registry={ldap}]
	  [ DN=<Distinguished_name>]
         [ LDAP_PASSWORD={ldap_password} ]
         [ HOME=<full_directory_path> ]
         [ SHELL=<defined_in_/etc/shells> ]
         [ EXPIRATION=<days from epoch | YYYY-MM-DD> ]
         [ LOCKED={false|true} ]
         [ DAYS_TO_WARN={#|0} ]
         [ LOCKOUT_DELAY=<days_btwn_expiration_and_lockout> ]
         [ MAX_PASSWORD_AGE=<in days> ]
         [ MIN_PASSWORD_AGE=<in days> ]
add => create, make, mk
user => ur

clmgr delete user {<user_name>[,<user_name#2>,<user_name#n>,...]
         [ Registry={local}]}

clmgr delete user {<user_name>[,<user_name#2>,<user_name#n>,...] 
         [ Registry={ldap}] 
         [ DN=<Distinguished_name>] 
         [ LDAP_PASSWORD={ldap_password} ] }
delete => erase, remove, rm
user => ur

clmgr modify user <user_name>
         [ ID=<###|upto 4294967294> ]
         [ ADMINISTRATIVE={false|true} ]
         [ CHANGE_ON_NEXT_LOGIN={true|false} ]
         [ PRIMARY=<group> ]
         [ GROUPS=<group#1>[,<group#2>,...] ]
         [ ROLES=<role> ]
	  [ Registry={local}]
         [ HOME=<full_directory_path> ]
         [ SHELL=<defined_in_/etc/shells> ]
         [ EXPIRATION=<days from epoch | YYYY-MM-DD> ]
         [ LOCKED={false|true} ]
         [ DAYS_TO_WARN={#|0} ]
         [ LOCKOUT_DELAY=<days_btwn_expiration_and_lockout> ]
         [ MAX_PASSWORD_AGE=<in days> ]
         [ MIN_PASSWORD_AGE=<in days> ]

clmgr modify user <user_name>
         [ ID=<user id> ]
         [ ADMINISTRATIVE={false|true} ]
         [ CHANGE_ON_NEXT_LOGIN={true|false} ]
         [ PRIMARY=<group> ]
         [ GROUPS=<group#1>[,<group#2>,...] ]
         [ ROLES=<role> ]
         [ Registry={ldap}]
         [ DN=<Distinguished_name>]
         [ LDAP_PASSWORD={ldap_password} ]
         [ LDAP_USER_PASSWORD=<ldap_user_password> ]
         [ HOME=<full_directory_path> ]
         [ SHELL=<defined_in_/etc/shells> ]
         [ EXPIRATION=<days from epoch | YYYY-MM-DD> ]
         [ LOCKED={false|true} ]
         [ DAYS_TO_WARN={#|0} ]
         [ LOCKOUT_DELAY=<days_btwn_expiration_and_lockout> ]
         [ MAX_PASSWORD_AGE=<in days> ]
         [ MIN_PASSWORD_AGE=<in days> ] 
modify => change, set
user => ur

clmgr query user <user>[,<user#2>,...]
clmgr -v query user
query => get, list, ls, show
user => ur


グループ

clmgr add group <group_name>
          [ ID=<###|upto 4294967294> ]
          [ USERS=<user#1>[,<user#2>,...] ]
          [ Registry={local}]
          [ ADMINISTRATIVE={false|true} ]

clmgr add group <group_name>
          [ ID=<group id> ]
          [ USERS=<user#1>[,<user#2>,...] ]
          [ Registry={ldap}]
          [ ADMINISTRATIVE={false|true} ]
          [ DN=<Distinguished Name>]
          [ LDAP_PASSWORD={ldap_password} ] 
add => create, make, mk
group => gp

clmgr delete group {<group_name>[,<group_name#2>,<group_name#n>,...]
          [ Registry={local}]}

clmgr delete group {<group_name>[,<group_name#2>,<group_name#n>,...]
          [ Registry={ldap}]
          [ DN=<Distinguished_name>]
          [ LDAP_PASSWORD={ldap_password} ]}
delete => erase, remove, rm
group => gp

clmgr modify group <group_name>
          [ ID=<###|upto 4294967294> ]
          [ USERS=<user#1>[,<user#2>,...] ]
          [ Registry={local}]
          [ ADMINISTRATIVE={false|true} ]

clmgr modify group <group_name>
          [ ID=<group id> ]
          [ USERS=<user#1>[,<user#2>,...] ]
          [ Registry={ldap}]
          [ DN=<Distinguished Name>]
          [ ADMINISTRATIVE={false|true} ]
          [ LDAP_PASSWORD={ldap_password} ]
modify => change, set
group => gp

clmgr query group <group>[,<group#2>,...]
clmgr -v query group
query => get, list, ls, show
group => gp


同値
 	
clmgr query equivalency <equivalency_name>
query => get, list, ls, show


Logical_Volume

 clmgr query logical_volume <logical_volume>[,<logical_volume#2>,<logical_volume#n>,...]

 clmgr -v query logical_volume
 query => get, list, ls, show
 logical_volume => lv


NFS クライアント
	
clmgr add NFS_client
    	 <label>
    	 <REMOTE_DIR=Server:dir>
    	 <MOUNT_POINT= dir>
add => create, make, mk
	
clmgr delete NFS_client <label>
delete => erase, remove, rm

clmgr query nfs_client <nfs_client>[,<nc#2>,<nc#n>,...]
clmgr -v query nfs_client
query => get, list, ls, show


File_system

clmgr add file_system <file_system_name>
         TYPE={ext3|ext4}
         LOGICAL_VOLUME=lvname
         [ BLOCK_SIZE={1024|2048|4096} ]
         [ PERMISSIONS={ro|rw} ]
         [ OPTIONS={nosuid|nodev|all} ]

 clmgr add file_system <file_system_name>
         TYPE={xfs}
         LOGICAL_VOLUME=lvname
         [ BLOCK_SIZE={1024|2048|4096|8192|16384|32768|65536} ]
         [ PERMISSIONS={ro|rw} ]
         [ OPTIONS={nosuid|nodev|all} ]
add => create, make, mk
file_system => fs

clmgr query file_system <file_system>[,<fs#2>,<fs#n>,...]
clmgr -v query file_system
query => get, list, ls, show
file_system => fs

clmgr delete file_system {<file_system>[,<FS#2>,...] | ALL}
         [ REMOVE_MOUNT_POINT={false|true} ]
delete => erase, remove, rm
file_system => fs

clmgr reset file_system <file_system>
         [NODE=<node_name>]
file_system => fs


Smart Assist
変更情報の開始

clmgr add smart_assist APPLICATION={SAP_HANA}
         SID=<sid_value>
         INSTANCE=<HDB_instance_name>

clmgr add smart_assist APPLICATION={SAP_ABAP|SAP_JAVA}
         SID=<sid_value>
         INSTANCE=<SCS_instance_name>

clmgr add smart_assist APPLICATION={SAP_APPSERVER}
         SID=<sid_value>
         INSTALL_TYPE={ABAP|JAVA}
add => create, make, mk
smart_assist => sm, sa

clmgr delete smart_assist APPLICATION={SAP_HANA}
         SID=<sid_value>
         INSTANCE=<HDB_instance_name>
         [ DEL_POLICY={YES|NO} ]

clmgr delete smart_assist APPLICATION={SAP_ABAP|SAP_JAVA}
         SID=<sid_value>
         INSTANCE=<SCS_instance_name>
         [ DEL_POLICY={YES|NO} ]

clmgr delete smart_assist APPLICATION={SAP_APPSERVER}
         SID=<sid_value>
         INSTALL_TYPE={ABAP|JAVA}
         [ DEL_POLICY={YES|NO} ]
delete => erase, remove, rm
smart_assist => sm, sa

clmgr setup smart_assist APPLICATION={SAP_HANA}
         SID=<sid_value>
         INSTANCE=<HDB_instance_name>
         [ MODE={NEW|UPDATE} ]
         [ CONFIG={PERFORM_OPT|ACTIVE_ACTIVE|COST_OPT} ]

clmgr setup smart_assist APPLICATION={SAP_ABAP|SAP_JAVA}
         SID=<sid_value>
         INSTANCE=<SCS_instance_name>
         [ MODE={NEW|UPDATE} ]

clmgr setup smart_assist APPLICATION={SAP_APPSERVER}
         SID=<sid_value>
         INSTALL_TYPE={ABAP|JAVA}
         [ MODE={NEW|UPDATE} ]
smart_assist => sm, sa

clmgr update smart_assist APPLICATION={SAP_HANA}
         SID=<sid_value>
         INSTANCE=<HDB_instance_name>

clmgr update smart_assist APPLICATION={SAP_ABAP|SAP_JAVA}
         SID=<sid_value>
         INSTANCE=<SCS_instance_name>

clmgr update smart_assist APPLICATION={SAP_APPSERVER}
         SID=<sid_value>
         INSTALL_TYPE={ABAP|JAVA}
smart_assist => sm, sa

clmgr query smart_assist <policy>[,<policy#2>,<policy#n>]
clmgr query -v smart_assist
query => get, list, ls, show
smart_assist => sm, sa


変更情報の終了

例: 大/小文字の区別

詳細

clmgr コマンドのクラス属性には大/小文字の区別はありません。例えば、以下のコマンドの場合、NODES 属性は NODESnodes、または Nodes のいずれでも構いません。このクラスターは、2 つのノードから構成されるクラスターです。クラスター名は cluster1 で、ノードの名前は nodeA および nodeB です。

clmgr create cluster clMain NODES=nodeA,nodeB

例: クラスターの作成

詳細

このクラスターは、2 つのノードから構成されるクラスターです。クラスター名は cluster1 で、ノードの名前は node1 および node2 です。


clmgr create cluster cluster1 NODES=node1, node2

例: リソース・グループの作成

詳細

このリソース・グループは、デフォルトのポリシーを使用して作成された非コンカレント・リソース・グループで、名前は RG1 です。このリソース・グループには、access1 という名前のサービス IP アドレスと、app1という名前のアプリケーションが含まれています。


clmgr add resource_group RG1 SERVICE_IP=access1
      APPLICATIONS=app1 FILESYSTEM=fs1
      

例: 状況の確認

詳細

指定されたオブジェクトの状態を確認して、適切なアクションを実行できるようにするには、以下の clmgr query コマンドを使用します。

  • clmgr -a STATE query cluster
    
  • clmgr -a STATE query node nodeA
  • clmgr -a STATE query resource_group rg1
  • clmgr -a STATE query node nodeA
    
  • clmgr -a STATE query resource_group rg1
注:
  • CLASS オブジェクトがクラスターの場合、返される STATE 値は、クラスター内のすべてのノードについて予想される最悪の状況です。 例えば、4 つのノードから構成されるクラスターにおいて 1 つのノードでエラーが発生している場合、そのクラスターの STATE 値は ERROR になります。
  • clmgr -a STATE query コマンドの実行後に返される値は、標準の ATTR=VALUE 形式 (例えば、STATE=OFFLINE) です。 値のみが必要な場合は、他のフラグと -a フラグを組み合わせることができます。-cSa コマンドを指定した場合、VALUE (OFFLINE など) のみが返されます。このオプションは、一度に 1 つの値についてのみ有効です。
  • -a フラグを使用して (-a NAME, STATE など)、複数の属性を一度に取得することができます。-a フラグには大/小文字の区別がありません。例えば、clmgr コマンドでは、clmgr -a Name, state の構文が許容されます。-a フラグは、ワイルドカード文字 (アスタリスク (*) や疑問符 (?) など) をサポートします。

例: すべての属性および設定の表示

詳細

PowerHA SystemMirror for Linux ソフトウェアで問題が発生した場合は、クラスターの内容 (設定を含む) を確認する必要があります。 クラスターを表示するには、オプションを指定して clmgr query コマンドを使用することで、特定の形式 (コロン区切り形式や XML 形式など) を要求することができます。以下のコマンド例ではリソース・グループを使用していますが、すべてのオブジェクト・クラスに同じ規則が適用されます。

  • clmgr query resource_group
    
  • clmgr query resource_group rg1,rg2
    
  • clmgr -c query resource_group rg1,rg2
    
  • clmgr -x query resource_group rg1,rg2
    
  • clmgr -v query resource_group
    
  • clmgr -cv query resource_group
    
  • clmgr -xv query resource_group
注:
  • query オプションでターゲット・オブジェクトを指定せず、-v 詳細フラグを使用しない場合、単純なオブジェクト・リストが表示されます。
  • query オプションで 1 つ以上のターゲット・オブジェクトを指定した場合、それらのオブジェクトの既知の属性または設定がすべて表示されます。 この query オプションは、 -v フラグをオーバーライドします。
  • -v フラグを query オプションで使用すると、指定のクラスのすべての既知のオブジェクトの既知の属性または設定がすべて表示されます。
  • 詳細な属性または設定は、デフォルトでは ATTR=VALUE 形式で 1 行に 1 つずつ表示されます。 -c フラグを指定した場合、すべての値がコロン区切り形式で 1 行に表示されます。 -x フラグを指定した場合、すべての属性および値が単純な XML 形式で表示されます。

例: 何らかのフィルターまたは基準に基づくオブジェクトの表示

詳細

指定されたクラスに対して多数のオブジェクト (リソース・グループなど) が定義されている場合、あるいは指定されたクラス内で多数の設定が定義されている場合は、情報の検索が困難になります。 そのため、clmgr コマンドでは、query アクションを使用してフィルタリング基準を指定することができます。

clmgr query resource_group CURRENT_NODE=`get_local_nodename`
注:
  • この例では、動的値に一致するオブジェクトを見つける方法を示しています。このケースでは、コマンドはローカル・ノード上で現在実行中のすべてのリソース・グループのリストの取得方法を示しています。
  • このフィルタリング機能を -a フラグと組み合わせて使用することで、強力かつ柔軟なデータ取得を実現することができます。

例: clmgr コマンドの簡素化

詳細

clmgr コマンドでは、使用方法を容易にするために、大/小文字を区別するフラグや属性は一切使用しません。 すべてのアクションクラス属性、またはオプションは、明示的に指定されたエイリアス (online に代わり startresource_group に代わり rg など)、または固有のものとして識別できる最小数の文字に短縮することができます。以下のコマンドのペアは、機能的に同じものです。

  • 
    clmgr query resource_group
    clmgr q rg
    
  • clmgr online node nodeA
    clmgr start node nodeA
注: アクションおよびクラスの短縮は、clmgr コマンドを端末内で対話式に使用する場合のためのものです。 これらの省略形はスクリプトでも使用できますが、スクリプトを読みやすく保守しやすいコードにするために、スクリプトではアクションとクラスの両方に完全な名前を使用することが強く推奨されます。

例: clmgr コマンドのヘルプ情報

詳細

clmgr コマンドについて、常にオンライン・ヘルプ・オプションが使用可能です。clmgr コマンドが提供する組み込みのヘルプを使用することもできます。既知のオブジェクトまたは値のセットからのオブジェクトまたは値が必要な場合は、ヘルプ・オプションを使用することができます。 無効なオブジェクトまたは値を指定した場合は、エラー・メッセージと、その操作に有効なオブジェクトあるいは値のリストが表示されます。 ヘルプ・オプションを使用して、必要なアクション、クラス、またはオブジェクトを判別することができます。 clmgr コマンドには、以下のヘルプ・オプションが備わっています。

  • clmgr
    
  • clmgr add
    
  • clmgr add application
    
  • clmgr add application -h
注: オブジェクト・クラスまたはオプション・ペアのセットの後に -h フラグを指定すると、その特定の操作に有効なすべてのオプションのリストが表示されます。 -h フラグは、clmgr コマンドにおいて、clmgr コマンドの直後に指定する必要がない唯一のコマンドです。