形式
jpchasetup create サービスキー
-lhost 論理ホスト名
[-d 環境ディレクトリ名]
機能
jpchasetup createコマンドは,Performance Managementの論理ホスト環境を作成するコマンドです。
このコマンドを実行すると,論理ホストの環境がセットアップされます。
このコマンドは,論理ホスト運用に対応したPerformance Managementでだけ実行できます。PFM - Managerは論理ホスト運用に対応しています。PFM - Agentの論理ホスト運用については,各PFM - Agentマニュアルの,クラスタシステムでの運用について説明している章を参照してください。
コマンドを実行できるホスト
実行権限
格納先ディレクトリ
引数
サービスキー
論理ホスト環境を作成するPerformance Managementプログラムのサービスのサービスキーを指定します。
指定できるサービスキーを次に示します。
Action Handlerサービスのサービスキーactは指定できません。
サービスキーにmgrまたはPFM - Agentサービスのサービスキーを指定すると,そのPerformance Managementプログラムのサービスの論理ホスト環境を作成します。
サービスキーにallを指定すると,そのノードにインストールされていて,論理ホスト起動に対応しているすべてのPerformance Managementプログラムのサービスについて,論理ホスト環境を作成します。論理ホスト起動に対応していないPerformance Managementプログラムのサービスのサービスキーを指定するとエラーになります。
なお,このコマンドを実行すると,Action Handlerサービスが論理ホストごとに一つになるように,自動的に論理ホスト環境が作成されます。
-lhost 論理ホスト名
作成する論理ホスト環境の論理ホスト名を指定します。
1~32バイトの半角英数字で指定します。次の記号および空白文字は指定できません。
/ ¥ : ; * ? ' " < > | & = ,
論理ホスト名に,"localhost",IPアドレス,"-"から始まるホスト名は指定できません。
指定した論理ホスト名は,論理ホストのPerformance Managementプログラムのサービスが通信するときのホスト名として使われます。
-d 環境ディレクトリ名
論理ホストの実行環境を作成するディレクトリを指定します。環境ディレクトリ名は,論理ホスト環境のファイルを格納するディレクトリの名称です。フェールオーバー時にファイルが引き継げるよう,クラスタソフトが管理する共有ディスク上にあるディレクトリ名を指定してください。クラスタソフトが管理する共有ディスク上にないディレクトリを指定した場合,処理は実行されません。新しい論理ホスト環境を作る場合は必ず指定してください。既存の論理ホスト環境にサービスを追加する場合は省略できます。
1~80バイトで指定します。半角英数字または半角記号で指定します。ただし,次の記号は指定できません。
; , * ? ' " < > |
ディレクトリ名は,相対パスでは指定できません。必ず絶対パスで指定してください。
コマンドを実行すると,指定したディレクトリの下に,jp1pcというディレクトリを作成し,そのディレクトリに論理ホスト環境のファイルを作成します。
論理ホストには,環境ディレクトリを一つだけ指定できます。複数のPerformance Managementプログラムのサービスを,一つの論理ホストにセットアップする場合は,同じディレクトリを使用してください。
UNIX環境では,半角空白文字を指定できません。Windows環境で半角空白文字を含めた環境ディレクトリ名を指定する場合," "で囲んでください。
注意事項
戻り値
0 | 正常終了した。 |
0以外 | 異常終了した。 |
使用例
論理ホスト名をjp1-ha1,環境ディレクトリ名をS:¥jp1として,PFM - Managerの論理ホスト環境をセットアップする場合のコマンドの実行例を次に示します。
jpchasetup create mgr -lhost jp1-ha1 -d S:¥jp1