]> granicus.if.org Git - apache/blob - docs/manual/install.xml.ja
Convert Japanese translations from ISO-2022-JP to UTF-8
[apache] / docs / manual / install.xml.ja
1 <?xml version="1.0" encoding="UTF-8" ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.ja.xsl"?>
4 <!-- English Revision: 395228:527129 (outdated) -->
5
6 <!--
7  Licensed to the Apache Software Foundation (ASF) under one or more
8  contributor license agreements.  See the NOTICE file distributed with
9  this work for additional information regarding copyright ownership.
10  The ASF licenses this file to You under the Apache License, Version 2.0
11  (the "License"); you may not use this file except in compliance with
12  the License.  You may obtain a copy of the License at
13
14      http://www.apache.org/licenses/LICENSE-2.0
15
16  Unless required by applicable law or agreed to in writing, software
17  distributed under the License is distributed on an "AS IS" BASIS,
18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  See the License for the specific language governing permissions and
20  limitations under the License.
21 -->
22
23 <manualpage metafile="install.xml.meta">
24
25   <title>コンパイルとインストール</title>
26
27 <summary>
28
29     <p>この文書で扱う範囲は、Unix や Unix に類似したシステムでの
30     Apache のコンパイルとインストールです。 Windows における
31     コンパイルとインストールに関しては「<a
32     href="platform/windows.html">Microsoft
33     Windows で Apache を使う</a>」をご覧下さい。
34     その他のプラットホームに関しては「<a 
35     href="platform/">プラットホーム</a>」をご覧下さい。</p>
36
37     <p>Apache 2.0 では他の Open Source プロジェクトと同様、
38     ビルド環境構築に <code>libtool</code> と <code>autoconf</code>
39     を使うようになっています。</p>
40
41     <p>マイナーバージョンからその次のバージョンにアップグレードする
42     (2.2.50 から 2.2.51 へ等) 場合は、まず <a href="#upgrading">
43     アップグレード</a>をご覧下さい。</p>
44
45 </summary>
46
47 <seealso><a href="programs/configure.html">ソースツリーの設定</a></seealso>
48 <seealso><a href="invoking.html">Apacheの起動</a></seealso>
49 <seealso><a href="stopping.html">Apacheの停止と再起動</a></seealso>
50
51 <section id="overview"><title>概要 (せっかちな人向け)</title>
52
53     <table>
54       <columnspec><column width=".13"/><column width=".80"/></columnspec>
55       <tr>
56         <td><a href="#download">ダウンロード</a></td>
57
58         <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
59         </td>
60       </tr>
61
62       <tr>
63         <td><a href="#extract">展開</a></td>
64
65         <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
66          $ tar xvf httpd-<em>NN</em>.tar<br />
67          $ cd httpd-<em>NN</em></code></td>
68       </tr>
69
70       <tr>
71         <td><a href="#configure">設定</a></td>
72
73         <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
74         </td>
75       </tr>
76
77       <tr>
78         <td><a href="#compile">コンパイル</a></td>
79
80         <td><code>$ make</code> </td>
81       </tr>
82
83       <tr>
84         <td><a href="#install">インストール</a></td>
85
86         <td><code>$ make install</code> </td>
87       </tr>
88
89       <tr>
90         <td><a href="#customize">カスタマイズ</a></td>
91
92         <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
93       </tr>
94
95       <tr>
96         <td><a href="#test">テスト</a></td>
97
98         <td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
99         </td>
100       </tr>
101     </table>
102
103     <p><em>NN</em> は最新のバージョンナンバーに、
104     <em>PREFIX</em> はインストールするサーバでのファイルシステムのパスに、
105     置き換えてください。<em>PREFIX</em> を指定しなかった場合は、
106     デフォルトの <code>/usr/local/apache2</code> になります。</p>
107
108     <p>Apache httpd のコンパイルとインストールに必要なものをはじめとして、
109     コンパイルとインストールについては、次に詳しく記述されています。</p>
110 </section>
111
112 <section id="requirements"><title>必要なもの</title>
113
114     <p>Apache のビルドには次のものが必要です:</p>
115
116     <dl>
117       <dt>ディスクスペース</dt>
118       <dd>ディスクに少なくとも 50 MB の一時的な空き容量があるように
119       気を付けてください。インストール後は Apache は 10 MB 程度の
120       ディスクスペースを占めます。実際に必要になるディスクスペースは、
121       設定オプションやサードパーティー製モジュールをどう選択するかによって
122       大きく変わるでしょう。</dd>
123
124       <dt>ANSI-C コンパイラとビルドシステム</dt>
125       <dd>ANSI-C コンパイラをインストールしておいて下さい。お薦めは <a
126       href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
127       による <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
128       compiler (GCC)</a> です。GCC がない場合は、
129       少なくとも提供されているコンパイラが ANSI 準拠であることを確認しておいて下さい。
130       それから、変数 <code>PATH</code> には <code>make</code>
131       といった基本的なビルドツールが含まれている必要があります。</dd>
132
133       <dt>時刻を正確にする</dt>
134       <dd>HTTP プロトコルの要素は日時の時刻で表現されています。ですから、
135       正確な時刻にシンクロさせる機能をシステムに設定することを吟味してみて下さい。
136       Network Time Protocol (NTP) をベースとした ntpdate や xntpd プログラムが
137       この目的によく用いられます。NTP ソフトウェアや公開 NTP 
138       サーバに関する詳細は、<a
139       href="http://www.ntp.org">NTP ホームページ</a> をご覧下さい。</dd>
140
141       <dt><a href="http://www.perl.org/">Perl 5</a>
142       [オプション]</dt>
143       <dd>提供されているスクリプト幾つか、例えば <program>apxs</program> や
144       <program>dbmmanage</program> は
145       Perl で書かれているので、Perl 
146       5 インタプリタが必要になります (5.003 以降)。
147       Perl インタプリタを複数インストールしている (たとえば全体のシステムの一部
148       としてインストールされている Perl 4 と、自分で追加でインストールした
149       Perl 5 があるなどの) 場合、<code>--with-perl</code> オプション (下記参照)
150       を使って <program>configure</program> が意図したものを使うように
151       明示的に指定すると良いでしょう。
152       <program>configure</program> スクリプトで Perl 5 インタプリタが
153       見つからない場合は、この影響を受けるサポートスクリプトが使えなくなります。
154       もちろん、Apache httpd のコンパイルとインストールは問題なく行えます。</dd>
155     </dl>
156 </section>
157
158 <section id="download"><title>ダウンロード</title>
159
160     <p>Apache HTTP サーバは <a
161     href="http://httpd.apache.org/download.cgi">Apache HTTP
162     サーバダウンロードサイト</a>からダウンロードできますし、
163     同じ場所に幾つかのミラーサイトもリストしています。
164     UNIX に類似するシステムで Apache を使うユーザは、ソースを
165     ダウンロードしてビルドしたほうが良いでしょう。
166     ビルドの手順(下記)は簡単ですし、そのおかげでニーズに
167     見合ったカスタマイズを簡単にできます。
168     さらに、バイナリのリリースはソースリリースよりも
169     遅れていることがよくあります。
170     それでもバイナリをダウンロードしたのであれば、
171     ディストリビューションの中にある <code>INSSTALL.bindist</code> 
172     ファイルの説明に従ってください。</p>
173
174     <p>ダウンロード後、ダウンロードしたものが Apache HTTP 
175     サーバの完全で改竄されていないバージョンであることを
176     検証することが重要です。これはダウンロードした tarball の PGP 署名を
177     テストすることによって検証します。
178     この手順の詳細は <a 
179     href="http://httpd.apache.org/download.cgi#verify">ダウンロード
180     ページ</a> にあり、さらに詳しい例は <a
181     href="http://httpd.apache.org/dev/verification.html">PGP の使用
182     </a> に記載されています。</p>
183
184 </section>
185
186 <section id="extract"><title>展開</title>
187
188     <p>Apache HTTPD の tarball
189     からソースファイルを展開して取り出すとは、
190     単なる圧縮の解除と tar の展開です:</p>
191
192 <example>
193 $ gzip -d httpd-<em>NN</em>.tar.gz<br />
194 $ tar xvf httpd-<em>NN</em>.tar
195 </example>
196
197     <p>配布用のソースコードがある現在いるディレクトリの下に、
198     新しいディレクトリが作られます。
199     サーバをコンパイルする段階に進む前に、そのディレクトリに
200     <code>cd</code> で移動してください。</p>
201 </section>
202
203 <section id="configure"><title>ソースツリーを設定する</title>
204
205     <p>次のステップは、あなたのプラットホームと
206     個人的な要求に合うように Apache
207     ソースツリーを設定することです。
208     これは配布ディレクトリのルートディレクトリにある、
209     <program>configure</program>
210     スクリプトで行ないます。
211      (Apache ソースツリーの未リリース
212     版をダウンロードした開発者は、次のステップに進む前に
213     <code>autoconf</code> と<code>libtool</code>
214     をインストールして <code>buildconf</code>
215     を実行する必要があります。
216     公式リリースではこの作業は必要ありません。) </p>
217
218     <p>デフォルトオプションを使ってソースツリーを全て設定する
219     のであれば、単純に <code>./configure</code> とタイプしてください。
220     デフォルトオプションを変更できるように、<program>configure</program>
221     には様々な変数やコマンドラインオプションが用意されています。</p>
222
223     <p>最も重要なオプションは、Apache がこの後でインストールされる位置
224     <code>--prefix</code> です。Apache は、このインストール位置に
225     おいて正常に動作するように設定しなければならないからです。
226     さらに詳細なファイル位置の制御は追加の <a
227     href="programs/configure.html#installationdirectories">設定オプション
228     </a> でできます。</p>
229
230     <p>この時点で、<a href="mod/">モジュール</a> を有効にしたり
231     無効にしたりすることで Apache 本体に含まれる <a 
232     href="programs/configure.html#optionalfeatures">機能</a>
233     を指定できます。Apache 本体にはデフォルトで、モジュールの <a 
234     href="mod/module-dict.html#Status">Base</a> セットが
235     含まれます。その他のモジュールは 
236     <code>--enable-<var>module</var></code> オプションで
237     有効になります。ここで <var>module</var> はモジュールの名前で、
238     つまりそれはモジュールの名前から <code>mod_</code> 文字列を取り除いた後に
239     アンダースコアをダッシュで置換した文字列です。
240     これとは別の方法で <code>--enable-<var>module</var>=shared</code>
241     オプションを使って、モジュールを<a href="dso.html">
242     シェアードオブジェクト (DSO)</a> -- 実行時にロードしたり
243     アンロードしたりできる形式 -- としてコンパイルすることもできます。
244     同様に、<code>--disable-<var>module</var></code> オプションで
245     Base モジュールを無効化することもできます。
246     これらのオプションを使っているときに、もし指定したモジュールが存在しなくても
247     <program>configure</program> は警告を上げることなく、単純にオプションを
248     無視することに気をつけてください。</p>
249
250     <p>上記に加えて、<program>configure</program> スクリプトに、
251     コンパイラ、ライブラリ、ヘッダファイルの位置を追加情報として渡す
252     必要がある場合があります。このような場合には、環境変数あるいは
253     コマンドラインオプションで <program>configure</program> に渡します。
254     詳細に関しては <program>configure</program> マニュアルページ
255     をご覧ください。</p>
256
257     <p>ちょっとどんなことができるかを見せましょう。
258     ここで典型的な例として、<code>/sw/pkg/apache</code> 
259     というインストールツリーでコンパイラとフラグを指定して、
260     さらに二つの追加モジュール <module>mod_rewrite</module> と
261     <module>mod_speling</module> を後で DSO 
262     メカニズムでロードするようにコンパイルしてみます:</p>
263
264 <example>
265       $ CC="pgcc" CFLAGS="-O2" \<br />
266        ./configure --prefix=/sw/pkg/apache \<br />
267        --enable-rewrite=shared \<br />
268        --enable-speling=shared
269 </example>
270
271     <p><program>configure</program> を実行したら、システムの機能を
272     テストしたり、後でサーバをコンパイルするために必要な Makefile
273     を生成したりするのに数分間かかるでしょう。</p>
274
275     <p>個々の <program>configure</program> オプションの詳細に関しては
276     <program>configure</program> マニュアルページ
277     をご覧ください。</p>
278 </section>
279
280 <section id="compile"><title>ビルド</title>
281
282     <p>これで Apache の様々なパーツをビルドすることができます。
283     次のコマンドを単純に実行するだけです:</p>
284
285 <example>$ make</example>
286
287     <p>基本的な設定をするのに数分かかりますが、
288     あらかじめご了承ください。
289     また、時間はハードウェアや有効にしたモジュールの数に
290     大きく依存するでしょう。</p>
291 </section>
292
293 <section id="install"><title>インストール</title>
294
295     <p>さて、設定したインストール <em>PREFIX</em> 
296      (前述の <code>--prefix</code> オプションを参照) 
297     以下にパッケージをインストールする段階になりました。
298     次のコマンドを実行してください:</p>
299
300 <example>$ make install</example>
301
302     <p>アップグレードする場合は、インストールでは設定ファイルや
303     ドキュメントファイルの上書きは行いません。</p>
304 </section>
305
306 <section id="customize"><title>カスタマイズ</title>
307
308     <p>次に <code><em>PREFIX</em>/conf/</code> 以下にある <a
309     href="configuring.html">設定ファイル</a>を編集して、
310     Apache HTTP サーバをカスタマイズします。</p>
311
312 <example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>
313
314     <p><a href="./">docs/manual/</a> の Apache マニュアルをざっと見てください。
315     または、<a
316     href="http://httpd.apache.org/docs/&httpd.docs;/"
317     >http://httpd.apache.org/docs/&httpd.docs;/</a>
318     にあるマニュアル最新版、<a
319     href="mod/directives.html">設定ディレクティブ</a>に当たってみてください。</p>
320 </section>
321
322 <section id="test"><title>テスト</title>
323
324     <p>次のコマンドを実行して Apache HTTP サーバを<a
325     href="invoking.html">開始</a>できます:</p>
326
327 <example>$ <em>PREFIX</em>/bin/apachectl -k start</example>
328
329     <p>URL <code>http://localhost/</code> を通して最初のドキュメントに対する
330     リクエストを発行する事ができるはずです。これで見える
331     ウェブページは <directive module="core">DocumentRoot</directive>
332     以下に置かれたもので、通常は
333     <code><em>PREFIX</em>/htdocs/</code> でしょう。
334     サーバを再び<a href="stopping.html">停止</a>するには、
335     次のコマンドを実行します:</p>
336
337 <example>$ <em>PREFIX</em>/bin/apachectl -k stop</example>
338 </section>
339 <section id="upgrading"><title>アップグレード</title>
340
341     <p>アップグレードでまず行なうべきことは、リリースアナウンスと
342     ソースディストリビューションに入っている <code>CHANGES</code> を読んで、
343     自身のサイトに対して影響を及ぼす変更点を探すことです。
344     メジャーリリース間の変更をする場合 (例えば 1.3 から 2.0 へ、2.0 から 2.2 へ)
345     は、コンパイル時や実行時の設定に大きな差異があるでしょうから、
346     手動の調整が必要になるでしょう。モジュールも全て、API
347     の変更に合わせるためにアップグレードが必要になるでしょう。</p>
348
349     <p>マイナーバージョンから次のバージョンにアップグレードする場合
350     (例えば 2.2.55 から 2.2.57 へ) は、もっと簡単です。
351     <code>make install</code> を実行しても今あるドキュメント、
352     ログファイル、設定ファイルは上書きされません。
353     さらに、マイナーバージョン間では <program>configure</program> オプション、
354     実行時の設定、モジュール API に不整合が起こらないように、
355     開発者は最大限の努力をしています。
356     大抵の場合、同一の <program>configure</program> コマンドライン、
357     同一の設定ファイル、モジュール全てが正常に動作するはずです。</p>
358
359     <p>マイナーバージョンでアップグレードする場合は、
360     既にインストールされているサーバの <code>build</code> ディレクトリ内か、
361     以前インストールに使ったソースコードツリーの最上位ディレクトリ内にある、
362     <code>config.nice</code> ファイルを探してください。
363     このファイルにはソースツリーを設定した時に使った
364     <program>configure</program> コマンドラインが、そのまま入っています。
365     次のバージョンにアップグレードする場合は <code>config.nice</code>
366     ファイルを新しいバージョンのソースツリーにコピーし、
367     必要であればそれを編集した後に、次のように実行します。</p>
368
369     <example>
370     $ ./config.nice<br />
371     $ make<br />
372     $ make install<br />
373     $ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
374     $ <em>PREFIX</em>/bin/apachectl -k start<br />
375     </example>
376
377     <note type="warning">新しいバージョンを使用する場合は、
378     実際に運用を始める前に、必ず自分用の環境でテストすべきです。
379     最終的にアップグレードする前に、非互換性がないかをテストするために、
380     例えば、異なる <code>--prefix</code> と異なるポート (<directive
381     module="mpm_common">Listen</directive> ディレクティブで設定します) 
382     を使用することで、古いバージョンに影響を与えずに新しいバージョンを
383     インストールし、実行できます。</note>
384 </section>
385 </manualpage>