gpstart（システムサーバ起動コマンド）（Linux・AIX）
形式
gpstart [ -n ] [ -U ] [ -h 実行ホスト名 ] [ uGPSディレクトリ ]
機能
グリッドジョブ管理ホスト，実行ノード，グリッドプロパティ管理ホスト上でコマンドを実行することで，各ホストまたは実行ノード上で動作するサーバ（ユーザサーバ含む）を起動します。
オプション
- -n
-
前回の終了状態が異常終了（gpstopの-fオプションで強制的に停止した場合も含む）であっても，システムサーバを強制的に正常開始します。
このオプションの指定および前回の終了状態に従って，次に示す開始方法が設定されます。
前回の終了状態
-nオプションの設定
あり
なし
正常終了※
正常開始
正常開始
正常終了以外
正常開始
前回の処理内容を引き継いで再開始
注※ gpstopコマンドの-nオプションで強制終了した場合も含みます。
- -U
-
このオプションを指定した場合，再開始時にユーザサーバを起動しません。このオプションは，障害が発生し，uGPSの状態を回復するためにuGPSのシステムサーバを起動する必要はありますが，ユーザサーバは起動する必要がない場合などに使用してください。
- -h 実行ホスト名〜((1〜31文字))
-
このコマンドを実行するホスト名（またはIPアドレス）を指定します。ホスト名を指定する場合は，/etc/hostsファイルやDNSなどでIPアドレスとマッピングできることが条件となります。指定を省略した場合は，自ホストでこのコマンドを実行します。また，指定したホストへのログインユーザ名は，このコマンドを実行したユーザ名となります。
- uGPSディレクトリ
-
uGPSディレクトリを指定します。
このオプションの指定とGPDIR環境変数の設定に従って，次のとおりuGPSディレクトリの値が設定されます。
GPDIR環境変数の設定
このオプションの指定
あり
なし
あり
このオプションの指定値
GPDIR環境変数の値※
なし
このオプションの指定値
デフォルト値（/var/opt/ugpsm）
注※ -hオプションを指定した場合，自ホストのGPDIR環境変数が設定されます。
戻り値
|
戻り値 |
内容 |
出力メッセージ |
|
|---|---|---|---|
|
0 |
正常終了 |
なし。 |
|
|
1※ |
不当オプションの指定 |
KAKJ1700-E |
オプションの指定に誤りがあります。 |
|
2 |
-hオプションの指定値不正 |
KAKJ1737-E |
オプションの指定値に誤りがあります。 |
|
3 |
uGPSディレクトリに設定された内容が不正 |
KAKJ1501-E |
指定したディレクトリがフルパス指定ではありません。 |
|
KAKJ1559-E |
uGPSディレクトリが不正です。 |
||
|
KAKJ1714-E |
ディレクトリが存在しませんでした。 |
||
|
4 |
コマンドの処理で使用するファイルが存在しない |
KAKJ1713-E |
ファイルが存在しませんでした。 |
|
5 |
内部で呼び出すコマンドでエラーが発生 |
KAKJ1510-E |
システムサーバの起動処理でエラーが発生しました。 |
|
KAKJ1511-E |
システムサーバはすでに起動しています。 |
||
|
KAKJ1512-E |
サーバ定義の不正を検出しました。 |
||
|
KAKJ1736-E |
メモリ不足が発生しました。 |
||
|
KAKJ1738-E |
コマンドの実行でエラーが発生しました。 |
||
|
6 |
リモートホストでの実行に失敗 |
KAKJ1539-E |
uGPSのバージョンが不整合の可能性があります。 |
|
KAKJ1739-E |
リモートログインに失敗しました。 |
||
注※ パラメータエラー時には，使用方法を示すKAKJ1765-Iが出力されます。
表示形式
起動に成功した場合，起動されているユーザサーバの状態を表示します。
gpsvlsコマンドの「サーバの状態表示」の出力内容と同じ情報を出力します。
注意事項
-
このコマンドは，uGPS管理者が実行してください。
-
-Uオプションを使用する場合，次のことに注意してください。
-
正常開始では-Uオプションは無視されます。
-
システムサーバ起動後にユーザサーバを起動したい場合には，gpsvstartコマンドを使用してください。
-
システムサーバ起動後に，ユーザサーバの構成を回復したい場合には，正常終了および強制正常終了以外でシステムサーバを停止し，gpstartで-Uオプションを指定しないでシステムサーバを起動してください。
-
-
通信できないIPアドレス，または通信できないIPアドレスに変換されるホスト名をシステムサービス定義のall_nodeオペランドに指定した場合，uGPSの起動に時間が掛かることがあります。詳細については，all_nodeオペランドの説明を参照してください。
-
このコマンドをOSコマンドで強制停止させた場合，システムサーバが異常終了することがあります。
-
-hオプションを指定してコマンドを実行すると，OSが提供するsshコマンドまたはrshコマンドのメッセージが出力される場合があります。メッセージに従って対処してください。