Changes between Version 1 and Version 2 of TracModPython

Timestamp:

2007/03/06 12:34:28 (17 years ago)

Author:

trac

Comment:

--

TracModPython

@@ -1 +1 @@
 = Trac と mod_python =
+[[TracGuideToc]]
 
-Trac では [http://www.modpython.org/ mod_python] をサポートします。 [http://www.modpython.org/ mod_python] は Trac のレスポンスタイムを飛躍的に向上し、 [wiki:TracStandalone tracd]/mod_proxy では使用できない多くの Apache 機能を使えるようにします。
+Trac では [http://www.modpython.org/ mod_python] を利用可能です。 [http://www.modpython.org/ mod_python] は Trac のレスポンスタイムを飛躍的に向上し、特に [TracCgi CGI] と比べて、 [wiki:TracStandalone tracd]/mod_proxy では使用できない多くの Apache 機能を使えるようにします。
 
 == シンプルなコンフィグレーション ==
@@ -8 +9 @@
 {{{
 LoadModule python_module modules/mod_python.so
+}}}
+
+ ''Note: モジュールがインストールされている正しいパスは HTTPD をどこにインストールしたかによって変わります。''
+
+httpd.conf に以下の記述を追加してmod_python が正しくインストールされているかどうかを確かめることができます。セキュリティ上の理由で、この記述はテストが終了したら削除すべきです。
+{{{
+<Location /mpinfo>
+   SetHandler mod_python
+   PythonHandler mod_python.testhandler
+</Location>
 }}}
 
@@ -20 +31 @@
 }}}
 
-`TracUriRoot` オプションは不要な場合もありますのでご注意ください。まずは `TracUriRoot` オプションを付けずに試し、 Trac が正しく URL を生成できないようであれば追加するようにしてください。
+'''`TracUriRoot`''' オプションは不要な場合もあります。 `TracUriRoot` オプションを付けずに試し、 Trac が正しく URL を生成できないようであれば '''`TracUriRoot`''' を追加して下さい。 `Location` と '''`TracUriRoot`''' が同じパスになることに気づくでしょう。
 
-認証設定は [wiki:TracCgi#認証を追加する CGI] と同じです:
+=== 認証設定 ===
+
+認証の設定は [wiki:TracCgi#認証を追加する CGI] と同じです:
 {{{
 <Location "/projects/myproject/login">
   AuthType Basic
   AuthName "myproject"
-  AuthUserFile /var/trac/myproject/.htaccess
+  AuthUserFile /var/trac/myproject/.htpasswd
   Require valid-user
 </Location>
 }}}
+
+=== !PythonPath を設定する ===
 
 もし Trac のインストールが、通常の Python ライブラリのパスの中に無い場合、 Apache が Trac の mod_python ハンドルを見つけられるように `PythonPath` ディレクティブで指定しなければなりません:
@@ -41 +56 @@
 }}}
 
+!PythonPath ディレクティブを使用するときは気をつけてください。そして、 `SetEnv PYTHONPATH` は動かないので使用しないで下さい。
 
 == マルチプロジェクトのセットアップ ==
 
-Trac の mod_python ハンドラは Subversion の `SvnParentPath` とよく似た `TracEnvParentDir` というコンフィグレーションオプションをサポートしています。
+Trac の mod_python ハンドラには Subversion の `SvnParentPath` とよく似た `TracEnvParentDir` というコンフィグレーションオプションがあります。
 {{{
 <Location /projects>
@@ -54 +70 @@
 }}}
 
-`/projects` の URL をリクエストすると、 `TracEnvParentDir` として設定したディレクトリ配下のサブディレクトリ一覧が表示されます。その一覧から何かプロジェクトを選択するとそれに該当する TracEnvironment を開くことができます。
+`/projects` の URL をリクエストすると、 TracEnvironment の親ディレクトリ `TracEnvParentDir` として設定したディレクトリ配下のサブディレクトリ一覧が表示されます。その一覧から何かプロジェクトを選択するとそれに該当する TracEnvironment を開くことができます。
 
 あなたのプロジェクトのホームページとして、サブディレクトリのリストが必要ないならば、以下のようにすることができます。
