gpdefclone(定義ファイル複製コマンド)(Linux・AIX)
形式
gpdefclone -h 複製先ホスト名[%サービスグループ名][@{jm | nm | all}] -i 複製元ホスト名 [ -o 定義ファイル管理ディレクトリ ]
機能
定義ファイル管理ディレクトリ内の指定されたホストの定義ファイルを複製して,作成したいホスト名の内容で定義します。このコマンドで定義ファイル管理ディレクトリ以下に作成できるホスト数は最大100台です。
オプション
- -h 複製先ホスト名[%サービスグループ名][@{jm | nm | all}]〜<識別子>((1〜31文字))
-
定義ファイルを作成したいホスト名を指定します。識別子に使用できる文字は英数字,ピリオド,およびハイフンです。ただし,先頭文字にハイフンは指定しないでください。複製先ホスト名にIPアドレスの形式は指定しないでください。なお,複製先ホスト名は,/etc/hostsファイルまたはDNSなどでIPアドレスのマッピングができる必要があります。また,複製先ホスト名には,localhostまたはループバックアドレスなどの127で始まるIPアドレス(例:127.0.0.1)とマッピングされているホスト名を指定しないでください。指定するホスト名は,-oオプションで指定するディレクトリ内に存在しないホスト名(ディレクトリ名)としてください。
サービスグループ名には,複製先ホストのノードマネージャSPPのサービスグループ名を指定します。サービスグループ名には,31文字までの識別子を指定できます。識別子に使用できる文字は英数字とアンダースコアです。ただし,先頭文字はアルファベットから始まっている必要があります。また,サービスグループ名はシステム内でユニークな名称を指定する必要があります。ホスト名とサービスグループ名の間はパーセント記号(%)で連結して指定してください。このとき,パーセント記号の前後に空白は指定しないでください。サービスグループ名の指定を省略した場合は複製先ホスト名をサービスグループ名と仮定して動作します。サービスグループ名は実行ノードまたは兼用ホストを複製するときに使用するオプションです。管理ホストの定義を複製するときにサービスグループ名を指定することはできません。
ホスト種別は,複製元ホストが兼用ホストの場合に複製先ホストの種別を指定するためのオプションです。ホスト種別には,次の表に示すどれかを指定します。ホスト名またはサービスグループ名とホスト種別の間はアットマーク(@)で連結して指定してください。このとき,アットマークの前後に空白は入力しないでください。ホスト種別は複製元ホストが兼用ホストの場合だけ指定することができます。ただし,定義ファイル管理ディレクトリ内の定義が兼用ホストだけの構成の場合は複製先ホストのホスト種別に管理ホストおよび兼用ホストを指定することはできません。ホスト種別を省略した場合は実行ノードとして複製されます。
ホスト種別
説明
jm
管理ホストとして使用するホストに指定します。
管理ホストを構成するコンポーネントは,グリッドクライアント,ジョブマネージャ,データマネージャです。
nm
実行ノードとして使用するホストに指定します。
実行ノードを構成するコンポーネントは,ノードマネージャです。
all
管理ホストと実行ノードを兼用するホストに指定します。
兼用するホストを構成するコンポーネントは,グリッドクライアント,ジョブマネージャ,データマネージャ,ノードマネージャです。
ホスト種別を指定した場合に複製されるホストのホスト種別の組み合わせを次の表に示します。
複製元ホストのホスト種別
ホスト種別
オプション
複製先ホストのホスト種別
実行ノード
−
(指定不可)
実行ノードとして複製します。
実行ノードを構成するコンポーネントは,ノードマネージャです。
管理ホスト
−
(指定不可)
管理ホストとして複製します。
管理ホストを構成するコンポーネントは,グリッドクライアント,ジョブマネージャ,データマネージャです。
兼用ホスト
jm
管理ホストとして複製します。
管理ホストを構成するコンポーネントは,グリッドクライアント,ジョブマネージャ,データマネージャです。
nm
または省略
実行ノードとして複製します。
実行ノードを構成するコンポーネントは,ノードマネージャです。
all
管理ホストと実行ノードを兼用するホストとして複製します。
兼用するホストを構成するコンポーネントは,グリッドクライアント,ジョブマネージャ,データマネージャ,ノードマネージャです。
- -i 複製元ホスト名〜<識別子>((1〜31文字))
-
複製元となるホスト名を指定します。複製元ホスト名にIPアドレスの形式は指定しないでください。-oオプションで指定するディレクトリ内に存在するホスト名(ディレクトリ名)を指定してください。
- -o定義ファイル管理ディレクトリ
-
複製元ホストの定義ファイルが格納されている定義ファイル管理ディレクトリをフルパスで指定します。定義ファイル生成(gpdefgen)コマンドの-oオプションで指定したディレクトリを指定してください。ルートディレクトリ(/)は指定しないでください。このオプションを省略した場合は,デフォルト値(/opt/hitachi/ugpsm/etc)が仮定されます。
このオプションで指定したディレクトリ以下に,-hオプションで指定したホスト名のディレクトリを作成し,作成したディレクトリ以下に複製した定義ファイル一式を出力します。
戻り値
戻り値 |
内容 |
出力メッセージ |
|
---|---|---|---|
0 |
正常終了 |
KAKJ1561-I※1 |
処理が正常終了しました。 |
1〜31 |
内部エラー |
KAKJ1903-E |
プログラム論理エラーが発生しました。 |
32〜47 |
パラメータエラー |
KAKJ1700-E※2 |
コマンドの形式が不正です。 |
KAKJ1737-E |
オプションの指定値が不正です。 |
||
48〜 |
その他のエラー |
KAKJ1500-E |
不正なシステム構成です。 |
KAKJ1501-E |
ディレクトリがフルパスで指定されていません。 |
||
KAKJ1504-E |
定義ファイル管理ディレクトリの内容が不正です。 |
||
KAKJ1506-E |
OSコマンドの実行に失敗しました。 |
||
KAKJ1522-E |
指定したホストの定義ファイルがすでに存在します。 |
||
KAKJ1523-E |
指定したホストの定義ファイルは複製できません。 |
||
KAKJ1524-E |
構成可能ホスト数の上限を超えました。 |
||
KAKJ1527-E |
指定したホストの定義ファイルは存在しません。 |
||
KAKJ1542-E |
ディレクトリの作成に失敗しました。 |
||
KAKJ1556-E |
定義ファイルの操作に失敗しました。 |
||
KAKJ1599-E |
指定されたサービスグループ名はほかのホストですでに使用されています。 |
||
KAKJ1713-E |
ファイルが存在しません。 |
||
KAKJ1714-E |
ディレクトリが存在しません。 |
表示形式
このコマンドを実行した場合の出力イメージを次に示します。HOST01は管理ホストのホスト名です。
注意事項
-
このコマンドで複製したホストの定義ファイルの次のオペランドは,必要に応じて手動で変更してください。
定義ファイル
オペランド
このコマンドで出力する定義内容
ノードマネージャSPPのユーザサービス定義(UGPSMndm)
service_group
複製先ホスト名として指定された名前※またはサービスグループ名に指定された名称
-
複製先ホストのホスト種別が実行ノードまたは兼用ホストである。
-
複製先ホスト名としてピリオド,ハイフンを含む名称,または数字から始まる名称を指定している。
-
-hオプションでサービスグループ名を指定していない。
-
複製元のホストでノードマネージャSPPの複数面化を行っている場合,複数面化した定義ファイルは複製先に生成されません。このため,複製先のホストで複数面化を行う場合,生成されたディレクトリ内のノードマネージャSPPの定義ファイル(UGPSMndm)を手作業で複製して作成してください。このとき,複製した定義ファイルの名称(ユーザサーバ名)はディレクトリ内でユニークな名称とし,定義ファイル内のservice_groupオペランド(サービスグループ名)はシステム内でユニークな名称に変更してください。
-
定義ファイル複製後,複製したホストの環境構築に加えて,次に示すホストも再度環境構築を実施する必要があります。再度環境構築が必要なホストは,複製先ホストのホスト種別とシステム構成によって異なります。
複製先ホストのホスト種別
再度環境構築が
必要なホスト
理由
管理ホストまたは兼用ホスト
すべての実行ノード
実行ノードのシステム共通定義(betranrc)のall_nodeオペランドに複製したホスト名が追加されるため。
複製先ホスト以外の管理ホストまたは兼用ホスト
(複製前のシステム構成に含まれる管理ホストおよび兼用ホストの定義が1台だけの場合)
設定ファイル(ugpsm.conf)のSHARED_EXECUTION_NODEパラメータを変更するため。
実行ノード
すべての管理ホストおよび兼用ホスト
管理ホストおよび兼用ホストのシステム共通定義(betranrc)のall_nodeオペランドに複製したホスト名が追加されるため。
-
2つ以上同時にこのコマンドを実行しないでください。
-
このコマンド実行中は-oオプションで指定したディレクトリ以下のファイルの操作をしないでください。