IBM i プラットフォームの場合

iAdmin コマンド

このコマンドは、 IBM® i プラットフォーム上での Liberty サーバーの操作をサポートします。 コマンド・ファイルは、wlp/lib/native/os400/bin ディレクトリーにあります。 コマンド・ファイルは、iAdmin という名前のスクリプトです。

構文

コマンド構文は次のようになります。

iAdmin task [options]
ここで、task の値は、以下のいずれかのオプションにすることができます。
  • POSTINSTALL
  • PREUNINSTALL
  • GRANTAUTH
POSTINSTALL タスクは、QWAS9 サブシステムのジョブとしてサーバーを起動するように server start コマンドを構成します。 また、このタスクは、以下を行います。
  • QEJBSVR ユーザー・プロファイルの下でサーバーを実行するように Liberty を構成します。
  • wlp/etc/default.env ファイル内の WLP_DEFAULT_JAVA_HOME を サポートされる最小 Java™ レベルの 32 ビット・バージョンのロケーションに設定して、デフォルト JDK ロケーションを構成します。
  • IBM i ネイティブ製品レジストリーに製品のエントリーを追加します。
  • IBM i ネイティブ・ライブラリーおよびオブジェクト ( QWAS9 サブシステムや QEJBSVR ユーザー・プロファイルなど) を作成します。

iAdmin POSTINSTALL コマンドは、 アーカイブ・ファイルの解凍による Liberty のインストールの後にのみ呼び出してください。

GRANTAUTH タスクは、サーバー・ロールに必要なファイル許可および所有権を QEJBSVR ユーザー・プロファイルに付与します。 POSTINSTALL は、QEJBSVR ユーザー・プロファイルに対して適切にファイル所有権および権限を設定します。 ただし、ファイルを手動で作成する場合、または Liberty サーバーによって使用されるファイルに対する権限を変更する場合は、 iAdmin GRANTAUTH コマンドを呼び出して、QEJBSVR に正しい権限があることを確認できます。

PREUNINSTALL タスクは、POSTINSTALL タスクで作成されたネイティブ・ライブラリーおよびオブジェクトを削除します。 Liberty アプリケーション・サービス環境をシステムから削除する前に iAdmin PREUNINSTALL コマンドを呼び出しますが、必要なのは、JAR ファイルを実行して Liberty がインストールされた場合のみです。

注:
  • POSTINSTALL および PREUNINSTALL コマンドを使用するには、 *ALLOBJ および *SECADM 特殊権限が必要です。
  • GRANTAUTH コマンドを使用するには、指定されたディレクトリー・サブツリー内のすべてのオブジェクトに対する *ALLOBJ 特殊権限、所有権、または *OBJMGT 権限を持っている必要があります。
  • POSTINSTALL タスクを実行した後、 Liberty サーバーを始動および停止するには、 *ALLOBJ 特殊権限と *SECADM 特殊権限も必要です。

オプション

iAdmin コマンドで使用可能なオプションは、以下のとおりです。
--outputdir wlp_user_dir
サーバー生成ファイル用のディレクトリー。 このオプションは必ず絶対パスでなければならず、GRANTAUTH タスクではオプションで、その他のすべてのタスクでは無視されます。 指定されていない場合は、サーバー生成出力用のデフォルト・ロケーションが使用されます。
--rolename role_name
ユーザー・プロファイルに割り当てられるロール。 現在サポートされているロールは、サーバー・ロールのみです。 このオプションは、GRANTAUTH タスクでは必須で、その他のすべてのタスクでは無視されます。
--userdir wlp_user_dir
共有リソースおよびサーバー定義が含まれるディレクトリー。 このオプションは絶対パスにのみすることができ、GRANTAUTH タスクではオプションで、その他のすべてのタスクでは無視されます。 指定されていない場合は、共有リソースおよびサーバー定義のデフォルト・ロケーションが使用されます。
--userprofilename user_profile_name
権限を認可するユーザー・プロファイル。 QEJBSVR は、サーバー・ロールで現在サポートされている唯一のユーザー・プロファイル名です。 このオプションは、GRANTAUTH タスクでは必須で、その他のすべてのタスクでは無視されます。

使用シナリオ

以下は、正しい構文の例です。 以下に示すどの例のコマンドも 1 行で実行します。
  • QWAS9 サブシステム内のジョブとして開始し、実行時に QEJBSVR ユーザー・プロファイルにスワップするように Liberty を構成します。
    wlp/lib/native/os400/bin/iAdmin POSTINSTALL
  • この Liberty ランタイム環境用に構成された共有リソース、サーバー定義、および出力ロケーションについて、QEJBSVR ユーザー・プロファイルにサーバー・ロールを付与します。
    wlp/lib/native/os400/bin/iAdmin GRANTAUTH --rolename server --userprofilename QEJBSVR
  • POSTINSTALL タスクで作成されたネイティブ・ライブラリーおよびオブジェクトを削除します。
    wlp/lib/native/os400/bin/iAdmin PREUNINSTALL