アセットの設定

このページを使用して、アセットをアセット・リポジトリーに登録するためのオプションを指定します。値を指定 しない場合は、オプションのデフォルト値が使用されます。アセットが OSGi アプリケーション の場合は、バンドルのダウンロード状況に関する追加情報が表示されます。

この管理コンソール・ページを表示するには、「アプリケーション」 > 「アプリケーション・タイプ」 > 「アセット (Assets)」 > 「asset_name」とクリックします。このページは、アセット・インポートおよび更新ウィザードの「アセットをインポートするためのオプションの選択 (Select options for importing an asset)」ページと類似しています。

アセット名 (Asset name)

アセットの論理名を指定します。 アセット名は、セル内で固有でなければならず、サポートされていない文字を含むことはできません。

アセット名は、先頭にピリオド (.) を使用することはできません。 また、先頭または末尾をスペースにすることはできず、以下の文字を含むことはできません。

表 1. 名前に使用できない文字。 この製品で以下の文字は名前にサポートされていません。
サポートされていない文字
⁄  スラッシュ $   ドル記号 '  単一引用符
\ 円記号 =  等号 " 二重引用符
* アスタリスク % パーセント記号 |   縦棒
,  コンマ +   正符号 <  左不等号括弧
:  コロン @ アットマーク >  右不等号括弧
;  セミコロン #   ハッシュ・マーク & アンパーサンド (アンド記号)
? 疑問符 (?) ]]> この文字の組み合わせには、特定の名前はありません。

この「アセット名 (Asset name)」フィールドは、「アセット (Assets)」ページの「名前」設定と同じです。

情報 値
データ型 ストリング

アセットの説明

アセットの説明を指定します。

アセット・バイナリー宛先 URL (Asset binaries destination URL)

本製品がアセット・ファイルをインポートする先のディレクトリーを指定します。

情報 値
データ型 ストリング
単位 絶対パス名

アセット・タイプの局面

アセット・コンテンツのタイプを指定します。アセット・タイプの例には、Java アーカイブ (JAR) ファイル、共有ライブラリー、エンタープライズ・アプリケーション・アーカイブ (EAR) ファイル、およびエンタープライズ・バンドル・アーカイブ (EBA) ファイルがあります。

アセット・タイプによって、アセット・のコンテンツがわかります。例えば、JAR ファイルとしてパッケージされたアセットには、Web モジュール、ポートレット、または Web サービスが含まれることがあります。 EBA ファイルとしてパッケージされたアセットには OSGi アプリケーションが含まれます。

この設定は読み取り専用です。この設定を編集することはできません。

情報 値
データ型 ストリング
単位 ファイル・タイプ
デフォルト なし

ファイル・アクセス権

本製品がアセット・バイナリー宛先 URL に展開するアセット・バイナリーに対するアクセス権を指定します。

制約事項: OSGi アプリケーションは、「ファイル・アクセス権」設定を使用しません。

ファイル・アクセス権をテキスト・フィールドに指定することができます。 一般的に使用されるファイル・アクセス権を、リストから選択して設定することもできます。リストから選択すると、テキスト・フィールドに設定されたファイル・アクセス権が上書きされます。

リストで 1 つ以上の次のファイル・アクセス権のストリングを設定できます。 複数のオプションを選択すると、ファイル・アクセス権のストリングが結合されます。

表 2. リストのオプションのファイル・アクセス権ストリングの設定。 リスト・オプションを選択するか、テキスト・フィールドでファイル・アクセス権ストリングを指定します。
複数選択リストのオプション ファイル・アクセス権ストリングの設定
すべてのファイルの読み取りを許可するが、書き込みは許可しない .*=755
実行可能プログラムの実行を許可する .*¥.dll=755#.*¥.so=755#.*¥.a=755#.*¥.sl=755
HTML ファイルおよびイメージ・ファイルの読み込みをすべてのユーザーに対して許可する .*\.htm=755#.*\.html=755#.*\.gif=755#.*\.jpg=755

複数選択リストを使用してファイル・アクセス権を指定する代わりに、テキスト・フィールドにファイル・アクセス権のストリングを指定することができます。 ファイル・アクセス権には、以下のフォーマットのストリングが使用されます。

file_name_pattern=permission#file_name_pattern=permission

ここで、file_name_pattern は正規表現のファイル名フィルター (例えば、.*\\.jsp はすべての JSP ファイル) であり、permission はファイルのアクセス制御リスト (ACL) を表し、# は file_name_pattern と permission の複数のエントリー間の区切り文字です。# という文字が file_name_pattern ストリングの中にある場合は、代わりに \# を使用します。

ストリング内の複数のファイル名パターンおよびファイル・アクセス権がアセット内の URI (Uniform Resource Identifier) に一致した場合、製品はファイルに対して最も厳密に適用されるファイル・アクセス権を使用します。例えば、ファイル・アクセス権のストリングが .*\\.jsp=775#a.*\\.jsp=754 の場合、abc.jsp ファイルのファイル・アクセス権は 754 となります。

ヒント: ファイル・マッチング・パターンに正規表現を使用すると、指定されたファイル・アクセス権パターンに突き合わせてストリング URI 全体が比較されます。Java プログラミング API により定義されているように、正規表現を使用してより正確なマッチング・パターンを指定する必要があります。 例えば、ファイル・アクセス権操作中に、本製品が以下のディレクトリーおよびファイルの URI を処理するとします。
表 3. ファイル許可操作の URI 例。 結果は、この表の後に示されています。
数 URL の例
1 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war
2 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp
3 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF/MANIFEST.MF
4 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/WEB-INF/classes/MyClass.class
5 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/mydir/MyClass2.class
6 /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF

