Hitachi

uCosminexus Grid Processing Server 使用の手引


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

ディレクトリが存在しません。

注※1 サービスグループ名の省略時,複製先ホスト名にサービスグループ名として指定できない名称が指定された場合には,警告を示すKAKJ1598-Wが出力されます。

注※2 パラメータエラー時には,使用方法を示すKAKJ1773-Iが出力されます。

表示形式

このコマンドを実行した場合の出力イメージを次に示します。HOST01は管理ホストのホスト名です。

[図データ]

注意事項