<?xml version="1.0" encoding="Shift_JIS"?>
<document url="./installation-tc31.xml">

  <properties>
    <author>Craig R. McClanahan</author>
    <title>The Struts Framework Project - Installation - Tomcat 3.1 with Apache</title>
    <translator>高橋 一隆</translator>
  </properties>

  <body>

<primary>
<section name="Installing Struts with your servlet container" href="Containers"> 
</section>
</primary>
<section name="サーブレットコンテナにStrutsをインストールする" href="Containers"> 

<primary>
<h3><a name="tc31">Tomcat 3.1 (Or Later) With Apache</a></h3>

<ul>
  <li>These instructions assume you have successfully integrated Tomcat with Apache 
    according to the Tomcat documentation.</li>
  <li>Copy "struts-documentation.war" and "struts-example.war" to your $TOMCAT_HOME/webapps 
    directory</li>
  <li>Restart Tomcat if it is already running</li>
  <li>Tomcat will generate a file "$TOMCAT_HOME/conf/tomcat-apache.conf" that 
    will be used by Apache. This file is regenerated every time you start Tomcat, 
    so copy this file to a safe place (such as your Apache configuration directory; 
    on Unix systems this is usually <code>/usr/local/apache/conf</code>.</li>
  <li>If you are running Tomcat 3.1, Tomcat will not have generated the entries 
    for your new applications. Add the following lines to the <code>tomcat-apache.conf</code> 
    file that you have saved, replacing $TOMCAT_HOME with the path to your Tomcat 
    home directory:</li>
</ul>
</primary>
<h3><a name="tc31">Tomcat 3.1 (以降) と Apache</a></h3>

<ul>
  <li>この手引きは、あなたが Tomcat ドキュメントに沿って Tomcat と Apache を連携できていることを想定しています。</li>
  <li>"struts-documentation.war" と "struts-example.war" を、 $TOMCAT_HOME/webapps
    ディレクトリにコピーしてください。</li>
  <li>Tomcat が実行中ならば再起動します。</li>
  <li>Tomcat は "$TOMCAT_HOME/conf/tomcat-apache.conf" ファイルを生成し、生成されたファイルは 
    Apache により使用されます。このファイルは Tomcat を開始するたびに再生成されますので、
    このファイルを安全な場所にコピーしてください。 (例えば Apache の設定ディレクトリ; 
    Unix システム上では通常 <code>/usr/local/apache/conf</code>です。</li>
  <li>Tomcat 3.1 の場合、Tomcat は新しいアプリケーションのエントリを追加しないでしょう。
    以下の行を保存した <code>tomcat-apache.conf</code> ファイルに追加し、
    $TOMCAT_HOME をあなたの Tomcat ホーム・ディレクトリに変更します:</li>
</ul>
<pre>
Alias /struts-documentation "$TOMCAT_HOME/webapps/struts-documentation
  &lt;Directory "$TOMCAT_HOME/webapps/struts-documentation>
    Options Indexes FollowSymLinks
  &lt;/Directory>
    ApJServMount /struts-documentation/servlet /struts-documentation
  &lt;Location "/struts-documentation/WEB-INF/">
    AllowOverride None
    deny from all
  &lt;/Location>
Alias /struts-example "$TOMCAT_HOME/webapps/struts-example"
  &lt;Directory "$TOMCAT_HOME/webapps/struts-example>
    Options Indexes FollowSymLinks
  &lt;/Directory>
    ApJServMount /struts-example/servlet /struts-example
  &lt;Location "/struts-example/WEB-INF/">
    AllowOverride None
    deny from all
  &lt;/Location>
</pre>
<primary>
<ul>
  <li>On all versions of Tomcat, the generated file above does not know anything 
    about extension mappings defined in a web.xml file, so the "*.do" URIs that 
    go to the controller servlet will not be recognized. To fix this, add the 
    following line to the saved version of "tomcat-apache.conf", after the corresponding 
    line for the .jsp extension:<br/>
    <code>AddHandler jserv-servlet .do</code></li>
  <li>Ensure that the saved version of "tomcat-apache.conf" is referenced in your 
    Apache "httpd.conf" configuration file. A typical use would have the following 
    line at the bottom of "httpd.conf":<br/>
    <code>Include /usr/local/apache/conf/tomcat-apache.conf</code></li>
  <li>In order to recognize "index.jsp" as a default page for web applications, 
    search in your "httpd.conf" for a "DirectoryIndex" directive. If you have 
    one, add "index.jsp" to the end of the list, so that it might look like this:<br/>
    <code>DirectoryIndex index.html index.jsp</code><br/>
    If you do not have such an entry, add one like this:<br/>
    <code>DirectoryIndex index.jsp</code></li>
  <li>Restart Apache to make it aware of the new applications. You should now 
    be able to access the applications from a browser like this:<br/>
    <code>http://localhost/struts-documentation<br/>
    http://localhost/struts-example</code></li>
</ul>
</primary>
<ul>
  <li>全てのバージョンの Tomcat 上で、上述の生成されたファイルは、 web.xml ファイルで
    定義された拡張子マッピングについては何も知りませんので、コントローラ・サーブレットへ
    転送される"*.do" の URI は認識されません。
    これを修正するには、保存された "tomcat-apache.conf"の.jsp 拡張子の該当行の後に、
    以下の行を追加してください:<br/>
    <code>AddHandler jserv-servlet .do</code></li>
  <li>保存された "tomcat-apache.conf" があなたの Apache の "httpd.conf" 設定ファイルで
    参照されていることを確認してください。 典型的な使用法では、以下の行が
    "httpd.conf" の末尾に存在します:<br/>
    <code>Include /usr/local/apache/conf/tomcat-apache.conf</code></li>
  <li>index.jsp" をウェブ・アプリケーションのデフォルトページとして認識させるは、
    "httpd.conf" 中で "DirectoryIndex" ディレクティブを探してください。見つかったならば、
    "index.jsp" をリストの末尾に追加します。結果、このようになるでしょう:<br/>
    <code>DirectoryIndex index.html index.jsp</code><br/>
    そのようなエントリがないならば、このようなエントリを追加してください:<br/>
    <code>DirectoryIndex index.jsp</code></li>
  <li>Apache を再起動することで、新しいアプリケーションを認識させます。 これで 
    ブラウザからアプリケーションにアクセスできるようになったはずです:<br/>
    <code>http://localhost/struts-documentation<br/>
    http://localhost/struts-example</code></li>
</ul>
  <hr/>
<primary>
  <ul><li>Author: Craig R. McClanahan</li></ul>
  <hr/>
  <p>Back to <a href="installation.html#Containers">Installation</a></p>
</primary>
  <ul><li>著者: Craig R. McClanahan</li></ul>
  <hr/>
  <p><a href="installation.html#Containers">インストール</a>へ戻る</p>
</section>
</body>
</document>
