From cba81eaaaa6a1903be45363edf18d0c7ac6675f6 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Andr=C3=A9=20Malo?= Date: Sat, 10 Apr 2004 14:21:18 +0000 Subject: [PATCH] update transformation git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@103330 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/install.html.ja.jis | 402 ++++--------------------- docs/manual/install.xml.meta | 2 +- docs/manual/mod/mod_log_config.html.en | 2 +- docs/manual/mod/mod_log_config.xml.ja | 2 +- 4 files changed, 61 insertions(+), 347 deletions(-) diff --git a/docs/manual/install.html.ja.jis b/docs/manual/install.html.ja.jis index 87125dfe1c..538a86fe36 100644 --- a/docs/manual/install.html.ja.jis +++ b/docs/manual/install.html.ja.jis @@ -23,8 +23,6 @@  ja  |  ko 

-
This translation may be out of date. Check the - English version for recent changes.

この文書で扱う範囲は、Unix や Unix に類似したシステムでの @@ -55,7 +53,7 @@

  • カスタマイズ
  • テスト
  • アップグレード
    • -

    参照

    +

    参照

    top

    概要 (せっかちな人向け)

    @@ -144,7 +142,7 @@ 正確な時刻にシンクロさせる機能をシステムに設定することを吟味してみて下さい。 Network Time Protocol (NTP) をベースとした ntpdate や xntpd プログラムが この目的によく用いられます。NTP ソフトウェアや公開 NTP - サーバに関する詳細は、Usenet ニュースグループ comp.protocols.time.ntp や NTP ホームページ をご覧下さい。 + サーバに関する詳細は、Usenet ニュースグループ comp.protocols.time.ntp や NTP ホームページ をご覧下さい。
    Perl 5 [オプション]
    @@ -167,56 +165,23 @@

    Apache は Apache HTTP サーバダウンロードサイトからダウンロードできますし、 同じ場所に幾つかのミラーサイトもリストしています。 - ここから最新の安定版が手に入ります。

    - -

    ダウンロード後、特にミラーサイトを使った場合は、 - ダウンロードしたものが Apache HTTP + UNIX に類似するシステムで Apache を使うユーザは、ソースを + ダウンロードしてビルドしたほうが良いでしょう。 + ビルドの手順（下記）は簡単ですし、そのおかげでニーズに + 見合ったカスタマイズを簡単にできます。 + さらに、バイナリのリリースはソースリリースよりも + 遅れていることがよくあります。 + それでもバイナリをダウンロードしたのであれば、 + ディストリビューションの中にある INSSTALL.bindist + ファイルの説明に従ってください。

    + +

    ダウンロード後、ダウンロードしたものが Apache HTTP サーバの完全で改竄されていないバージョンであることを 検証することが重要です。これはダウンロードした tarball の PGP 署名を テストすることによって検証します。 - これは二つの段階があります。 - まず KEYS - ファイルを Apache 配布サイト - からダウンロードしてください。(KEYS ファイル自体が - 改竄されていないことを確実にするために、以前の Apache - 配布から取り出したファイルを使ったり、 - 公開鍵サーバから鍵を取り込むのもいいでしょう。) - 自分の個人キーホルダーに鍵を取り込むには、 - 次のコマンド (pgp のバージョンに依存) を使います:

    - -

    $ pgp < KEYS

    - -

    または、

    - -

    $ gpg --import KEYS

    - -

    次のステップでは、tarball を PGP 署名でテストします。 - PGP 署名は必ず メインの Apache - ウェブサイトから取得してください。 - 署名ファイルへのリンクは対応するダウンロードリンクの隣にあり、また - Apache - 配布サイトの特定のディレクトリで見つけることもできるでしょう。 - 署名ファイルの名前は、ソースファイルの tarball と同じ名前に - .asc を付加したものになっています。 - 以下のコマンド (やっぱり pgp のバージョンに依存) のどれか一つで、 - 配布ファイルをチェックすることができます:

    - -

    $ pgp httpd-2_1_NN.tar.gz.asc

    - -

    または、

    - -

    $ gpg --verify httpd-2_1_NN.tar.gz.asc

    - -

    すると、こんなメッセージを受けるはずです。

    - -

    Good signature from user "Martin Kraemer - <martin@apache.org>".

    - -

    自分のキーホルダーに格納されている信頼関係が原因で、 - "鍵とその鍵の署名者が検証できなかった" - という旨のメッセージを同時に受けるかもしれません。 - しかし、KEYS - ファイルの信憑性を受け入れるならば問題ではありません。

    + この手順の詳細は ダウンロード + ページ にあり、さらに詳しい例は PGP の使用 + に記載されています。

    top
    @@ -227,8 +192,8 @@ 単なる圧縮の解除と tar の展開です:

    - $ gzip -d httpd-2_1_NN.tar.gz
    - $ tar xvf httpd-2_1_NN.tar +$ gzip -d httpd-2_1_NN.tar.gz
    +$ tar xvf httpd-2_1_NN.tar

    配布用のソースコードがある現在いるディレクトリの下に、 @@ -242,8 +207,9 @@

    次のステップは、あなたのプラットホームと 個人的な要求に合うように Apache ソースツリーを設定することです。 - これは配布ディレクトリのルートディレクトリにある、 - configure スクリプトで行ないます。 + これは配布ディレクトリのルートディレクトリにある、 + configure + スクリプトで行ないます。 (Apache ソースツリーの CVS 版をダウンロードした開発者は、次のステップに進む前に autoconf とlibtool @@ -254,14 +220,38 @@

    デフォルトオプションを使ってソースツリーを全て設定する のであれば、単純に ./configure とタイプしてください。 デフォルトオプションを変更できるように、configure - には様々な変数やコマンドラインオプションが用意されています。 - 一般的に、環境変数が ./configure の前に設置されて、 - 他のオプションはその後に設置されます。 - ここで最も重要なオプションは Apache - をどこにインストールするかを決める location prefix です。 - なぜなら、Apache が正しく動作するためには - この場所用に設定されていないといけないからです。 - しかし、お好みにより利用できるオプションはもっと沢山あります。

    + には様々な変数やコマンドラインオプションが用意されています。

    + +

    最も重要なオプションは、Apache がこの後でインストールされる位置 + --prefix です。Apache は、このインストール位置に + おいて正常に動作するように設定しなければならないからです。 + さらに詳細なファイル位置の制御は追加の 設定オプション + でできます。

    + +

    この時点で、モジュール を有効にしたり + 無効にしたりすることで Apache 本体に含まれる 機能 + を指定できます。Apache 本体にはデフォルトで、モジュールの Base セットが + 含まれます。その他のモジュールは + --enable-module オプションで + 有効になります。ここで module はモジュールの名前で、 + つまりそれはモジュールの名前から mod_ 文字列を取り除いた後に + アンダースコアをダッシュで置換した文字列です。 + これとは別の方法で --enable-module=shared + オプションを使って、モジュールを + シェアードオブジェクト (DSO) -- 実行時にロードしたり + アンロードしたりできる形式 -- としてコンパイルすることもできます。 + 同様に、--disable-module オプションで + Base モジュールを無効化することもできます。 + これらのオプションを使っているときに、もし指定したモジュールが存在しなくても + configure は警告を上げることなく、単純にオプションを + 無視することに気をつけてください。

    + +

    上記に加えて、configure スクリプトに、 + コンパイラ、ライブラリ、ヘッダファイルの位置を追加情報として渡す + 必要がある場合があります。このような場合には、環境変数あるいは + コマンドラインオプションで configure に渡します。 + 詳細に関しては configure マニュアルページ + をご覧ください。

    ちょっとどんなことができるかを見せましょう。 ここで典型的な例として、/sw/pkg/apache @@ -281,285 +271,9 @@ テストしたり、後でサーバをコンパイルするために必要な Makefile を生成したりするのに数分間かかるでしょう。

    -

    Apache の全ての設定フラグを見る最も簡単な方法は、 - ./configure --help を実行する方法です。 - 引数や環境変数に関する簡単な記述が出力されます。

    - -

    環境変数

    - -

    autoconf でのビルドでは幾つかの環境変数を使ってビルド環境を - 設定します。一般的に、これらの変数で Apache をビルドする際の - 方法が変わったりしますが、できあがるサーバの機能には影響ありません。 - これらの変数は configure を呼び出す直前の環境中に - 置くことができますが、通常は上に示した例のように configure - のコマンドラインでもっと簡単に指定できます。

    - -
    -
    CC=...
    - -
    C コンパイラのコマンド名。
    - -
    CPPFLAGS=...
    - -
    その他の C プリプロセッサやコンパイラのオプション。
    - -
    CFLAGS=...
    - -
    C コンパイラのデバッグ・最適化オプション。
    - -
    LDFLAGS=...
    - -
    その他のリンカに渡されるオプション。
    - -
    LIBS=...
    - -
    リンカに渡すライブラリの位置情報 - ("-L"と"-l"オプション) 。 -
    - -
    INCLUDES=...
    - -
    ヘッダファイルの探索ディレクトリ ("-Idir") 。
    - -
    TARGET=... [デフォルト値: httpd]
    - -
    ビルドする実行ファイルの名前。
    - -
    NOTEST_CPPFLAGS=...
    - -
    NOTEST_CFLAGS=...
    - -
    NOTEST_LDFLAGS=...
    - -
    NOTEST_LIBS=...
    - -
    これらの変数は "NOTEST でない版" のものと同じ機能を - 持っています。しかし、これらの変数は autoconf - がテストを行った後のビルドプロセスにおいてのみ、適用されます。 - これを使うと、テスト中に問題を起すけれども - 最終的には必要になるフラグを - 含めることができるようになります。
    - -
    SHLIB_PATH=...
    - -
    コンパイラとリンカに渡す、共有ライブラリへのパスを指定する - オプション。
    -
    - - -

    autoconf 出力オプション

    - -
    -
    --help
    - -
    使用可能な全オプションなど使い方をプリントします。 - 実際に設定はされません。
    - -
    --quiet
    - -
    "cheking..." といったメッセージがプリントされないように - します。
    - -
    --verbose
    - -
    検査される全ファイル名を含め、設定プロセス中に - 情報をたくさんプリントします。
    -
    - - -

    パス名

    - -

    Apache をインストールするパス名を設定するには、 - 現在二通りの方法があります。まず一つ目は、 - ディレクトリを指定して、その下にデフォルトの配置で - Apache のインストールを行う方法です。

    - -
    -
    --prefix=PREFIX [デフォルト値: - /usr/local/apache2]
    - -
    Apache のファイル群がインストールされるディレクトリを - 指定します。
    -
    - -

    アーキテクチャに依存したファイルを、 - 異なるディレクトリに配置するようにもできます。

    - -
    -
    --exec-prefix=EPREFIX - [デフォルト値: PREFIX]
    - -
    アーキテクチャ依存のファイルを配置すべき - ディレクトリを指定します。
    -
    - -

    二つ目の方法は、もっと柔軟にインストールパスの配置を - 設定する方法で、config.layout ファイルを - 使います。この方法を使うことによって、 - Apache のインストール中に、それぞれのファイルのための配置を - 個々に指定できるようになります。config.layout - ファイルには設定例が幾つか含まれていますし、 - お好みの設定を次の例に従って作り出すこともできます。 - このファイル中では、異なる配置は <Layout - FOO>...</Layout> セクションでグループ化され、 - FOO といった名前で参照されます。

    - -
    -
    --enable-layout=LAYOUT
    - -
    インストールパスを指定するため、 - config.layout ファイル中での、 - 指定された名前のレイアウトを使用します。
    -
    - - - -

    モジュール

    - -

    Apache はモジュール化されたサーバです。 - ごくごく基本的な機能だけが、コアサーバに含まれています。 - 拡張機能は様々なモジュールの形で提供されます。 - 設定プロセス中では、どんなモジュールをサーバで使うように - コンパイルするか選ばなければなりません。このマニュアルにあるモジュールの一覧を - 参照できます。 - "Base" ステータスの - モジュールはデフォルトで含まれますし、 - 使いたくないのであれば、わざと無効にしなければ - なりません (例えば mod_userdir )。 - 他のステータスのモジュールは、 - 使いたければ有効にしなければなりません - (例えば mod_expires)。

    - -

    Apache と一緒にコンパイルして使うようにするには、 - 二通りの方法があります。一つめはモジュールを - スタティックコンパイルする方法です。この場合は、 - Apache のバイナリに恒久的に組み込まれることになります。 - これの代わりに、もしオペレーティングシステムが動的共有 - ライブラリ (DSO) (訳注: Dynamic Shared Object) を - 提供していて autoconf がそれを認識できる - 場合は、モジュールをダイナミックコンパイルする方法があります。 - DSO モジュールは Apache のバイナリとは別に - 保存され、mod_so で提供される - 実行時設定ディレクティブを使って - 組み込んだり取り外したりできます。 - 動的モジュールを実際に一つもコンパイルすることなく - サーバが DSO をロードできるようにするには、 - --enable-so と明示的にすることができます。

    - -
    -
    --enable-MODULE[=shared]
    - -
    MODULE モジュールをコンパイルして - インクルードします。識別子 MODULE は - モジュール文書に記載されているモジュール - 識別子から "_module" を取り除いた文字列です。 - DSO としてモジュールをコンパイルする場合は、 - =shared オプションを付加してください。
    - -
    --disable-MODULE
    - -
    通常はコンパイルされてインクルードされる - MODULE モジュールを除去します。
    - -
    --enable-modules=MODULE-LIST
    - -
    スペース区切りの MODULE-LIST - に列挙されたモジュールをコンパイルして - インクルードします。
    - -
    - --enable-mods-shared=MODULE-LIST
    - -
    スペース区切りの MODULE-LIST を - ダイナミックロード (DSO) できるモジュールとして - コンパイルとインクルードをします。
    -
    - -

    --enable-modules や - --enable-mods-shared オプションに使う - MODULE-LIST は、普通はスペース区切りの - モジュール識別子のリストです。 - 例えば mod_dav と mod_info - を有効にする場合は、次のどちらかが使えます。

    - -

    ./configure --enable-dav --enable-info

    - -

    または、同等の

    - -

    ./configure --enable-modules="dav info"

    - -

    これに加えて、特別なキーワード all や - most を使って、 - 一度に全てあるいはほとんどのモジュールを加えることができます。 - その後で好きなモジュールを --disable-MODULE - オプションを使って取り除くことができます。 - 例えば、mod_info を除く全てのモジュールを DSO - モジュールとして組み込む場合は、次のようにします。

    - -

    - ./configure --enable-mods-shared=all - --disable-info -

    - -

    標準的なモジュールに加えて、Apache 2.0 では - Multi-Processing Modules (MPM) - を選択してインクルードします。ただ一つだけの MPM - をコンパイルのプロセスで含める必要があります。 - 個々のプラットホーム向けのデフォルトの MPM は MPM 文書に一覧がありますが、 - configure - コマンドで置き換えることができます。

    - -
    -
    --with-mpm=NAME
    - -
    MPM モジュール NAME を選択します。
    -
    - -

    mpm_name という MPM を有効にするには次のようにします。

    - -

    - ./configure --with-mpm=mpm_name -

    - - - -

    DBM

    - -

    mod_authn_dbm と mod_rewrite - の DBM RewriteMap - 等、 Apache 機能の幾つかでは情報の検索に単純な key/value - データベースを使用します。Apache には SDBM がソースコードごと - 含まれていますので、このデータベースはいつでも利用可能です。 - 他のタイプのデータベースを使用したい場合は、次の - configure オプションが利用できます。

    - -
    -
    --with-gdbm[=path]
    -
    --with-ndbm[=path]
    -
    --with-berkeley-db[=path]
    - -
    もしパス (path) が指定されなかった場合は、Apache -は通常の検索パス上でインクルードファイルとライブラリを探します。 -明示的に path を指定すると、Apache は -path/lib と path/include -を検索して関連ファイルを探します。path -にはコロンで区切って複数のインクルード、ライブラリパスを指定できます。 -
    -
    - - - -

    Suexec

    - -

    Apache には suexec と呼ばれる - 補助プログラムがあります。 - このプログラムはユーザの CGI プログラムを隔離するために - 使用することができます。しかしながら、suexec - を適切に設定しなければ、 - セキュリティ上致命的な問題をかかえる場合があります。 - そのため、この機能を実装する前に suexec - 文書をよく読んで一考しておきましょう。

    - +

    個々の configure オプションの詳細に関しては + configure マニュアルページ + をご覧ください。

    top

    ビルド

    @@ -620,12 +334,12 @@

    アップグレード

    -

    アップグレードでまず行なうべきことは、リリースアナウンスと +

    アップグレードでまず行なうべきことは、リリースアナウンスと ソースディストリビューションに入っている CHANGES を読んで、 自身のサイトに対して影響を及ぼす変更点を探すことです。 メジャーリリース間の変更をする場合 (例えば 1.3 から 2.0 へ、2.0 から 2.2 へ) は、コンパイル時や実行時の設定に大きな差異があるでしょうから、 - 手動の調整が必要になるでしょう。モジュールも全て、API + 手動の調整が必要になるでしょう。モジュールも全て、API の変更に合わせるためにアップグレードが必要になるでしょう。

    マイナーバージョンから次のバージョンにアップグレードする場合 diff --git a/docs/manual/install.xml.meta b/docs/manual/install.xml.meta index dc327ebaa2..a607df2790 100644 --- a/docs/manual/install.xml.meta +++ b/docs/manual/install.xml.meta @@ -8,7 +8,7 @@ de en - ja + ja ko diff --git a/docs/manual/mod/mod_log_config.html.en b/docs/manual/mod/mod_log_config.html.en index 0ea63a07e4..1f9cb59966 100644 --- a/docs/manual/mod/mod_log_config.html.en +++ b/docs/manual/mod/mod_log_config.html.en @@ -195,7 +195,7 @@ at the final request. So for example, %>s can be used to record the final status of the request and %<u can be used to record the original - authenticated user on a request that is internally redirect to an + authenticated user on a request that is internally redirected to an unauthenticated resource.

    Note that in httpd 2.0 versions prior to 2.0.46, no escaping was performed diff --git a/docs/manual/mod/mod_log_config.xml.ja b/docs/manual/mod/mod_log_config.xml.ja index 591185b846..6ac81ecadb 100644 --- a/docs/manual/mod/mod_log_config.xml.ja +++ b/docs/manual/mod/mod_log_config.xml.ja @@ -1,7 +1,7 @@ - +