このページを使用して、サーバー上にすでにインストール済みのエンタープライズ・アプリケーション、モジュール、またはファイルを更新します。
「エンタープライズ・アプリケーション」ページで選択した、インストール済み (またはデプロイ済み) の アプリケーションの名前を指定します。
「アプリケーション更新オプション」の下で、 サーバー上に既にインストール済みのアプリケーションを、新規 (更新済み) エンタープライズ・アプリケーション .ear ファイルで置き換えるように指定します。
このオプションを選択した後、以下の手順を実行します。
ブラウザーと更新済みファイルまたはモジュールが同一マシン上にある場合は (サーバーもそのマシン上にあるかないかにかかわらず)、「ローカル・ファイル・システム」を使用します。 「ローカル・ファイル・システム」はすべての更新オプションに使用可能です。
アプリケーション・ファイルが現行セルのコンテキストのいずれかのノードにある場合は、 「リモート・ファイル・システム」を使用します。
マルチサーバー・インストールでは、選択されたノードでノード・エージェントまたはデプロイメント・マネージャーが実行されている場合、「リモート・ファイル・システム」を使用してそのノードのファイル・システム全体をブラウズすることができます。 ブラウズ中に表示されるのは、.ear、.jar、.sar、または .war ファイルのみです。
また、アプリケーション・サーバーを稼働しているマシンにすでに存在するアプリケーション・ファイルを指定する場合にも、 「リモート・ファイル・システム」オプションを使用します。 例えば、フィールド値は、app_server_install_root/installableApps/test.ear のようになります。スタンドアロンの WAR モジュールをインストールする場合は、コンテキスト・ルートも指定してください。
コンテキスト・ルートは、(WAR ファイルからの) 定義済みのサーブレット・マッピングと組み合わされて、ユーザーがサーブレットへのアクセス時に入力する完全 URL を構成します。例えば、 コンテキスト・ルートが /gettingstarted でサーブレット・マッピングが MySession の場合、 URL は http://host:port/gettingstarted/MySession となります。
全アプリケーションが更新されると、古いアプリケーションはアンインストールされ、 新規アプリケーションがインストールされます。 構成変更が保管され、その後同期化されると、アプリケーション・ファイルはアプリケーションが稼働するノードで展開されます。 更新の間アプリケーションがノードで稼働していると、 アプリケーションは停止し、アプリケーション・ファイルが更新され、アプリケーションが始動します。
「アプリケーション更新オプション」の下で、 インストール済みアプリケーションでモジュールを置き換える、 またはそのアプリケーションにモジュールを追加するように指定します。
このモジュールは、Web モジュール (.war ファイル)、エンタープライズ Bean モジュール (EJB .jar ファイル)、SIP モジュール (.sar ファイル )、またはリソース・アダプター・モジュール (コネクター .rar ファイル) にすることができます。
このオプションを選択した後、このモジュールがローカルにあるのか、またはリモート・ファイル・システムにあるのか、 およびそのモジュールの絶対パス名を指定します。 このパスで、インストール前に更新済みモジュールのロケーションを指定します。 「ローカル・ファイル・システム」および「リモート・ファイル・システム」については、 前述の『アプリケーション全体の置換』の説明を参照してください。
モジュールを置き換える場合は、指定した相対パス (モジュール URI) が、インストール済みアプリケーション内の更新対象モジュールのパスと一致する必要があります。
インストール済みアプリケーションに新規モジュールを追加する場合は、指定した相対パスが、インストール済みアプリケーション内のモジュールのパスと一致しない ようにする必要があります。 新規モジュールで望ましいパスを値に指定してください。
スタンドアロンの Web モジュールまたは SIP モジュールをインストールする場合は、「コンテキスト・ルート」の値を指定します。 コンテキスト・ルートは、(.war ファイルからの) 定義済みサーブレット・マッピングと組み合わされて、 ユーザーがサーブレットへのアクセス時に入力する完全 URL を構成します。 例えば、 コンテキスト・ルートが /gettingstarted でサーブレット・マッピングが MySession の場合、 URL は http://host:port/gettingstarted/MySession となります。
次に、情報の指定を要求するインストール・オプションのみを表示するか、 すべてのインストール・オプションを表示するかを指定します。
モジュール上で必要な情報を指定した後、「次へ」をクリックして、 アプリケーション・ファイルを更新するためのウィザードを表示します。 更新ウィザードは、インストール・ウィザードに似ており、 モジュール・バインディング情報を指定または編集するためのフィールドがあります。 必要に応じて、更新ウィザードのステップに従います。
「アプリケーション更新オプション」の下で、 インストール済みアプリケーション内でファイルを置き換えるか、 このアプリケーションにファイルを追加するように指定します。
このオプションを使用して、.ear、.war、.sar、.rar、 または、場合によって .jar ファイル以外の、アプリケーションによって使用されるファイルを更新します。 このオプションを使用すると、 アプリケーションでモジュールとして定義されていない .jar ファイルを追加または更新できます。.ear ファイルを更新するには、「アプリケーション全体の置換」オプションを使用します。 アプリケーションでモジュールとして定義されている .war ファイル、.sar ファイル、.rar ファイル、または .jar ファイルを更新するには、「単一モジュールの置換または追加」オプションを使用します。
このオプションを選択した後、このファイルがローカルにあるのか、リモート・ファイル・システムにあるのか、 およびそのファイルの絶対パス名を指定します。 このパスで、インストール前に更新済みファイルのロケーションを指定します。 「ローカル・ファイル・システム」および「リモート・ファイル・システム」については、 『アプリケーション全体の置換』の説明を参照してください。
相対パスの場合、.ear ファイルのルートから開始するファイルへの相対パスを指定します。例えば、ファイルがモジュール hello.jar の com/company/greeting.class にある場合、 相対パス hello.jar/com/company/greeting.class を指定します。
ファイルを置き換えるには、相対パスがインストール済みアプリケーション内の更新対象ファイルのパスと一致する必要があります。
インストール済みアプリケーションに新規ファイルを追加する場合は、相対パスがインストール済みアプリケーション内のモジュールのパスと一致しない ようにする必要があります。 新規ファイルで望ましいパスを値に指定してください。
ファイル・システムおよび相対パスを指定した後で、「次へ」をクリックします。
「アプリケーション更新オプション」の下で、圧縮ファイルをアップロードすることによって、 インストール済みアプリケーションの複数のファイルを更新するように指定します。 圧縮ファイルの内容によっては、このオプションを使用するだけで、 インストール済みアプリケーションでのファイルの置換、新規ファイルの追加、およびファイルの削除を行うことができます。 圧縮ファイル内の各項目は単一のファイルとして処理され、圧縮ファイルのルートからのファイルのパスは、インストール済みアプリケーションのファイルの相対パスとして処理されます。
このオプションを選択した後、この圧縮ファイルがローカルにあるのか、またはリモート・ファイル・システムにあるのか、 およびこの圧縮ファイルの絶対パス名を指定します。 圧縮ファイルをアップロードしていて、リモート・ブラウズが .ear、.sar、.war または .jar ファイルにしか機能しないため、「ローカル・ファイル・システム」を使用する可能性があります。 .zip または .gzip などの有効な圧縮ファイル・フォーマットを指定します。このパスによって、圧縮ファイルのロケーションが、インストール前に提供されます。 このオプションにより、圧縮ファイルが unzip されて、インストール済みアプリケーションのディレクトリーに格納されます。
ブラウザーと更新済みファイルまたはモジュールが同一マシン上にある場合は (サーバーもそのマシン上にあるかないかにかかわらず)、「ローカル・ファイル・システム」を使用します。 「ローカル・ファイル・システム」はすべての更新オプションに使用可能です。
ファイルを置き換えるには、圧縮ファイル内のファイルの相対パスが、 インストール済みアプリケーション上の更新されるファイルの相対パスと同じでなければなりません。
インストール済みアプリケーションに新規ファイルを追加するには、圧縮ファイル内のファイルの相対パスが、インストール済みアプリケーション内のファイルの相対パスと異なっていなければなりません。
インストール済みアプリケーションにあるファイルの相対パスは、 モジュールの相対パス (ファイルがモジュール内にある場合) と / によって区切られるモジュールのルートからのファイルの相対パスの連結によって形成されます。
削除するファイルのレベル | 圧縮ファイルに含めるメタデータ .props ファイル |
---|---|
アプリケーション | 圧縮ファイル内に META-INF/ibm-partialapp-delete.props を含めます。
メタデータ .props ファイルで、削除するファイルをリストします。
ファイル・パスは、META-INF/ibm-partialapp-delete.props ファイルのロケーションに対する相対パスです。
例えば、my.ear ファイルのルートから utils/config.xmi という名前のファイルを削除するには、 META-INF/ibm-partialapp-delete.props ファイルに行 utils/config.xmi を含めます。 |
モジュール | 圧縮ファイルに module_uri/META-INF/ibm-partialapp-delete.props を含めます。
モジュールから 1 つのファイルを削除するには、 メタデータ .props ファイルにモジュールに対するファイル・パスを含めます。 例えば、my.jar モジュールから a/b/c.jsp を削除するには、圧縮ファイルの my.jar/META-INF/ibm-partialapp-delete.props ファイルに a/b/c.jsp を含めます。 1 つのモジュール内で複数ファイルを削除するには、1 行に 1 つの記入項目で、メタデータ .props ファイルで削除されるファイルをリストします。 例えば、my.war ファイルからすべての JavaServer Pages (.jsp ファイル) を削除するには、 my.war/META-INF/ibm-partialapp-delete.props ファイルに行 .*jsp を含めます。 この行は正規表現 .*jsp を使用しており、my.war 内のすべての .jsp ファイルを識別します。 |
単一の部分アプリケーション・ファイルを使用して、複数のファイルを追加、削除、および更新することができます。
ファイル・システム・パスを指定した後で、「次へ」をクリックします。
アプリケーションの一部が更新された後で構成変更が保管されると、 新規または更新済みアプリケーション・ファイルが、WebSphere® Application Server 構成リポジトリー内のデプロイされたアプリケーションに保管されます。 これらの変更がノードと同期化されると、ファイルはノードのファイル・システムに追加されるか、または更新されます。 一部のアプリケーション・オプションは複数のファイルを更新するため、 再始動されるアプリケーション・コンポーネントは一部のアプリケーションで個々のファイルを使用して決定されます。
一部のアプリケーション圧縮ファイルの記入項目の例は、次のとおりです。
util.jar META-INF/ibm-partialapp-delete.props foo.jar/com/mycomp/xyz.class xyz.war/welcome.jsp xyz.war/WEB-INF/web.xml webmod.war/META-INF/ibm-partialapp-delete.props
この例では、META-INF/ibm-partialapp-delete.props ファイルが .*.dat および tools/test.jar ファイルを含みます。webmod.war/META-INF/ibm-partialapp-delete.props ファイルは com/test/.*.jsp および WEB-INF/test.xmi ファイルを含みます。