Changes between Version 1 and Version 2 of TracModPython
- Timestamp:
- Jun 21, 2008, 6:11:58 PM (16 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracModPython
v1 v2 1 = Trac とmod_python =1 = Trac and mod_python = 2 2 [[TracGuideToc]] 3 3 4 Trac では [http://www.modpython.org/ mod_python] を利用可能です。 [http://www.modpython.org/ mod_python] は Trac のレスポンスタイムを飛躍的に向上し、特に [TracCgi CGI] と比べて、 [wiki:TracStandalone tracd]/mod_proxy では使用できない多くの Apache 機能を使えるようにします。4 Trac supports [http://www.modpython.org/ mod_python], which speeds up Trac's response times considerably, especially compared to [TracCgi CGI], and permits use of many Apache features not possible with [wiki:TracStandalone tracd]/mod_proxy. 5 5 6 == シンプルなコンフィグレーション==6 == Simple configuration == 7 7 8 もし mod_python をインストールしたならば、 Apache の設定ファイルに以下の一行を追加してモジュールをロードしなければなりません:8 If you just installed mod_python, you may have to add a line to load the module in the Apache configuration: 9 9 {{{ 10 10 LoadModule python_module modules/mod_python.so 11 11 }}} 12 12 13 ''Note: モジュールがインストールされている正しいパスは HTTPD をどこにインストールしたかによって変わります。''13 ''Note: The exact path to the module depends on how the HTTPD installation is laid out.'' 14 14 15 httpd.conf に以下の記述を追加してmod_python が正しくインストールされているかどうかを確かめることができます。セキュリティ上の理由で、この記述はテストが終了したら削除すべきです。 15 You can test your mod_python installation by adding the following to your httpd.conf. You should remove this when you are done testing for security reasons. 16 16 {{{ 17 17 <Location /mpinfo> … … 21 21 }}} 22 22 23 mod_python を使用した簡単な Trac のセットアップ方法は以下のようになります:23 A simple setup of Trac on mod_python looks like this: 24 24 {{{ 25 25 <Location /projects/myproject> … … 31 31 }}} 32 32 33 '''`TracUriRoot`''' オプションは不要な場合もあります。 `TracUriRoot` オプションを付けずに試し、 Trac が正しく URL を生成できないようであれば '''`TracUriRoot`''' を追加して下さい。 `Location` と '''`TracUriRoot`''' が同じパスになることに気づくでしょう。 33 The option '''`TracUriRoot`''' may or may not be necessary in your setup. Try your configuration with out it, and if the URLs produced by Trac look wrong or if Trac does not seem to recognize the URLs correctly, add the '''`TracUriRoot`''' option. You will notice that the `Location` and '''`TracUriRoot`''' have the same path. 34 34 35 === 認証設定===35 === Configuring Authentication === 36 36 37 認証の設定は [wiki:TracCgi#認証を追加する CGI] と同じです:37 Configuring authentication works just like for [wiki:TracCgi#AddingAuthentication CGI]: 38 38 {{{ 39 39 <Location "/projects/myproject/login"> … … 45 45 }}} 46 46 47 === !PythonPath を設定する===47 === Setting the !PythonPath === 48 48 49 もし Trac のインストールが、通常の Python ライブラリのパスの中に無い場合、 Apache が Trac の mod_python ハンドルを見つけられるように `PythonPath` ディレクティブで指定しなければなりません:49 If the Trac installation isn't installed in your Python path, you'll have to tell Apache where to find the Trac mod_python handler using the `PythonPath` directive: 50 50 {{{ 51 51 <Location /projects/myproject> … … 56 56 }}} 57 57 58 !PythonPath ディレクティブを使用するときは気をつけてください。そして、 `SetEnv PYTHONPATH` は動かないので使用しないで下さい。 58 Be careful about using the !PythonPath directive, and ''not'' `SetEnv PYTHONPATH`, as the latter won't work. 59 59 60 == マルチプロジェクトのセットアップ==60 == Setting up multiple projects == 61 61 62 T rac の mod_python ハンドラには Subversion の `SvnParentPath` とよく似た `TracEnvParentDir` というコンフィグレーションオプションがあります。62 The Trac mod_python handler supports a configuration option similar to Subversion's `SvnParentPath`, called `TracEnvParentDir`: 63 63 {{{ 64 64 <Location /projects> … … 70 70 }}} 71 71 72 `/projects` の URL をリクエストすると、 TracEnvironment の親ディレクトリ `TracEnvParentDir` として設定したディレクトリ配下のサブディレクトリ一覧が表示されます。その一覧から何かプロジェクトを選択するとそれに該当する TracEnvironment を開くことができます。 72 When you request the `/projects` URL, you will get a listing of all subdirectories of the directory you set as `TracEnvParentDir` that look like Trac environment directories. Selecting any project in the list will bring you to the corresponding Trac environment. 73 73 74 あなたのプロジェクトのホームページとして、サブディレクトリのリストが必要ないならば、以下のようにすることができます。 74 If you don't want to have the subdirectory listing as your projects home page you can use a 75 75 {{{ 76 76 <LocationMatch "/.+/"> 77 77 }}} 78 78 79 これは Apache に mod_python を使用するために !DocumentRoot フォルダの代わりのロケーションを使用することを教えます。 79 This will instruct Apache to use mod_python for all locations different from root while having the possibility of placing a custom home page for root in your !DocumentRoot folder. 80 80 81 すべてのプロジェクトに対して、 `<LocationMatch>` ディレクティブを使用することによって同じ認証の仕組みを使用することができます。 81 You can also use the same authentication realm for all of the projects using a `<LocationMatch>` directive: 82 82 {{{ 83 83 <LocationMatch "/projects/[^/]+/login"> … … 89 89 }}} 90 90 91 == 仮想ホストの設定==91 == Virtual Host Configuration == 92 92 93 以下に示す例は Trac を仮想サーバーとしてセットアップするときに必要な設定です。 (例えば、!http://trac.mycompany.com といった 94 URL でアクセスすることができます):93 Below is the sample configuration required to set up your trac as a virtual server (i.e. when you access it at the URLs like 94 !http://trac.mycompany.com): 95 95 96 96 {{{ … … 113 113 }}} 114 114 115 複数のプロジェクトをサポートする仮想ホストの設定では、 "`TracEnv`" /var/trac/myproject を "`TracEnvParentDir`" /var/trac/ に置き換えて下さい。 115 For a virtual host that supports multiple projects replace "`TracEnv`" /var/trac/myproject with "`TracEnvParentDir`" /var/trac/ 116 116 117 == トラブルシューティング==117 == Troubleshooting == 118 118 119 サーバエラーのページがでたときには、 まずはApache のエラーログを確認するか、 `PythonDebug` オプションを有効にして下さい:119 In general, if you get server error pages, you can either check the Apache error log, or enable the `PythonDebug` option: 120 120 {{{ 121 121 <Location /projects/myproject> … … 125 125 }}} 126 126 127 === フォームを送信するときの問題===127 === Form submission problems === 128 128 129 もし、 Trac で何かしらのフォームを送信したときに、トラブルに見舞われたら(よくある問題として、送信後にスタートページにリダイレクトされてしまうという問題があります)、 {{{DocumentRoot}}} の中に mod_python をマッピングしたパスと同じフォルダやファイルが存在しないか確認してください。どういうわけか、 mod_python は静的リソースと同じところにマッピングされると混乱してしまいます。 129 If you're experiencing problems submitting some of the forms in Trac (a common problem is that you get redirected to the start page after submission), check whether your {{{DocumentRoot}}} contains a folder or file with the same path that you mapped the mod_python handler to. For some reason, mod_python gets confused when it is mapped to a location that also matches a static resource. 130 130 131 === 仮想ホストの設定においての問題===131 === Problem with virtual host configuration === 132 132 133 もし <Location /> ディレクティブが使用されているとき、 `DocumentRoot` を設定すると ''403 (Forbidden)'' エラーになるでしょう。 `DocumentRoot` ディレクティブを削除するか、アクセスが許されているディレクトリに設定されているかどうかを確認して下さい (対応する `<Directory>` ブロックにて) 133 If the <Location /> directive is used, setting the `DocumentRoot` may result in a ''403 (Forbidden)'' error. Either remove the `DocumentRoot` directive, or make sure that accessing the directory it points is allowed (in a corresponding `<Directory>` block). 134 134 135 <Location /> で `SetHandler` を使用すると、すべてを mod_python でハンドルすることになりますが、いかなる CSS も image/icons もダウンロードできなくなります。この問題を回避するために、 <Location /trac> で `SetHandler None` を使用しています。しかし、この方法がエレガントな解決方法だとは思っていません。 135 Using <Location /> together with `SetHandler` resulted in having everything handled by mod_python, which leads to not being able download any CSS or images/icons. I used <Location /trac> `SetHandler None` </Location> to circumvent the problem, though I do not know if this is the most elegant solution. 136 136 137 === .htaccess ファイルを使用する===137 === Using .htaccess === 138 138 139 ディレクトリの設定をほんのちょっと修正するには `.htaccess` ファイルを使用すればいいかもしれませんが、これは動作しません。 Apache が Trac URL に "/" (スラッシュ) を追加すると、正しい動作を妨げてしまいます。 139 Although it may seem trivial to rewrite the above configuration as a directory in your document root with a `.htaccess` file, this does not work. Apache will append a "/" to any Trac URLs, which interferes with its correct operation. 140 140 141 それでは、 mod_rewrite を使用すればいいように見えますが、これも動作しません。とにかく、百害あって一理なしです。指示に従ってください。:)141 It may be possible to work around this with mod_rewrite, but I failed to get this working. In all, it is more hassle than it is worth. Stick to the provided instructions. :) 142 142 143 === Win32 での特記===144 Windows 上で mod_python 3.2 より前のバージョンで Trac を動かしている場合、 添付ファイルのアップロードが '''動かない''' でしょう。この問題は 3.1.4 以降で解決されました。 mod_python をアップグレードしてこの問題を解決してください。 143 === Win32 Issues === 144 If you run trac with mod_python < 3.2 on Windows, uploading attachments will '''not''' work. This problem is resolved in mod_python 3.1.4 or later, so please upgrade mod_python to fix this. 145 145 146 === OS X での特記===146 === OS X issues === 147 147 148 OS X で mod_python を使用するとき、 `apachectl restart` コマンドで Apache の再起動ができないでしょう。これは、 mod_python 3.2 でおそらく修正されるでしょう。しかし、 [http://www.dscpl.com.au/projects/vampire/patches.html ここ] にあるパッチを適用すれば、 3.2 以前のバージョンでもこの問題を回避できます。 148 When using mod_python on OS X you will not be able to restart Apache using `apachectl restart`. This is apparently fixed in mod_python 3.2, but there's also a patch available for earlier versions [http://www.dscpl.com.au/projects/vampire/patches.html here]. 149 149 150 === SELinux での特記===150 === SELinux issues === 151 151 152 もし、 Trac が ''Cannot get shared lock on db.lock'' というようなメッセージが出力されたら、 153 リポジトリに セキュリティコンテキストを設定する必要があるでしょう:152 If Trac reports something like: ''Cannot get shared lock on db.lock'' 153 The security context on the repository may need to be set: 154 154 155 155 {{{ … … 159 159 See also [[http://subversion.tigris.org/faq.html#reposperms]] 160 160 161 === FreeBSD での特記===162 mod_python と sqlite パッケージのインストールバージョンに注意して下さい。 Ports には両パッケージともいろいろなバージョンがありますが、初期の pysqlite と mod_python は組み合わせることができません。前者は python のスレッド機能サポートが必要ですし、 後者 は python のスレッド機能なしのインストールが必要です。 161 === FreeBSD issues === 162 Pay attention to the version of the installed mod_python and sqlite packages. Ports have both the new and old ones, but earlier versions of pysqlite and mod_python won't integrate as the former requires threaded support in python, and the latter requires a threadless install. 163 163 164 === Subversion での特記===164 === Subversion issues === 165 165 166 Trac でコマンドライン、 TracStandalone で使用しているときは動くのに、 mod_python を使用しているときのみ、 `Unsupported version control system "svn"` というエラーが出力される場合、 [wiki:"TracModPython#PythonPathを設定する" PythonPath] ディレクティブに Python bindings へのパスを追加するのを忘れている可能性があります。 (Python の `site-packages` ディレクトリに Python binding へのパスをはるか、 `.pth` ファイルを作っておくのがベターです。)166 If you get the following Trac Error `Unsupported version control system "svn"` only under mod_python, though it works well on the command-line and even with TracStandalone, chances are that you forgot to add the path to the Python bindings with the [TracModPython#ConfiguringPythonPath PythonPath] directive. (The better way is to add a link to the bindings in the Python `site-packages` directory, or create a `.pth` file in that directory.) 167 167 168 これに当てはまらない場合、使用している Subversion のライブラリが Apache が使用しているバージョンと適合性がないかもしれません。(たいてい `apr` ライブラリの不適合性が原因になります。)その場合、 Apache の svn モジュール (`mod_dav_svn`) も使用できないでしょう。 168 If this is not the case, it's possible that you're using Subversion libraries that are binary incompatible with the apache ones (an incompatibility of the `apr` libraries is usually the cause). In that case, you also won't be able to use the svn modules for Apache (`mod_dav_svn`). 169 169 170 170 ---- 171 See also :TracGuide, TracInstall, TracCgi, TracFastCgi171 See also TracGuide, TracInstall, TracCgi, TracFastCgi