README for WebApp Library and Related Modules WebAppライブラリーと関連モジュールのREADME --------------------------------------------- How to obtain the WebApp and Apache Portable Runtime sources: WebApp と APR(Apache Portable Runtime) のソースコード取得方法: ------------------------------------------------------------- NOTE: If you downloaded a source distribution from our website or a mirror (the file is called webapp-module...src.tar.gz) you don't need to obtain any other file. Please follow this chapter only if you want to obtain the latest CVS version of the sources. 注意: The Jakarta Project の Web サイトかあるいはミラーサイトから ソースコードのディストリビューション (webapp-module...src.tar.gz という 名前のファイル)をダウンロードした場合はこれ以外に必要になるファイルは ありません。最新版のソースコードを CVS リポジトリから取得したいとき だけ、この章にある手順でダウンロードしてください。 Check out the module sources from CVS using the following commands: CVS から次に示すコマンドを使ってモジュールのソースコードをチェックアウト してください: cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login (Logging in to anoncvs@cvs.apache.org) CVS password: anoncvs cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic \ checkout jakarta-tomcat-connectors/webapp Once CVS downloads the WebApp module sources, we need to download the APR (Apache Portable Runtime) sources. To do this simply: CVS から WebApp モジュールのソースコードをダウンロードし終ったら、 次に APR(Apache Portable Runtime) のソースコードをダウンロードしなければ なりません。これは、次のように実行するだけです: cd ./jakarta-tomcat-connectors/webapp cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic \ checkout apr When the APR sources are in place, we need to create the configure script, configure both APR and the WebApp module and compile: APR のソースコードを適当な場所に置いたら、今度は configure スクリプトを 生成しなければなりません。このスクリプトは APR と WebApp モジュール両方で configure を実行し、コンパイルできるようにするものです: ./support/buildconf.sh To build the sources, now follow the steps in the next chapter. ソースコードからビルドするには、さらに、次の章で説明している手順に 従ってください。 How to build the WebApp module from CVS sources: CVS から取得したソースコードからの WebApp モジュールのビルド方法: ------------------------------------------------ If you downloaded the CVS sources (as described above) or downloaded a source distribution of the WebApp module, now all you need to do is build the binary module for your platform. To do so, start by doing a: CVS にあるソースコードを(上記のように)取得したかあるいは WebApp モジュールの ソースコードディストリビューションをダウンロードした場合は、必要になる作業は 使っているプラットフォームに合うようにバイナリモジュールをビルドすることです。 そのためには次のコマンド実行から始めてください: ./configure --with-apxs make In case your platform needs some flags for APR just put them before the configure. For example: APR 構築のためにフラグが必要になるプラットフォームでは configure の 前に設定してください。例えば次のようにします: ./support/buildconf.sh CC=/usr/bin/cc \ CFLAGS=-DXTI_SUPPORT \ ./configure --with-apxs=/opt/apache/bin/apxs This will configure and build APR, and build the WebApp module for Apache 1.3. The available options for the configure script are: このようにすると configure が実行されて APR がビルドされます。また、 Apache 1.3 用の WebApp モジュールもビルドされます。configure スクリプト では次のオプションを指定できます: --with-apxs[=FILE] Use the APXS Apache 1.3 Extension Tool. If this option is not specified, the Apache module will not be built (only the APR and WEBAPP libraries will be build). The "FILE" parameter specifies the full path for the apxs executable. If this is not specified apxs will be searched in the current path. APXS(Apache 1.3 Extension Tool) を使用する。このオプションが 指定されなかった場合は、Apache のモジュールをビルドしない(APR と WEBAPP ライブラリだけがビルドされる)。 パラメータ "FILE" には apxs コマンドへのフルパスを指定する。指定 されなかった場合はカレントディレクトリから apxs コマンドを見つけ だそうとする。 --with-apr=DIR If you already have the APR sources lying around somewhere, and want to use them instead of checking them out from CVS, you can specify where these can be found. すでに APR のソースコードを持っているけれどどこか別のディレクトリに あり、それを CVS からチェックアウトして取得したソースコードの代りに 使いたい場合、ソースコードを見つけ出せるパスを指定する。 --with-java[=JAVA_HOME] Compile also the Java portion of WebApp. If the JAVA_HOME variable is not set in your environment, you'll have to specify the root path of your JDK installation on this command line. This will generate a new "warp.jar" file in the "java" directory that you must use instead of the one provided with the default Tomcat distribution. For example: WebApp の Java 側のソースコードも同時にコンパイルする。JAVA_HOME 環境変数が設定されていない場合には、コマンドラインのオプションで JDK をインストールしたルートディレクトリを指定しなければならない。 このオプションがあると新規に "warp.jar" ファイルを "java" という 名前のディレクトリに生成する。これを Tomcat 一式に同梱されている ディフォルトのアーカイブと入れ換えなければならない。例えば、次の ように実行する: # mv ./java/warp.jar $CATALINA_HOME/server/lib/warp.jar --with-tomcat[=TOMCAT_HOME] When compiling the Java portion of WebApp, you will also need to specify where a Tomcat 4.0 distribution can be found. This will automatically set up your CLASSPATH environment with the required JAR files included with Tomcat 4.0. WebApp の Java 側のソースコードをコンパイルする場合は、Tomcat 4.0 一式がとこにあるかを指定する必要がある。指定すると Tomcat 4.0 に同梱 されている JAR ファイルのうち必要なものを参照するための CLASSPATH 環境変数が自動的に設定される。 --enable-debug Enable compiled-in debugging output. Using this option the WebApp module, library, and Java counterpart will be built with debugging information. This will create a lot of output in your log files, and will kill performances, but it's a good starting poing when something goes wrong. デバッグ情報出力の有無をコンパイル時に指定するオプション。 このオプションを有効にすると WebApp モジュールとライブラリ、 Java 側の関連クラスがデバッグ情報を出力するようにビルドされる。 ログファイルにかなりの量の出力を行うのでパフォーマンスが犠牲に なるが、何かがまずくてうまく動かない場合には恰好の調査の糸口に なるだろう。 Once built, the DSO module will be found in the webapp/apache-1.3 directory. ビルドが終了すれば、webapp/apache-1.3 ディレクトリに DSO モジュールが あるはずです。 To install it copy the mod_webapp.so file in your Apache 1.3 libexec directory, and add the following lines to httpd.conf: インストールするにはまず、Apache 1.3 の libexec ディレクトリに mod_webapp.so ファイルをコピーし、次に http.conf に以下の行を追加してください: LoadModule webapp_module [path to mod_webapp.so] AddModule mod_webapp.c To check out if everything is correctly configured, issue the following: 以上の作業全てが正しくコンフィギュレーションされたことをチェックするために、 次のコマンドを実行してください: apachectl configtest If the output of the apachectl command doesn't include "Syntax OK", something went wrong with the build process. Please report that through our bug tracking database at or to the Tomcat developers mailing list apachectl コマンドが "Syntax OK" を含むメッセージを出力しなかったら、 それはビルドの仮定で何かに失敗したことを意味しています。そのような場合には バグトラッキングデータベース で報告するか Tomcat の開発者ようメーリングリスト に 投稿してください。 Have fun... お楽しみください... Pier