アプリケーションをインストールするディレクトリー
エンタープライズ・アーカイブ (EAR) ファイルのインストール先のディレクトリーを指定します。
デフォルトでは、EAR ファイルは、 profile_root/installedApps/cell_name/application_name.ear ディレクトリーにインストールされます。
設定オプションには、以下のものがあります。
- 値を指定せず、フィールドを空のままにしておきます。
デフォルト値は ${APP_INSTALL_ROOT}/cell_name です。 ${APP_INSTALL_ROOT} 変数は profile_root/installedApps です。 インストールされるアプリケーションの EAR ファイル名を含むディレクトリーが、 ${APP_INSTALL_ROOT}/cell_name に付加されます。 つまり、ディレクトリーを指定しなければ、EAR ファイルは profile_root/installedApps/cell_name/application_name.ear ディレクトリーにインストールされます。
- ディレクトリーを指定します。
「アプリケーションをインストールするディレクトリー」用のディレクトリーを指定する場合、アプリケーションは specified_path/application_name.ear ディレクトリーにインストールされます。インストールするアプリケーションの EAR ファイル名を持つディレクトリーは、 「アプリケーションをインストールするディレクトリー」用に指定するパスに追加されます。例えば、Windows コンピューターに Clock.ear をインストールし、C:/myapps を指定する場合、アプリケーションは myapps/Clock.ear ディレクトリーにインストールされます。${APP_INSTALL_ROOT} 変数は指定したパスに設定されます。
- アプリケーションの初期インストールには、
${APP_INSTALL_ROOT}/${CELL} を指定します。
あるセルからアプリケーションをエクスポートし、 後でエクスポートしたアプリケーションを別のセルにインストールする場合は、 アプリケーションの初期インストールに対して ${CELL} 変数を指定します。 例えば、この設定の場合は ${APP_INSTALL_ROOT}/${CELL} を指定します。 アプリケーションをエクスポートすると、アプリケーションとそのデプロイメント構成を持つ拡張 EAR ファイルが作成されます。 デプロイメント構成では、${CELL} 変数を指定しないと、宛先ディレクトリーに初期インストールのセル名が保存されます。 ${CELL} 変数を指定すると、 宛先ディレクトリーが、元のセル名ではなく、必ず現在のセル名を持つようになります。
重要: アプリケーションをシングル・サーバー構成にインストールする際に、インストール・ディレクトリーが指定されていないと、アプリケーションは ${APP_INSTALL_ROOT}/cell_name にインストールされます。 (addNode ユーティリティーを使用して) サーバーをマルチサーバー構成に組み込むと、 新しい構成のセル名は、デプロイメント・マネージャー・ノードのセル名になります。 addNode ユーティリティーで -includeapps オプションを使用すると、 addNode オペレーションの前にインストール済みのアプリケーションは、引き続き、 インストール・ディレクトリー ${APP_INSTALL_ROOT}/cell_name を使用します。 ただし、サーバーがネットワーク構成に追加された後にインストールされたアプリケーションは、 デフォルトのインストール・ディレクトリー ${APP_INSTALL_ROOT}/network_cell_name を使用します。 addNode オペレーションの実行時にアプリケーションを ${APP_INSTALL_ROOT}/network_cell_name に 移動するためには、インストール時に、インストール・ディレクトリーを明示的に ${APP_INSTALL_ROOT}/${CELL} と 指定します。このような場合、アプリケーション・ファイルは必ず ${APP_INSTALL_ROOT}/current_cell_name にあります。 - アプリケーションがエクスポート済みの場合に、
エクスポートされた EAR ファイルを別のセルまたはロケーションにインストールするには、
${APP_INSTALL_ROOT}/cell_name/application_name.ear を指定します (ただし、初期インストール用に ${APP_INSTALL_ROOT}/${CELL} を指定しなかった場合)。
エクスポートされた EAR ファイルは、アプリケーションとそのデプロイメント構成を持つ 拡張 EAR ファイルです。デプロイメント構成は、以前にこのアプリケーションを インストールしたときに「アプリケーションをインストールするディレクトリー」で指定した値を 保存しています。このインストールの「アプリケーションをインストールするディレクトリー」に別の値を指定しない限り、拡張 EAR ファイルが前回のインストールと同じディレクトリーにインストールされます。
初期インストール時に ${CELL} 変数を 指定しなかった場合は、デプロイメント構成で宛先ディレクトリーの初期インストールの セル名が使用されます。別のセルにインストールする場合は、 ${APP_INSTALL_ROOT}/cell_name/application_name.ear を指定します。ここで、cell_name は拡張 EAR ファイルをインストールする セルの名前です。現在のセル名を指定しない場合は、 別の名前のセルに拡張 EAR ファイルをインストールしても、 cell_name は元のセル名になります。
- 絶対パスを指定するか、パス・マップ変数を使用します。
絶対パスを指定することも、パス・マップ変数 (${MY_APPS} など) を使用することもできます。 パス・マップ変数は、任意のシステムで使用できます。
パス・マップ変数は、 異機種ノード上にメンバーを持つクラスターにアプリケーションをインストールする際に特に必要です。 このようなケースでは、絶対パスを指定する方法がほかにない場合があるためです。 現行セル名を示す WebSphere Application Server 変数 ${CELL} をパス・マップ変数に指定することも可能です (例 ${MY_APP}/${CELL} など)。WebSphere Application Server 変数は、「WebSphere 変数」ページで定義することができます。このページにアクセスするには、とクリックします。
![[IBM i]](../iseries.gif)
![[AIX Solaris HP-UX Linux Windows]](../dist.gif)
トラブルの回避: 分散オペレーティング・システム環境では、パス・マップ変数の有効範囲は、サーバー・レベルの有効範囲からではなく、ノード・エージェント・レベルの有効範囲から始まります。変数がノード・エージェント・レベルの有効範囲で見つからない場合は、変数はノード・レベルの有効範囲で検索され、最後にセル・レベルの有効範囲で検索されます。gotcha
この「アプリケーションをインストールするディレクトリー」フィールドは、「アプリケーション・バイナリー」ページの「ロケーション (絶対パス)」設定と同じです。
| 情報 | 値 |
|---|---|
| データ型 | ストリング |
| 単位 | 絶対パス名 |
サポートされる構成:
ベスト・プラクティス:![[Windows]](../windows.gif)
Windows オペレーティング・システム上のファイルの読み取り権限を設定解除することはできません。POSIX スタイルのアクセス権ビットを使用した場合、ファイルに対する readable を示すビットは 4、writable を示すビットは 2、executable を示すビットは 1 になります。このため、Windows オペレーティング・システム上のファイルに対するアクセス権は 5 または 7 になります。また、POSIX スタイルでは、user、group、および world のアクセス権があります。
Windows オペレーティング・システム上のファイルに対しては user アクセス権のみ設定できます。group および world のアクセス権ビットは無視されます。