@@ -65 +81 @@
 すべてのプロジェクトに対して、 `<LocationMatch>` ディレクティブを使用することによって同じ認証の仕組みを使用することができます。
 {{{
-<LocationMatch "/[^/]+/login">
+<LocationMatch "/projects/[^/]+/login">
   AuthType Basic
   AuthName "Trac"
-  AuthUserFile /var/trac/.htaccess
+  AuthUserFile /var/trac/.htpasswd
   Require valid-user
 </LocationMatch>
@@ -75 +91 @@
 == 仮想ホストの設定 ==
 
-以下に示す例は Trac を仮想サーバーとしてセットアップするときに必要な設定です。 ( 例えば、!http://trac.mycompany.com といった
+以下に示す例は Trac を仮想サーバーとしてセットアップするときに必要な設定です。 (例えば、!http://trac.mycompany.com といった
 URL でアクセスすることができます):
 
@@ -82 +98 @@
     DocumentRoot /var/trac/myproject
     ServerName trac.mycompany.com
-    <Directory />
+    <Location />
         SetHandler mod_python
         PythonHandler trac.web.modpython_frontend
         PythonOption TracEnv /var/trac/myproject
         PythonOption TracUriRoot /
-    </Directory>
+    </Location>
     <Location /login>
         AuthType Basic
         AuthName "MyCompany Trac Server"
-        AuthUserFile /var/trac/myproject/.htusers
+        AuthUserFile /var/trac/myproject/.htpasswd
         Require valid-user
     </Location>
@@ -97 +113 @@
 }}}
 
+複数のプロジェクトをサポートする仮想ホストの設定では、 "`TracEnv`" /var/trac/myproject を "`TracEnvParentDir`" /var/trac/ に置き換えて下さい。
+
 == トラブルシューティング ==
+
+サーバエラーのページがでたときには、 まずはApache のエラーログを確認するか、 `PythonDebug` オプションを有効にして下さい:
+{{{
+<Location /projects/myproject>
+  ...
+  PythonDebug on
+</Location>
+}}}
 
 === フォームを送信するときの問題 ===
 
-もし、 Trac のなかの何かしらのフォームを送信したときに、トラブルに見舞われたら（一般的な問題として、送信後にスタートページにリダイレクトされてしまうという問題があります）、あなたが指定した {{{DocumentRoot}}} と mod_python がマッピングしたのと同じフォルダやファイルを指しているかどうか確認してください。いくつかの理由のために、 mod_python は静的なリソースがマッピングされているのを嫌います。
+もし、 Trac で何かしらのフォームを送信したときに、トラブルに見舞われたら（よくある問題として、送信後にスタートページにリダイレクトされてしまうという問題があります）、 {{{DocumentRoot}}} の中に mod_python をマッピングしたパスと同じフォルダやファイルが存在しないか確認してください。どういうわけか、 mod_python は静的リソースと同じところにマッピングされると混乱してしまいます。
+
+=== 仮想ホストの設定においての問題 ===
+
+もし <Location /> ディレクティブが使用されているとき、 `DocumentRoot` を設定すると ''403 (Forbidden)'' エラーになるでしょう。 `DocumentRoot` ディレクティブを削除するか、アクセスが許されているディレクトリに設定されているかどうかを確認して下さい (対応する `<Directory>` ブロックにて)
+
+<Location /> で `SetHandler` を使用すると、すべてを mod_python でハンドルすることになりますが、いかなる CSS も image/icons もダウンロードできなくなります。この問題を回避するために、 <Location /trac> で `SetHandler None` を使用しています。しかし、この方法がエレガントな解決方法だとは思っていません。
 
 === .htaccess ファイルを使用する ===
@@ -110 +142 @@
 
 === Win32 での特記 ===
-
-もし、 Windows 上で mod_python (3.1.3 または 3.1.4) を使用して Trac を起動しているならば、
-添付ファイルのアップロードがたぶん動作 '''しない''' でしょう。
-これは、既知の問題で、 Trac のレベルではきれいに解決できません。
-
-とはいうものの、 mod_python レベルでの解決方法があります。
-パッチ [http://projects.edgewall.com/trac/attachment/ticket/554/util_py.patch attachment:ticket:554:util_py.patch] を
-(Lib/site-packages)/modpython/util.py ファイルに適用して下さい。
-
-もし、 `patch` コマンドを持っていないならば、ファイルを [http://svn.apache.org/viewcvs.cgi/httpd/mod_python/trunk/lib/python/mod_python/util.py?rev=103562&view=markup 修正済みの util.py]に置き換えることもできます。 (mod_python 3.1.4 リリース以前に書かれたものですが、事象が修正されます
-現在の 3.1.4 ''ではありません'')。 
+Windows 上で mod_python 3.2 より前のバージョンで Trac を動かしている場合、 添付ファイルのアップロードが '''動かない''' でしょう。この問題は 3.1.4 以降で解決されました。 mod_python をアップグレードしてこの問題を解決してください。
 
 === OS X での特記 ===
@@ -126 +148 @@
 OS X で mod_python を使用するとき、 `apachectl restart` コマンドで Apache の再起動ができないでしょう。これは、 mod_python 3.2 でおそらく修正されるでしょう。しかし、 [http://www.dscpl.com.au/projects/vampire/patches.html ここ] にあるパッチを適用すれば、 3.2 以前のバージョンでもこの問題を回避できます。
 
+=== SELinux での特記 ===
+
+もし、 Trac が ''Cannot get shared lock on db.lock'' というようなメッセージが出力されたら、
+リポジトリに セキュリティコンテキストを設定する必要があるでしょう:
+
+{{{
+chcon -R -h -t httpd_sys_content_t PATH_TO_REPOSITORY
+}}}
+
+See also [[http://subversion.tigris.org/faq.html#reposperms]]
+
+=== FreeBSD での特記 ===
+mod_python と sqlite パッケージのインストールバージョンに注意して下さい。 Ports には両パッケージともいろいろなバージョンがありますが、初期の pysqlite と mod_python は組み合わせることができません。前者は python のスレッド機能サポートが必要ですし、 後者 は python のスレッド機能なしのインストールが必要です。
+
+=== Subversion での特記 ===
+
+Trac でコマンドライン、 TracStandalone で使用しているときは動くのに、 mod_python を使用しているときのみ、 `Unsupported version control system "svn"` というエラーが出力される場合、 [wiki:"TracModPython#PythonPathを設定する" PythonPath] ディレクティブに Python bindings へのパスを追加するのを忘れている可能性があります。 (Python の `site-packages` ディレクトリに Python binding へのパスをはるか、 `.pth` ファイルを作っておくのがベターです。)
+
+これに当てはまらない場合、使用している Subversion のライブラリが Apache が使用しているバージョンと適合性がないかもしれません。(たいてい `apr` ライブラリの不適合性が原因になります。)その場合、 Apache の svn モジュール (`mod_dav_svn`) も使用できないでしょう。
+
 ----
 See also: TracGuide, TracInstall, TracCgi, TracFastCgi