Cocoonのインストール

2000.08.09更新

■Cocoonのインストールに必要なシステム

  • Java Virtual Machine Java1.1以上の互Virtual Machineがコマンドラインおよび、サー ブレットの実行のどちらでも必要になります。
  • Servlet Engine Servlet 2.x準拠のサーブレットエンジンが必要です。
  • Cocoonは従来、たくさんの基本パッケージをダウンロードする必要があり、 各パッケージの同期の関係で多くの問題を抱えていました。このような問 題から、必要なパッケージを一つにし、ユーザに提供されるようになりま した。

    ■インストール(Apache + JServ環境へのインストール)

    まず、Apache projectのページからCocoonをダウンロードします。本稿記述時の最 新バージョンである、1.7.4を例に以下を解説します。

    次に、Cocoon-1.7.4.tar.gzを/usr/local/java(適当なディレクトリ)に展 開します。
    $ cd /usr/local
    $ tar xvfz Cocoon-1.7.4.tar.gz

    JServの設定ファイル群を編集します。まずはJServ.propertiesから。こ のとき指定するxerces, xalan, fopはCocoonパッケージに同梱されたそれ ぞれ別のサーブレットなので、libディレクトリ配下を見て正しいヴァージョ ンを指定してください。
    $ cd /usr/local/apache/conf/jserv
    $ vi jserv.properties
    wrapper.classpath=/usr/local/jdk1.2.2/lib/tools.jar
    wrapper.classpath=/usr/local/java/cocoon-1.7.4/bin/cocoon.jar
    wrapper.classpath=/usr/local/java/cocoon-1.7.4/lib/xerces_1_0_3.jar
    wrapper.classpath=/usr/local/java/cocoon-1.7.4/lib/xalan_1_0_1.jar
    wrapper.classpath=/usr/local/java/cocoon-1.7.4/lib/fop_0_12_1.jar

    次にゾーン設定ファイルを編集します。JServインストールのときに作成 したゾーンservletsの設定ファイルに追加した例を示します。(実際は1行 です)
    $ vi servlets.properties
    servlet.org.apache.cocoon.Cocoon.initArgs=properties=/usr/local/java/cocoon-1.7.4/conf/cocoon.properties

    次に、.xmlのファイルを読み込んだときにCocoonサーブレットが呼び出さ れるように、次の記述をjserv.confに追加します。(JServ2.0ではコメン トになっていますので、コメントを外すだけで良いでしょう)
    $ vi jserv.conf
    ApJServAction .xml /servlets/org.apache.cocoon.Cocoon

    リポジトリを置く場所を決めてください。ここでは /home/httpd/cocoon/repositoryとしました。
    $ mkdir /home/httpd/cocoon/repository
    $ chown nobody:nobody repository
    $ chmod 775 repository

    今作成した、ディレクトリをCocoonが使用できるように、 cocoon.propertiesを編集します。cocoon.propertiesは、 cocoon-1.7.4/confにあります。
    $ vi cocoon.properties
    processor.xsp.repository=/home/httpd/cocoon/repository

    ■動作確認

    以上で設定はおわりです。cocoon-1.7.4のディレクトリにはsamplesディ レクトリがあるので、これをアクセスできる位置にコピーして動作確認を 行ってみましょう。
    $ cp cocoon-1.7.4/samples /home/httpd/html

    これで、http://localhost/samples/index.xmlで、xml非対応のブラウザ からもindex.xmlが見られるか確認してください。
    戻る