アプリケーションをインストールしたり除去するには、いくつかの方法があります。

• Geronimo 管理コンソール
• デプロイヤー・ツール (コマンド・ライン)
• ホット・デプロイ (コマンド・ライン)

アプリケーションをパッケージングする際には、デプロイメント・プランをパッケージの中に含めても良いですし、含めなくてもかまいません。Geronimoはパッケージ済みのアプリケーションの WEB-INF ディレクトリーの中にデプロイメント・プラン　geronimo-web.xml および web.xml ( またはアプリケーションの種類によっては geronimo-application.xml や geronimo-application-client.xml )があるかどうかを探索します。Geronimoがこれらの記述子を見つけられなかった場合は、デフォルトの設定を使ってアプリケーションをデプロイしようとします。もしデフォルトの設定でデプロイが失敗した場合は、アプリケーションの中のデプロイメント・プランを再ひパッケージングするか、または外部からデプロイメント・プランを与える必要があります。以降のセクションでは、このような場合に採りうる選択肢を、更に細かく説明します。

Geronimo管理コンソール GAC

Geronimo管理コンソールを使って新たにアプリケーションを導入する場合には、左側の Console Navigation メニューの Deploy New を選択し、 Install New Applications ポートレットを使用します。このポートレットを使えば、デプロイ直後にアプリケーションを自動的に開始させることもできます。

前と同様に、この例でも5. クイック・スタート - いますぐ始めたい人の Apache Geronimo で作成した簡単なJSPのHelloWorldサンプルを使います。但し、あちらでは --inPlace オプションを使いました。つまり、アプリケーションを WAR ファイルにパッケージングする必要はありませんでした。WARファイルを作成するには <app_home> ディレクトリーから下記のコマンドをタイプしてください。

jar -cvf HelloWorld.war *

このWARには、すでにデプロイメント・プランがパッケージ中に含まれています。

Geronimo管理コンソールに戻り、Install New Applications ポートレットで Browse をクリックし Archive: セクションで HelloWorld.war へのパスを指定します。 Start app after install チェックボックスがチェックされていることを確認し（デフォルトではチェックされています） Install をクリックします。

ポートレットの先頭に" The application was successfully deployed. " と " The application was successfully started. " という確認のためのメッセージが表示されるはずです。

アプリケーションが正常にインストールされ、開始したことを確認するもうひとつの方法として、左側の Console Navigation メニューの Web App WARs を選択すると表示される Installed Web Applications ポートレットも利用できます。リスト中の hello アプリケーションのステータスが running になっているのが見えるはずです。

私たちの導入したアプリケーションは HelloWold. WAR なのでこのポートレットを使いましたが、EARをインストールした場合には左側の Console Navigation メニューの Application EARs を選択すると表示される *Installed Application EARs ポートレットも利用できます。インストールの手順はWARとEARアプリケーションで同じです。

Geronimo管理コンソールを使ってアプリケーションを除去する際には、 アンインストールするアプリケーションによって、 Installed Web Applications か Installed Application EARs のいずれかのポートレットを利用します。

私たちのサンプルでは、 Installed Web Applications ポートレットへアクセスして、 Component Name のリストで sample.applications/HelloWorldApp/2.0/war　に対して Uninstall をクリックします。その結果、まずアプリケーションが停止され、次にアンインストールが行われます。" Uninstalled application " という確認のためのメッセージがポートレットの末尾に表示されます。

以上がGeronimo管理コンソールを用いてアプリケーションをインストール／アンインストールするための基本的な手順です。次の２つのセクションでは、コマンドラインを用いた方法を述べます。

デプロイヤー・ツール depl

デプロイヤー・ツールを使えばアプリケーションのインストールやアンインストール等々をコマンドラインから行うことができます。このセクションではサンプル・アプリケーションを使いながらインストールとアンインストールのタスクのみを扱います。その他の機能については 1.9.3. Deployer tool - デプロイヤー・ツール のセクションにすべて記載されています。

サンプル・アプリケーション HelloWorld.war をデプロイヤー・ツールを使ってコマンド・ラインからデプロイするには、<geronimo_home>\binディレクトリーで下記のコマンドをタイプします。

deploy --user system --password manager deploy <app_home>/HelloWorld.war

もし貴方のアプリケーションの WEB-INF にGeronimoの特定のデプロイメント・プランが含まれていなくても、Geronimo 管理コンソールの場合と同様に、外部から指定することができます。先程のコマンドにデプロイメント・プランのパスとファイル名を追加すればよいだけです。

deploy --user system --password manager deploy <app_home>/HelloWorld.war <deployment_plan_home>/plan.xml

