33 | | '''`TracUriRoot`''' オプションは不要な場合もあります。 `TracUriRoot` オプションを付けずに試し、 Trac が正しく URL を生成できないようであれば '''`TracUriRoot`''' を追加して下さい。 `Location` と '''`TracUriRoot`''' が同じパスになることに気づくでしょう。 |
34 | | |
35 | | === 認証設定 === |
36 | | |
37 | | 認証の設定は [wiki:TracCgi#認証を追加する CGI] と同じです: |
38 | | {{{ |
39 | | <Location "/projects/myproject/login"> |
| 51 | '''`TracUriRoot`''' オプションは不要な場合もあります。 `TracUriRoot` オプションを付けずに試し、 Trac が正しく URL を生成できないか、 "No handler matched request to..." というエラーが出るようであれば '''`TracUriRoot`''' を追加して下さい。 `Location` と '''`TracUriRoot`''' が同じパスになるようにしてください。 |
| 52 | |
| 53 | !PythonOption の一覧は以下の通りです。 |
| 54 | {{{ |
| 55 | # For a single project |
| 56 | PythonOption TracEnv /var/trac/myproject |
| 57 | # For multiple projects |
| 58 | PythonOption TracEnvParentDir /var/trac/myprojects |
| 59 | # For the index of multiple projects |
| 60 | PythonOption TracEnvIndexTemplate /srv/www/htdocs/trac/project_list_template.html |
| 61 | # A space delimitted list, with a "," between key and value pairs. |
| 62 | PythonOption TracTemplateVars key1,val1 key2,val2 |
| 63 | # Useful to get the date in the wanted order |
| 64 | PythonOption TracLocale en_GB.UTF8 |
| 65 | # See description above |
| 66 | PythonOption TracUriRoot /projects/myproject |
| 67 | }}} |
| 68 | |
| 69 | === Python Egg Cache === #PythonEggCache |
| 70 | |
| 71 | Genshi のように圧縮された Python egg は通常、実行するユーザのホームディレクトリ配下の `.python-eggs` ディレクトリに展開されます。 Apache のホームディレクトリは多くの場合、書き込みできないようになっているので、他のディレクトリを egg cache として指定しなければなりません: |
| 72 | {{{ |
| 73 | PythonOption PYTHON_EGG_CACHE /var/trac/myprojects/egg-cache |
| 74 | }}} |
| 75 | |
| 76 | === 認証設定 === #ConfiguringAuthentication |
| 77 | |
| 78 | パスワードファイルを作成して、認証を構成するには [wiki:TracCgi#AddingAuthentication CGI] と同じように行います。 |
| 79 | {{{ |
| 80 | #!xml |
| 81 | <Location /projects/myproject/login> |
47 | | === !PythonPath を設定する === |
48 | | |
49 | | もし Trac のインストールが、通常の Python ライブラリのパスの中に無い場合、 Apache が Trac の mod_python ハンドルを見つけられるように `PythonPath` ディレクティブで指定しなければなりません: |
50 | | {{{ |
| 89 | Apache の mod_ldap 認証のコンフィグは少し扱いにくいです。(httpd 2.2.x と OpenLDAP: slapd 2.3.19) |
| 90 | |
| 91 | 1. Apache の httpd.conf に以下のモジュールをロードする必要があります |
| 92 | {{{ |
| 93 | LoadModule ldap_module modules/mod_ldap.so |
| 94 | LoadModule authnz_ldap_module modules/mod_authnz_ldap.so |
| 95 | }}} |
| 96 | |
| 97 | 2. httpd.conf は以下のような感じになります: |
| 98 | |
| 99 | {{{ |
| 100 | #!xml |
| 101 | <Location /trac/> |
| 102 | SetHandler mod_python |
| 103 | PythonInterpreter main_interpreter |
| 104 | PythonHandler trac.web.modpython_frontend |
| 105 | PythonOption TracEnv /home/trac/ |
| 106 | PythonOption TracUriRoot /trac/ |
| 107 | Order deny,allow |
| 108 | Deny from all |
| 109 | Allow from 192.168.11.0/24 |
| 110 | AuthType Basic |
| 111 | AuthName "Trac" |
| 112 | AuthBasicProvider "ldap" |
| 113 | AuthLDAPURL "ldap://127.0.0.1/dc=example,dc=co,dc=ke?uid?sub?(objectClass=inetOrgPerson)" |
| 114 | authzldapauthoritative Off |
| 115 | require valid-user |
| 116 | </Location> |
| 117 | }}} |
| 118 | |
| 119 | Microsoft Active Directory の LDAP インタフェースを使用する場合: |
| 120 | |
| 121 | {{{ |
| 122 | #!xml |
| 123 | <Location /trac/> |
| 124 | SetHandler mod_python |
| 125 | PythonInterpreter main_interpreter |
| 126 | PythonHandler trac.web.modpython_frontend |
| 127 | PythonOption TracEnv /home/trac/ |
| 128 | PythonOption TracUriRoot /trac/ |
| 129 | Order deny,allow |
| 130 | Deny from all |
| 131 | Allow from 192.168.11.0/24 |
| 132 | AuthType Basic |
| 133 | AuthName "Trac" |
| 134 | AuthBasicProvider "ldap" |
| 135 | AuthLDAPURL "ldap://adserver.company.com:3268/DC=company,DC=com?sAMAccountName?sub?(objectClass=user)" |
| 136 | AuthLDAPBindDN ldap-auth-user@company.com |
| 137 | AuthLDAPBindPassword "the_password" |
| 138 | authzldapauthoritative Off |
| 139 | # require valid-user |
| 140 | require ldap-group CN=Trac Users,CN=Users,DC=company,DC=com |
| 141 | </Location> |
| 142 | }}} |
| 143 | |
| 144 | Note 1: このケースでは LDAP 検索で複数の OU をまとめて取得するために、 AD のグローバルカタログサーバ (Global Catalog Server) に接続しています (ポート番号が通常 LDAP で使用される 389 ではなく 3268 であることに注意してください) 。 GCS は基本的に "平らな" ツリーであり、ユーザが、どの OU に属するか不明な場合でも検索することができます。 |
| 145 | |
| 146 | Note 2: Active Directory は、レコードにアクセスするために user/password (AuthLDAPBindDN と AuthLDAPBindPassword) による認証を必要とします。 (訳注: GC ではなく、通常の LDAP であれば Active Directory の ACL に認証なしユーザからの読み取り許可を設定すれば不要です) |
| 147 | |
| 148 | Note 3: "require ldap-group ..." ディレクティブはメンバのアクセスが許可されている AD のグループを指定します。 |
| 149 | |
| 150 | |
| 151 | |
| 152 | === !PythonPath を設定する === #SettingthePythonPath |
| 153 | |
| 154 | もし Trac のインストールが、通常の Python ライブラリのパスの中に無い場合、 Apache が Trac の mod_python ハンドラを見つけられるように `PythonPath` ディレクティブで指定しなければなりません: |
| 155 | {{{ |
| 156 | #!xml |
127 | | === フォームを送信するときの問題 === |
128 | | |
129 | | もし、 Trac で何かしらのフォームを送信したときに、トラブルに見舞われたら(よくある問題として、送信後にスタートページにリダイレクトされてしまうという問題があります)、 {{{DocumentRoot}}} の中に mod_python をマッピングしたパスと同じフォルダやファイルが存在しないか確認してください。どういうわけか、 mod_python は静的リソースと同じところにマッピングされると混乱してしまいます。 |
130 | | |
131 | | === 仮想ホストの設定においての問題 === |
132 | | |
133 | | もし <Location /> ディレクティブが使用されているとき、 `DocumentRoot` を設定すると ''403 (Forbidden)'' エラーになるでしょう。 `DocumentRoot` ディレクティブを削除するか、アクセスが許されているディレクトリに設定されているかどうかを確認して下さい (対応する `<Directory>` ブロックにて) |
134 | | |
135 | | <Location /> で `SetHandler` を使用すると、すべてを mod_python でハンドルすることになりますが、いかなる CSS も image/icons もダウンロードできなくなります。この問題を回避するために、 <Location /trac> で `SetHandler None` を使用しています。しかし、この方法がエレガントな解決方法だとは思っていません。 |
136 | | |
137 | | === .htaccess ファイルを使用する === |
138 | | |
139 | | ディレクトリの設定をほんのちょっと修正するには `.htaccess` ファイルを使用すればいいかもしれませんが、これは動作しません。 Apache が Trac URL に "/" (スラッシュ) を追加すると、正しい動作を妨げてしまいます。 |
140 | | |
141 | | それでは、 mod_rewrite を使用すればいいように見えますが、これも動作しません。とにかく、百害あって一理なしです。指示に従ってください。:) |
142 | | |
143 | | === Win32 での特記 === |
144 | | Windows 上で mod_python 3.2 より前のバージョンで Trac を動かしている場合、 添付ファイルのアップロードが '''動かない''' でしょう。この問題は 3.1.4 以降で解決されました。 mod_python をアップグレードしてこの問題を解決してください。 |
145 | | |
146 | | === OS X での特記 === |
| 246 | 複数プロジェクトの場合は、全てのプロジェクトでサーバを再起動してみてください。 |
| 247 | |
| 248 | === Expat-related のセグメンテーションフォルト === #expat |
| 249 | |
| 250 | この問題は Unix 上で Python 2.4 を使用するとき、ほぼ確実に発生します。 |
| 251 | Python 2.4 の使用する Expat (C で書かれた XML パーザライブラリ) と Apache の使用する Expat のバージョンが異なる場合に、セグメンテーションフォルトが発生します。 |
| 252 | Trac 0.11 は Genshi (間接的に Expat が使用される) を使用しているため、以前 Trac 0.10 で正常に動いていたとしても、現在のあなたの環境で問題が起こり得ます。 |
| 253 | |
| 254 | Graham Dumpleton が、この問題について詳しく書いています。問題の [http://www.dscpl.com.au/wiki/ModPython/Articles/ExpatCausingApacheCrash 説明と回避方法] を確認してください。 |
| 255 | |
| 256 | === フォームを送信するときの問題 === #Formsubmissionproblems |
| 257 | |
| 258 | もし、 Trac で何かしらのフォームを送信したときに、トラブルに見舞われたら (送信後にスタートページにリダイレクトされてしまう、などがよくある問題です) {{{DocumentRoot}}} の中に mod_python をマッピングしたパスと同じフォルダやファイルが存在しないか確認してください。どういうわけか、 mod_python は静的リソースと同じところにマッピングされると混乱してしまいます。 |
| 259 | |
| 260 | === 仮想ホストの設定においての問題 === #Problemwithvirtualhostconfiguration |
| 261 | |
| 262 | <Location /> ディレクティブが使用されている場合に `DocumentRoot` を設定すると ''403 (Forbidden)'' エラーになることがあります。 `DocumentRoot` ディレクティブを削除するか、アクセスが許されているディレクトリに設定されているかどうかを確認して下さい (対応する `<Directory>` ブロックにて) |
| 263 | |
| 264 | <Location /> で `SetHandler` を使用すると、すべてを mod_python でハンドルすることになりますが、いかなる CSS も image/icons もダウンロードできなくなります。この問題を回避するために、われわれは <Location /trac> で `SetHandler None` を使用しています。しかし、この方法がエレガントな解決方法だとは思っていません。 |
| 265 | |
| 266 | === .htaccess ファイルを使用する === #Using.htaccess |
| 267 | |
| 268 | ディレクトリの設定をほんのちょっと修正するには `.htaccess` ファイルを使用すればいいかもしれませんが、これは動作しません。 Apache が Trac の URL に "/" (スラッシュ) を追加すると、正しい動作を妨げてしまいます。 |
| 269 | |
| 270 | それでは、 mod_rewrite を使用すればいいように見えますが、これも動作しません。とにかく、百害あって一利なしです。指示に従ってください。 :) |
| 271 | |
| 272 | 成功した事例: 以下の設定値で成功した事例があります: |
| 273 | {{{ |
| 274 | SetHandler mod_python |
| 275 | PythonInterpreter main_interpreter |
| 276 | PythonHandler trac.web.modpython_frontend |
| 277 | PythonOption TracEnv /system/path/to/this/directory |
| 278 | PythonOption TracUriRoot /path/on/apache |
| 279 | |
| 280 | AuthType Basic |
| 281 | AuthName "ProjectName" |
| 282 | AuthUserFile /path/to/.htpasswd |
| 283 | Require valid-user |
| 284 | }}} |
| 285 | |
| 286 | !TracUriRoot は Web ブラウザが取得する Trac のパスを明示的に設定するのに使用します。 (例: domain.tld/projects/trac) |
| 287 | |
| 288 | === .htaccess 使用時の特記事項 === #Additional.htaccesshelp |
| 289 | |
| 290 | .htaccess を使用している場合、 Trac のディレクトリが他のディレクトリで設定されたた .htaccess ディレクティブを継承し、問題を生じることがあります。このような場合、以下のように .htaccess ファイルに設定してみて下さい: |
| 291 | |
| 292 | {{{ |
| 293 | <IfModule mod_rewrite.c> |
| 294 | RewriteEngine Off |
| 295 | </IfModule> |
| 296 | }}} |
| 297 | |
| 298 | |
| 299 | === Win32 での特記 === #Win32Issues |
| 300 | Windows 上で mod_python 3.2 より前のバージョンで Trac を動かしている場合、添付ファイルのアップロードが '''動かない''' でしょう。この問題は 3.1.4 以降で解決されました。 mod_python をアップグレードしてこの問題を解決してください。 |
| 301 | |
| 302 | |
| 303 | === OS X での特記 === #OSXissues |
164 | | === Subversion での特記 === |
165 | | |
166 | | Trac でコマンドライン、 TracStandalone で使用しているときは動くのに、 mod_python を使用しているときのみ、 `Unsupported version control system "svn"` というエラーが出力される場合、 [wiki:"TracModPython#PythonPathを設定する" PythonPath] ディレクティブに Python bindings へのパスを追加するのを忘れている可能性があります。 (Python の `site-packages` ディレクトリに Python binding へのパスをはるか、 `.pth` ファイルを作っておくのがベターです。) |
167 | | |
168 | | これに当てはまらない場合、使用している Subversion のライブラリが Apache が使用しているバージョンと適合性がないかもしれません。(たいてい `apr` ライブラリの不適合性が原因になります。)その場合、 Apache の svn モジュール (`mod_dav_svn`) も使用できないでしょう。 |
| 321 | apache2 を普通にコンパイルしてインストールした場合、 apache はスレッドのサポートなしになります (これが FreeBSD 上であまりよく動かない原因)。 --enable-threads を使用して ./configure を実行することで apache にスレッドのサポートありにすることができますが、これはお勧めできません。 |
| 322 | 最良のオプションは /usr/local/apache2/bin/ennvars に下記の一行を追加することだと [[http://modpython.org/pipermail/mod_python/2006-September/021983.html 考えられます。]] |
| 323 | |
| 324 | {{{ |
| 325 | export LD_PRELOAD=/usr/lib/libc_r.so |
| 326 | }}} |
| 327 | |
| 328 | === Subversion での特記 === #Subversionissues |
| 329 | |
| 330 | コマンドラインや TracStandalone で使用しているときは動くのに、 mod_python を使用しているときのみ、 `Unsupported version control system "svn"` というエラーが出力される場合、 [wiki:"TracModPython#SettingthePythonPath" PythonPath] ディレクティブに Python bindings へのパスを追加するのを忘れている可能性があります。 (Python の `site-packages` ディレクトリに Python binding へのリンクを追加するか、 `.pth` ファイルを作っておくのがベターです。) |
| 331 | |
| 332 | これに当てはまらない場合、使用している Subversion のライブラリが Apache が使用しているバージョンと適合性がないかもしれません。 (たいてい `apr` ライブラリの不適合性が原因になります。) その場合、 Apache の svn モジュール (`mod_dav_svn`) も使用できないでしょう。 |
| 333 | |
| 334 | また、ランタイムエラー ({{{argument number 2: a 'apr_pool_t *' is expected}}}) を抑止するためにも、複数のサブインタプリタを使用できる最近のバージョンの `mod_python` が必要になります。 3.2.8 では ''たぶん'' 動きますが、 [http://trac.edgewall.org/ticket/3371 #3371] に記述されている通り、メインインタプリタを使用するように強制するワークアラウンドを使用する方がおそらく良いでしょう: |
| 335 | {{{ |
| 336 | PythonInterpreter main_interpreter |
| 337 | }}} |
| 338 | これは、よく知られている mod_python と Subversion の Python バインディングの他の問題 ([http://trac.edgewall.org/ticket/2611 #2611], [http://trac.edgewall.org/ticket/3455 #3455]) について推奨しているワークアラウンドです。 [http://trac.edgewall.org/ticket/3455#comment:9 #3455] Graham Dumpleton のコメントに問題点が指摘されています。 |
| 339 | |
| 340 | === ページレイアウトの問題 === #Pagelayoutissues |
| 341 | |
| 342 | Trac のページフォーマットが奇妙に見えるなら、ページレイアウトを管理するスタイルシートが Web サーバによって適切に扱われていない可能性が考えられます。 Apache のコンフィグに以下を追加してみてください: |
| 343 | {{{ |
| 344 | #!xml |
| 345 | Alias /myproject/css "/usr/share/trac/htdocs/css" |
| 346 | <Location /myproject/css> |
| 347 | SetHandler None |
| 348 | </Location> |
| 349 | }}} |
| 350 | |
| 351 | Note: 上記のコンフィグが効果を発揮するためには、プロジェクトの root 位置のコンフィグ後に追加しなければなりません。つまり {{{<Location /myproject />}}} 以降です。 |
| 352 | |
| 353 | === HTTPS の問題 === #HTTPSissues |
| 354 | |
| 355 | Trac を完全に https で実行したいにも関わらず、プレーンな http にリダイレクトされる場合、 Apache のコンフィグに以下を追加してください: |
| 356 | {{{ |
| 357 | #!xml |
| 358 | <VirtualHost * > |
| 359 | DocumentRoot /var/www/myproject |
| 360 | ServerName trac.mycompany.com |
| 361 | SetEnv HTTPS 1 |
| 362 | .... |
| 363 | </VirtualHost> |
| 364 | }}} |
| 365 | |
| 366 | === Fedora 7 の問題 === #Fedora7Issues |
| 367 | 必ず 'python-sqlite2' をインストールしてください。 TracModPython では必須です (tracd では必須ではありません)。 |
| 368 | |
| 369 | |
| 370 | === php5-mhash または その他の php5 モジュールのセグメンテーションフォルト === #Segmentationfaultwithphp5-mhashorotherphp5modules |
| 371 | php5-mhash モジュールがインストールされている場合、 (debian etch について報告された) セグメンテーションフォルトに遭遇するでしょう。 php-mhash を削除して、問題が解決するかを確かめてみてください。 debian のバグレポート [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411487]] を参考にして下さい。 |
| 372 | |
| 373 | システムライブラリの代わりに、サードパーティのライブラリでコンパイルされた php5 を使用する一部の人々にもトラブルが発生します。ここを確認してください [[http://www.djangoproject.com/documentation/modpython/#if-you-get-a-segmentation-fault]] |