jpcconf ha setup

〈このページの構成〉

形式
機能
コマンドを実行できるホスト
実行権限
格納先ディレクトリ
引数
注意事項
戻り値
使用例

形式

jpcconf ha setup    -key サービスキー
                    -lhost 論理ホスト名
                    [-d 環境ディレクトリ名]

ページの先頭へ

機能

jpcconf ha setupコマンドは，Performance Managementの論理ホスト環境を作成するコマンドです。

このコマンドを実行すると，論理ホストの環境がセットアップされます。

このコマンドは，論理ホスト運用に対応したPerformance Managementでだけ実行できます。PFM - Managerは論理ホスト運用に対応しています。PFM - AgentまたはPFM - RMの論理ホスト運用については，各PFM - AgentまたはPFM - RMマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

ページの先頭へ

コマンドを実行できるホスト

PFM - Manager
PFM - Agent
PFM - RM

ページの先頭へ

実行権限

Windowsの場合: Administrators権限を持つユーザー
UNIXの場合: rootユーザー権限を持つユーザー

ページの先頭へ

格納先ディレクトリ

Windowsの場合: インストール先フォルダ\tools\
UNIXの場合: /opt/jp1pc/tools/

ページの先頭へ

引数

-key サービスキー

論理ホスト環境を作成するPerformance Managementプログラムのサービスのサービスキーを指定します。プロダクト名表示機能が有効な場合はプロダクト名でも指定できます。

指定できるサービスキーを次に示します。

all：そのノードにインストールされている，論理ホスト運用に対応したすべてのPerformance Managementプログラムのサービスが設定されます。
Managerまたはmgr：PFM - Managerのサービス（Action Handlerサービスを含む）が設定されます。
PFM - AgentまたはPFM - RMのサービスのサービスキー：PFM - AgentまたはPFM - RMの各サービス（Action Handlerサービスを含む）が設定されます。PFM - AgentまたはPFM - RMのサービスのサービスキーについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，命名規則について説明している個所を参照してください。

Action HandlerサービスのサービスキーAHまたはactは指定できません。

サービスキーに次に示すどれかを指定すると，そのPerformance Managementプログラムのサービスの論理ホスト環境の設定を表示します。

Managerまたはmgr
PFM - Agentのサービスのサービスキー
PFM - RMのサービスのサービスキー

サービスキーにallを指定すると，そのノードにインストールされていて，論理ホスト起動に対応しているすべてのPerformance Managementプログラムのサービスについて，論理ホスト環境を作成します。論理ホスト起動に対応していないPerformance Managementプログラムのサービスのサービスキーを指定するとエラーになります。

なお，このコマンドを実行すると，Action Handlerサービスが論理ホストごとに1つになるように，自動的に論理ホスト環境が作成されます。

-lhost 論理ホスト名

作成する論理ホスト環境の論理ホスト名を指定します。

1〜32バイトの半角英数字で指定します。次の記号および空白文字は指定できません。

　/ \ : ; * ? ' " < > | & = ,

論理ホスト名に，"localhost"，IPアドレス，"-"から始まるホスト名は指定できません。

指定した論理ホスト名は，論理ホストのPerformance Managementプログラムのサービスが通信するときのホスト名として使われます。

-d 環境ディレクトリ名

論理ホストの実行環境を作成するディレクトリを指定します。環境ディレクトリ名は，論理ホスト環境のファイルを格納するディレクトリの名称です。フェールオーバー時にファイルが引き継げるよう，クラスタソフトが管理する共有ディスク上にあるディレクトリ名を指定してください。存在しないディレクトリを指定した場合はエラーとなり，処理は実行されません。新しい論理ホスト環境を作る場合は必ず指定してください。既存の論理ホスト環境にサービスを追加する場合は省略できます。

1〜80バイトで指定します。半角英数字または半角記号で指定します。ただし，次の記号は指定できません。

　; , * ? ' " < > |

ディレクトリ名は，相対パスでは指定できません。必ず絶対パスで指定してください。

コマンドを実行すると，指定したディレクトリの下に，jp1pcというディレクトリを作成し，そのディレクトリに論理ホスト環境のファイルを作成します。

論理ホストには，環境ディレクトリを1つだけ指定できます。複数のPerformance Managementプログラムのサービスを，1つの論理ホストにセットアップする場合は，同じディレクトリを使用してください。

UNIX環境では，半角空白文字を指定できません。Windows環境で半角空白文字を含めた環境ディレクトリ名を指定する場合，" "で囲んでください。

ページの先頭へ

注意事項

共有ディスク上に論理ホスト環境のファイルが作成されるため，論理ホスト環境を作成するときは，共有ディスクをオンラインに（UNIXの場合はマウント）してからこのコマンドを実行してください。存在しないディレクトリを指定した場合，コマンドはエラーとなり，作成の要求はキャンセルされます。この場合，論理ホスト環境は作成されません。共有ディスクをマウントしていない場合でも，ローカルディスク上に同じ階層で同名のディレクトリが存在する場合，ローカルディスク上の指定ディレクトリに環境が作成されるため，注意してください。
このコマンドを実行する前に，ノード上の物理ホストおよび各論理ホストを含むすべてのPerformance Managementプログラムのサービスを停止してください。
Windows環境では，環境ディレクトリに作成されるjp1pcディレクトリおよび論理ホスト環境のファイルに上位ディレクトリのアクセス権限が継承されます。
コマンドの実行をCtrl+Cキーやシグナルで中断した場合，特定の戻り値が返りません。そのため，コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。
PFM - Managerの論理ホスト環境を作成した場合，物理ホスト環境のPFM - Managerで設定したヘルスチェック機能の有効・無効に関わらず，論理ホスト環境のPFM - Managerのヘルスチェック機能は無効（デフォルト）となります。論理ホスト環境のPFM - Managerでヘルスチェック機能を使用する場合，再度論理ホスト環境のPFM - Managerに対してヘルスチェック機能のセットアップが必要です。
監視ホスト名設定機能を使用している場合（jpccomm.iniファイルの[Common Section]セクションのGet Host Modeの値が「1」または「2」の場合），監視ホスト名に設定しているホスト名と同一名称の論理ホスト名は設定できません。
監視一時停止機能を有効にしている場合，PFM - Managerの論理ホスト環境を作成するときは，このコマンドを実行する前にノード上の物理ホストおよび各論理ホストを含むすべてのPerformance Managementプログラムの監視を再開してください。
監視一時停止機能を有効にしている場合，PFM - Agentの論理ホスト環境を作成したときは，物理ホスト環境の監視一時停止の設定は引き継がれません。

ページの先頭へ

戻り値

0	正常終了した。
0以外	異常終了した。

ページの先頭へ

使用例

論理ホスト名をjp1-ha1，環境ディレクトリ名をS:\jp1として，PFM - Managerの論理ホスト環境をセットアップする場合のコマンドの実行例を次に示します。

jpcconf ha setup -key Manager -lhost jp1-ha1 -d S:\jp1

ページの先頭へ