外部からデプロイメント・プランを指定する場合には、プランを特定する任意のファイル名を使える点にご注目ください。 geronimo-XYZ.xml といった書式を使わなければならないわけではありません。私たちの例ではGeronimoの特有のデプロイメント・プランが既にパッケージに含まれているので、更に追加でデプロイメント・プランを指定する必要はありません。

デプロイされると、このような確認用のメッセージが表示されるはずです。

Geronimo管理コンソールを使った場合と違い、コマンドライン・ツールを使った場合には確認用のメッセージとしてより多くの情報が入手できます。例えば、 Component Name （またはモジュールID）や、デプロイされたアプリケーションのコンテキスト・ルートとポート番号を入手できます。この種の設定値はどうしても忘れがちなので、複数のアプリケーションをインストールやテスト、アンインストールする時には便利です。

または、もしアプリケーションをまだパッケージングしていないのであれば、 --inPlace オプションを使えば、貴方が開発に使用しているディレクトリーから直接、アプリケーションをデプロイすることもできます。このオプションは 5. クイック・スタート - いますぐ始めたい人の Apache Geronimoの中でサンプル・アプリケーションをデプロイする際に使われています。

この場合には、<geronimo_home>\binディレクトリーで下記のコマンドを使います。

deploy --user system --password manager deploy --inplace <app_home>

デプロイヤー・ツールは、インストールされているアプリケーションをリストするために使うこともできます。 list-modules コマンドでアプリケーションをリストできますし、 started や stopped 状態のアプリケーションのリストに絞り込むこともできます。 list-modules コマンドで追加のパラメーターを指定しなかった場合のデフォルトの動きでは、すべてのアプリケーションをリストします。

アプリケーションをアンインストールする場合には最初に正しいComponent Name (またはモジュールID)を入手しなくてはなりません。<geronimo_home>\binディレクトリーから以下のコマンドを実行してください。

deploy --user system --password manager list-modules

下記の例のリストに似た内容が表示されるはずです。

sample.applications/HelloWorldApp/2.0/war のエントリーを探してください。その値が、アンインストールの際に使う値です。

アプリケーションをアンインストールするには、先のモジュールのリストから特定したコンポーネント名を使って、<geronimo_home>\binディレクトリーから下記のコマンドを実行します。

deploy --user system --password manager undeploy sample.applications/HelloWorldApp/2.0/war

このコマンドはまずアプリケーションを停止し、次にアンインストールします。下記のようなメッセージが表示されるはずです。

この例では、同一のツールで３つの異なるコマンドを使ってみました。

• deploy
• list-modules
• undeploy

デプロイヤー・ツールで使えるオプションは他にもあります。更に細かい情報は 1.9. ツールとコマンド セクションを参照してください。

ホット・デプロイ hotdepl

Apache Geronimoは ホット・デプロイメント をサポートしています。つまり、アプリケーションのJARファイルを <geronimo_home>/deploy ディレクトリーにコピーするだけで、アプリケーションを自動的にデプロイさせることができるということです。また、この方法でデプロイされたアプリケーションをアンインストールしたり更新したりすることもできます。単体のJARファイルをコピーするのではなく、アプリケーション・モジュールを含む（パッケージングされていない） ディレクトリー をそのままコピーしても結構です。

ホット・デプロイを使う場合は、 デプロイメント・プラン をアプリケーションのパッケージに含めねばならない点に注意してください。この方法では、外部からデプロイメント・プランを指定することはサポートされていません。また、 1.9.3. Deployer tool - デプロイヤー・ツール や管理コンソールを使ってデプロイされたアプリケーションは <geronimo_home>/deploy ディレクトリー上に現れない点にご注意ください。

あるアプリケーション、たとえばHelloWorld.warを deploy ディレクトリーにコピーすると、アプリケーションがデプロイされたこと、及びそのアプリケーションのコンテキストを示す確認のためのメッセージがGeronimoの稼動中のコンソール上に表示されます。

アプリケーションを除去するには、 deploy ディレクトリーからWARやEARを削除するだけです。アプリケーションが除去されると、アプリケーションがアンデプロイされたことを示すメッセージがGeronimoの稼動中のコンソール上に表示されます。

サマリー

当セクションではアプリケーションをインストール／アンインストールするための３つの異なる方法をご説明しました。グラフィカルなもの、コマンド・ラインのもの、そしてホット・デプロイメント、好みに応じてコマンド・ラインまたはGUIを選択できるわけです。
利用できるオプションやパラメーターの詳細については以降の 1.9. ツールとコマンド セクションを参照してください。