ファイル・パターン・マッチングの結果は以下のようになります。

「ファイル・アクセス権」のディレクトリー名パターンを指定すると、指定された値に基づきディレクトリー許可が設定されます。指定しない場合、ディレクトリー上に設定される「ファイル・アクセス権」の値は、親と同じです。例えば、ファイルおよびディレクトリー構造が次のようになっている場合に、
/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp
次のファイル・パターン・ストリングを指定するとします。
.*MyApp.ear$=755#.*¥.jsp=644
ファイル・パターン・マッチングの結果は以下のようになります。
  • ディレクトリー MyApp.ear は、755 に設定されます。
  • ディレクトリー MyWarModule.war は、755 に設定されます。
  • ディレクトリー MyWarModule.war は、755 に設定されます。
重要: オペレーション・システムに関係なく、ファイル・パターンではファイル・パス・セパレーターとして常にスラッシュ (/) を使用してください。

[Windows]Windows オペレーティング・システム上のファイルの読み取り権限を設定解除することはできません。POSIX スタイルのアクセス権ビットを使用した場合、ファイルの readable を示すビットは 4、writable を示すビットは 2、executable を示すビットは 1 です。したがって、Windows オペレーティング・システム上のファイルのアクセス権は、5 または 7 のいずれかです。また、POSIX スタイルには、user、 group、および world のアクセス権があります。 Windows オペレーティング・システム上のファイルに対しては user アクセス権のみ設定できます。group および world のアクセス権ビットは無視されます。

ここで指定されるアクセス許可は、アセット・レベルの許可です。 ノード・レベルの構成でも、アセット・バイナリーに対するアクセス権を指定できます。ノード・レベルのファイル・アクセス権は、アセット・バイナリーに指定できる最大の (最も緩い) アクセス権を指定します。ここでアセット・レベルで指定できるアクセス許可は、ノード・レベルで指定されたものと同じか、より限定されたものに限られます。

情報 値
データ型 ストリング

現在のアセット関係

このアセットと関係するアセットを指定します。

関係を追加または除去するには、以下のように「関係の管理」ページを使用します。
  1. 「関係の管理」をクリックします。 右側の「選択済み」リストに、現行のアセット関係がリストされます。
  2. 関係を追加するには、左側の「使用可能」リストでアセットを選択して、「>>」をクリックします。
  3. 関係を除去するには、右側の「選択済み」リストでアセットを選択して、「<<」をクリックします。
  4. 「OK」をクリックします。
情報 値
データ型 ストリング
デフォルト なし

アセットの妥当性検査 (Validate asset)

製品が、アセットのインポートまたは更新中に指定されたアセット参照を検査するかどうか、また、妥当性検査を使用可能にする場合、誤った参照をユーザーに警告するのか、オペレーションを失敗させるのかを指定します。

制約事項: OSGi アプリケーションは、「アセットの妥当性検査」設定を使用しません。

アセットは通常、コンテナー管理パーシスタンス (CMP) Bean のデータ・ソースを使用するか、デプロイメント記述子で定義されたリソース参照またはリソース環境参照を使用して、リソースを参照します。妥当性検査では、アセットによって参照されるリソースが、そのアセットのデプロイメント・ターゲットの有効範囲に定義されているかどうかを検査します。

リソースの妥当性検査を行い、誤ったリソース参照の結果として失敗したオペレーションを停止するには、「true」を選択します (チェック・ボックスを有効にします)。リソースの妥当性検査を行わない場合は、「false」を選択します (チェック・ボックスにチェック・マークを付けません)。

情報 値
データ型 ストリング
デフォルト false (空のチェック・ボックス)

EBA 依存関係

エンタープライズ・バンドル・アーカイブ (EBA) アセットの場合、アセット内のすべてのバンドルの現在のバンドル・ダウンロード状況が表示されます。この項目は、アセットが EBA アセットであるときのみ、 つまり OSGi アプリケーションを含むときにのみ、 表示されます。

以前の更新からのバンドル・ダウンロードが完了し、アセットを使用するビジネス・レベル・アプリケーションを再始動して以前の更新を取得するまで、EBA アセットを更新することはできません。 バンドル・バージョンの更新を試行する前に、EBA の依存関係の情報を使用して、アセットのバンドル・ダウンロード状況を確認することができます。表示される 状況は、以下のいずれかの値です。

注: ここに示されている情報に加えて、『ビジネス・レベル・アプリケーションが使用する EBA アセットのバージョンの確認と更新』で説明されているように、関連した EBA 構成単位の状況を確認することにより、間接的にバンドル・ダウンロード状況を確認することもできます。

アセットのバンドル・ダウンロードが完了している場合、またはバンドル・ダウンロードが必要でない場合は、『EBA アセットのバンドル・バージョンの保守』で説明されているいずれかの方法を使用して、アセットを更新できます。

アセットのバンドル・ダウンロードが完了し、EBA アセットの新規バージョンが使用可能になった場合は、ビジネス・レベル・アプリケーションを再始動して EBA 構成単位を最新にし、新しい構成を実行します。



ファイル名: urun_rapp_bla_asset_importoptions.html