gpmgrsetup（環境構築/削除コマンド）（Linux・AIX）

形式

gpmgrsetup [ -h セットアップ対象ホスト名[@物理ホスト名] [ ,セットアップ対象ホスト名[@物理ホスト名] ] ...]

-u uGPS管理者名 [ -g uGPSグループ名 ] [ -o 定義ファイル管理ディレクトリ ] { -n | -c | -m | -d }

ページの先頭へ

機能

gpdefgenコマンドで作成した内容に従って，各サーバの実行環境やデーモンの自動起動の設定を行います。または，構築した環境の削除およびデーモンの自動起動の設定解除を行います。

リモートホストに対して環境を構築する場合，コマンド実行ユーザの名前でリモートログインし，定義ファイルの転送および環境構築を行います。

ページの先頭へ

オプション

-h セットアップ対象ホスト名[@物理ホスト名]〜＜識別子＞((1〜31文字))

環境構築または削除対象とするホスト名を指定します。セットアップ対象のホスト名には，gpdefgenコマンドまたはgpdefcloneコマンドの-hオプションで指定したホスト名を指定してください。

セットアップ対象のホスト名に論理ホスト名を指定し，物理ホスト名も指定した場合は，物理ホスト名に指定したホストがセットアップ対象と判断され，環境構築または削除が実行されます。セットアップ対象のホスト名と物理ホスト名の間はアットマーク（@）で連結してください。このとき，アットマークの前後に空白は入力しないでください。また，このコマンドで一度に指定できるホスト情報（セットアップ対象ホスト名[@物理ホスト名]）の最大数は40です。複数のセットアップ対象のホストを指定する場合は，コンマ（,）で区切って指定してください。このとき，前後に空白を入力しないでください。なお，区切り文字「,」は，次のとおり特殊文字として扱います。

• １つの区切り位置に区切り文字を複数個指定しても，１つの区切り文字として扱います。

  例：-h HOST01,,NODE01,,,NODE02

• 値の前後に区切り文字を指定しても，その区切り文字は無視します。

  例：-h ,,HOST01,NODE01,NODE02,,,

セットアップ対象のホスト名および物理ホスト名にIPアドレスは指定できません。なお，セットアップ対象のホスト名および物理ホスト名は，/etc/hostsファイルやDNSなどでIPアドレスのマッピングができる必要があります。また，セットアップ対象のホスト名および物理ホスト名には，localhostやループバックアドレスなどの127で始まるIPアドレス（例：127.0.0.1）とマッピングされているホスト名は指定しないでください。

このオプションを省略した場合，-oオプションで指定した定義ファイル管理ディレクトリ以下にあるディレクトリの名称をセットアップ対象ホスト一覧として設定します。

このオプションに自ホストだけを指定すると，リモート接続が実行されないで，ローカルホストの環境構築ができます。この場合，gpdefgenコマンドの-oオプションで指定して作成したディレクトリ全体を，ローカルホストが参照できる場所に手動で配置しておく必要があります。

-u uGPS管理者名

uGPS管理者のユーザ名を指定します。このオプションで指定したユーザでサーバ実行環境を構築または削除します。コマンド実行ユーザがスーパーユーザでない場合，このオプションにはコマンド実行ユーザ名を指定してください。

-g uGPSグループ名

uGPSグループ名を指定します。このオプションで指定したグループでサーバ実行環境が構築されます。指定を省略した場合，実行環境を構築するホストのuGPS管理者のプライマリグループが設定されます。

-o定義ファイル管理ディレクトリ

環境構築または削除対象とするホストの定義ファイルを格納したディレクトリを，フルパスで指定します。gpdefgenコマンドの-oオプションで指定したディレクトリを指定してください。ルートディレクトリ（/）は指定しないでください。指定を省略した場合は，デフォルト値（/opt/hitachi/ugpsm/etc）が仮定されます。

-n

環境構築されていないホストに対して，新規に環境構築する場合に指定します。サーバ実行環境の構築およびデーモンの自動起動の設定が実行されます。

-c

環境構築済みのホストの定義ファイル一式を，-oオプションで指定したディレクトリ配下にあるセットアップ対象のホストの内容に更新する場合に指定します。

-m

環境構築済みのホストで，uGPSのモジュールを更新する場合に指定します。uGPSをバージョンアップした場合などに使用します。

-d

環境構築済みのホストから環境を削除する場合に指定します。サーバ実行環境の削除およびデーモンの自動起動の設定解除が実行されます。

ページの先頭へ

表示形式

このコマンドを次の条件で実行した場合の出力例を示します。

条件：

• 3台のホスト（管理ホスト1台，実行ノード2台）に新規に環境を構築する

• コマンド実行ユーザはuGPS管理者である

• コマンド実行ホストは管理ホスト（HOST01）であり，定義ファイル管理ディレクトリも管理ホストに存在する

  

ページの先頭へ

戻り値

ページの先頭へ

注意事項

• このコマンドは，uGPS管理者またはスーパーユーザが実行してください。

• このコマンドを実行する前に，必ずセットアップ対象ホストのシステムサーバおよびデーモンを停止してください。

• 環境の構築または削除対象とするホストが複数ある場合，あるホストの環境構築または削除でエラーとなっても，次のホストへの環境構築または削除は続行されます。

• このコマンドは，2つ以上同時に実行しないでください。

• このコマンド実行中は，-oオプションで指定したディレクトリ以下にあるファイルは操作しないでください。

• このコマンドの実行時，OSが提供するsshコマンドまたはrshコマンドのメッセージが出力される場合があります。出力されたメッセージに従って対処してください。

• このコマンドの実行時，OSが提供するsudoコマンド（Linuxの場合）またはsuコマンド（AIXの場合）のメッセージが出力される場合があります。出力されたメッセージに従って対処してください。

• -hオプションに物理ホスト名を指定して，クラスタ構成のホストを環境構築または削除する場合，どちらのホストも共有ディレクトリをマウントした状態でコマンドを実行する必要があります。ほかのプログラムの制約などで両ホストから共有ディレクトリにアクセスできる状態とできない場合は，片方ずつ環境を構築または削除してください。

• -hオプションを省略して-dオプションを指定してコマンドを実行すると，定義ファイル管理ディレクトリ以下のディレクトリ名と同じ名称のすべてのホストが環境削除の対象となります。同様に，-n，-c，および-mオプションでも-hオプションを省略した場合は，すべてのホストが処理対象となります。

• -hオプションで複数のホスト情報を指定する場合，同じ名称の物理ホスト名は同時に指定できません。ただし，物理ホスト名を省略している場合には，セットアップ対象ホスト名を物理ホスト名として使用します。

ページの先頭へ