Metro ではじめよう ≫ Metro のインストール

はじめに

この記事では、Metro のソースコードを java.net の CVS リポジ トリから取り出し、ビルドし、できあがったモジュールを Web コ ンテナにインストールする手順を説明します。

やること

• 事前準備
• Metor を Web コンテナへインストールする
• ビルドとインストールがうまくいったことを検証する
• Metro を更新する
• Metro をアンイストールする
• まとめと参考資料

事前準備

Metro のインストールと使用は、いくつかの他のソフトウェアパッ ケージに依存しています。 各パッケージのより詳細な情報を入手するために、それぞれの Web サイトへのリンクが提供されています。

• Metro でサポートされている 2 つの Web コンテナのうちのどちらか: GlassFish か Tomcat
• GlassFish
  オープンソース JavaEE 5 アプリケーションサーバ: GlassFish v2 b30以降が必要です。 まだ GlassFish をインストールしていないなら、 GlassFish の解凍と設定の方法 と GlassFish クイックスタート を参照してください。
• Apache Tomcat 5.5
  version 5.5.16 以降が必要です。
• Sun Java SE5.0 Developers Kit (JDK 5.0): JDK 5.0 Update 2 以降が必要です。 JDK 6.0 も利用できます。
• Apache Ant: Ant version 1.6.5 以降が必要です。
• NetBeans: 任意ですが、NetBeans を使うのであれば version 5.5.1 以降が必要 です。

GlassFish ユーザーへ: 現在、Metro は GlassFish の一部としてバンドルされています。 記載された Metro のビルド (バージョン) が必要でなく、すでに GlassFish を使用してるのでしたら、おそらくはお使いの GlassFish の配布されているバンドルのなかに含まれている Metro を使いたいと 思うことでしょう。 特別な設定なしで、必要に応じてあとで Metro のより新しいバージョ ンに上書きすることができます。GlassFish のインストールバイナリの なかには Ant 1.6.5 も含まれています。GlassFish のインストールの 説明で、より詳しくバンドルバージョンの利用方法について述べられて います。

Metro を Web コンテナへインストールする

二つの重要な Metro の jar ファイルがあります。 webservices-rt.jar と webservices-tools.jar です。 webservices-rt.jar ファイルには、ホスティング する Web コンテナが Metro アプリケーションを実行すると きに、ランタイムで必要なクラスが含まれています。 webservices-tools.jar ファイルには、 apt や wsimport をはじめとする、Web アプリケーションアーカイブ (WAR) ファイルを作るための ビルドツールに必要なクラスが含まれています。

jax-ws-latest-wsit ディレクトリにも二つの ant ファイルがあります。 wsit-on-glassfish.xml と wsit-on-tomcat.xml です。 この二つのファイルは Metro のバイナリをそれぞれの Web コンテナにインストールするのに使われます。手順は次節で 説明します。

GlassFish
Metro を GlassFish にインストールするには、GlassFish のトップレベルディレクトリ を ant に渡さなければなりません。 例えば ant のプ ロパティ値としてコマンドラインから渡します。 インストールしようとしてる GlassFish インスタンスをシャットダ ウンし、ディレクトリを移動し、 install ターゲットを起動します。そして GlassFish インスタンスを起動し ます。以下のコマンドを順番に実行してください :

ビルドとインストールがうまくいったことを検証する

Metro を更新する

Metro をアンインストールする