4 | | Trac は軽量なプロジェクト管理ツールで、 Web ベースのアプリケーションとして実装されています。 Trac は Python で記述されており、データベースが必要です。 ([http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], [http://mysql.com/ MySQL] が使用可能です)。 HTML レンダリングには [http://www.clearsilver.net/ Clearsilver] テンプレートシステムを使用します。 |
5 | | |
6 | | 以下に示すのは、 Trac のインストールと設定要件に関する一般的な説明です。 Trac を特定のシステムにインストールするための説明は Trac のメインサイトの [http://trac.edgewall.org/wiki/TracInstallPlatforms TracInstallPlatforms] に掲載されています。インストールに必要なタスクをよく理解するためにこれらの一般的な説明を最初に必ず読んでください。 |
7 | | |
8 | | == インストール要件 == |
9 | | |
10 | | ソフトウェア要件: |
11 | | |
12 | | * [http://www.python.org/ Python], バージョン 2.3 以上。 |
13 | | * RPM をベースとしたシステムでは `python-devel` と `python-xml` パッケージも必要かもしれません。 |
14 | | * もし Windows 上で Trac を Subversion とともに使用するならば、 Python 2.4 用にプリコンパイルされた Subversion bindings がないので、 Python 2.3 が必要になるでしょう。 |
15 | | * 2006-09-20: この記述はもはや正しくないかもしれません。 http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 を参照して下さい。 Subversion 1.4.0 用の python 2.4 の バイナリの bindings が利用可能となっています。 |
16 | | * [http://www.clearsilver.net/ ClearSilver], バージョン 0.9.3 以上。 |
17 | | * python-bindings (`./configure --with-python=/usr/bin/python`) |
18 | | * データベースと使用するデータベースに適切な Python のドライバが必要です。 |
19 | | データベースとして SQLite, PostgreSQL, MySQL ''(実験的)'' が使用できます。 |
20 | | |
21 | | === SQLite 利用 === |
22 | | |
23 | | * [http://www.sqlite.org/ SQLite], バージョン 2.8.x か 3.x(推奨) |
24 | | * [http://pysqlite.org/ PySQLite], バージョン 1.x (SQLite 2.x 用) またはバージョン 2.x (SQLite 3.x 用)。詳細は[http://trac.edgewall.org/wiki/PySqlite PySqlite] 参照。 |
25 | | |
26 | | ''Note: Trac のバージョン 0.9 以前では PySQLite 2.x は '''動きません'''。'' |
27 | | |
28 | | ''Note: リポジトリの 'contrib' セクションにある 'trac-post-commit-hook.py' スクリプトを使用するつもりならば、PySQLite 2.x は Trac 0.9+/SQLite 3.x が必要です。 |
29 | | |
30 | | ''Note: Mac OS X のユーザは気を付けて下さい; Apple 社が供給している SQLite は AFP や SMP といったネットワークファイルシステムにおけるファイルのロックを実現するためのコードが含まれています。これは現在の主流ではありませんので、ソースコードから自分で SQLite をビルドする場合、このようなファイルシステムでは正しく動かないでしょう。- たいていの場合、 "{{{database is locked}}}" というエラーがでるでしょう。 アップル社のコードのバージョン 3.3.6 で利用可能な [http://www.alastairs-place.net/2006/07/sqlite_and_mac/ パッチ] があります。それ以外では、アップル社が供給しているバージョン (現在 3.1.3) を使用するのがたぶん最良でしょう。 |
31 | | |
32 | | === PostgreSQL 利用 === |
| 4 | Trac は Python で書かれており、データベースとして [http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], [http://mysql.com/ MySQL] のどれかが必要です。 Trac は HTML レンダリングのために [http://genshi.edgewall.org Genshi] テンプレートシステムを使用します。 |
| 5 | |
| 6 | Trac のインストールとセットアップに対する一般的な手順を以下に示します。 Trac を特定のシステムにインストールする手順は Trac Project サイトの [http://trac.edgewall.org/wiki/TracInstallPlatforms TracInstallPlatforms] にありますが、 '''まず最初に以下の一般的な手順を読み通して''' タスクの関係を確実に理解してください。 |
| 7 | |
| 8 | == 簡単な方法 - リリースバージョン向け == #Short-Installareleasedversion |
| 9 | クイックインストールをするためには [http://python.org Python-2.5], [http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install easy_install], SQlite-3.3.4 がすでにインストールされていなければなりません (各バージョンは、より新しいものでも可)。 (Genshi をビルドするのであれば、 python-dev (訳注: のような Python のビルド環境パッケージ) も必要になります) |
| 10 | {{{ |
| 11 | sudo easy_install Trac |
| 12 | }}} |
| 13 | |
| 14 | == インストール条件 == #Requirements |
| 15 | Trac を動作させるためのハードウェア要件は、当然のことながらデータ (Wiki ページ, チケット, リビジョンの数) のボリュームやトラフィックに強く依存します。とても小さなプロジェクトであれば、 500MHz のプロセッサ一つに 128MB の RAM でも SQLite を使って充分動作させられます。高速なハードディスクであればさらに動作が快適になるでしょう。 |
| 16 | |
| 17 | Trac をインストールするためには以下のソフトウェアパッケージがインストールされていなければなりません: |
| 18 | |
| 19 | * [http://www.python.org/ Python] 2.3 以上 |
| 20 | * XML 関連が組み込まれた mod_python を使用する場合、 python-2.5 を使用してください。 expat モジュールがネームスペース化されているので、 apache のクラッシュが引き起こされることがなくなります。 (詳細は [http://www.dscpl.com.au/wiki/ModPython/Articles/ExpatCausingApacheCrash ここ] を参照してください) 。 |
| 21 | * RPM ベースのシステムでは、 `python-devel` と `python-xml` パッケージが必要になるかもしれません。 |
| 22 | * 注意事項を参照してください。 [http://trac.edgewall.org/wiki/TracOnWindows/Python2.5 "TracOnWindows/Python2.5"] |
| 23 | * [http://peak.telecommunity.com/DevCenter/setuptools setuptools] 0.6 以上 |
| 24 | * [http://genshi.edgewall.org/wiki/Download Genshi] 0.5 以上 (バージョン 0.4.1 以上という記述は 0.11 のリリース候補以前の場合でした) |
| 25 | * データベースシステムと対応する Python ドライバが必要です。 |
| 26 | データベースは SQLite, PostgreSQL, ''MySQL (実験的)'' のどれかが使えます。 |
| 27 | * プラグインが必要とする場合は [http://www.clearsilver.net/ ClearSilver] が必要です。 |
| 28 | |
| 29 | ==== SQLiteの場合 ==== #ForSQLite |
| 30 | |
| 31 | * [http://www.sqlite.org/ SQLite] 3.3.4 以上を推奨します (Note: Python 2.5.2 には同梱されています)。 |
| 32 | * Python-2.5 を使用しないなら [http://pysqlite.org/ PySQLite] が必要です (2.3.2 を推奨します)。 SQLite 2.x を使用する場合 PySQLite version 1.x 、 SQLite 3.x を使用する場合 PySQLite version 2.x がそれぞれ必要です。 詳細は [http://trac.edgewall.org/wiki/PySqlite PySqlite] を参照してください。 |
| 33 | |
| 34 | ''Note: 'contrib/trac-post-commit-hook' を使用する場合、 Trac は 0.9 以降、 PySQLite は 2.x が必要です。 |
| 35 | |
| 36 | ''Note: Mac OS X のユーザは注意してください; Apple が提供している SQLite は AFP や SMB のようなネットワークファイルシステムでのがいるロックを行うための追加コードが含まれています。このコードは現在のメインラインのソース (3.3.6) では存在しませんので、ソースから SQLite をビルドした場合にこのようなファイルシステムでは正しく機能しないでしょう - 通常は "{{{database is locked}}}" というエラーが発生します。 Apple のコードをベースにした 3.3.6 向けの [http://www.alastairs-place.net/2006/07/sqlite_and_mac/ パッチ] があります。また、 Apple から提供されている別のバージョン (今のところ 3.1.3) を使用するのがおそらく最も良いでしょう。'' |
| 37 | |
| 38 | ==== PostgreSQLの場合 ==== #ForPostgreSQL |
35 | | * [http://initd.org/projects/psycopg2 psycopg2] or [http://pypgsql.sourceforge.net/ pyPgSQL] |
36 | | |
37 | | ''Note: PostgreSQL に対応しているのは Trac バージョン 0.9 以降です。'' |
38 | | |
39 | | === MySQL 利用 === |
40 | | |
41 | | '''注意''': MySQL の対応は現在実験段階です。動くかもしれませんが、まだ十分にテストはされていません。 |
42 | | |
43 | | * [http://mysql.com/ MySQL], version 4.1 or later |
44 | | * [http://sf.net/projects/mysql-python MySQLdb], version 1.2.1 or later |
45 | | |
46 | | ''Note: MySQL に対応しているのは Trac バージョン 0.10 以降です。'' |
47 | | |
48 | | === オプション要件 === |
49 | | |
50 | | ==== バージョン管理システム ==== |
51 | | * [http://subversion.tigris.org/ Subversion], バージョン 1.0 以降(1.2.3 もしくは 1.3.1以降推奨) と 対応する [http://svnbook.red-bean.com/svnbook-1.1/ch08s02.html#svn-ch-8-sect-2.3 Python bindings]。トラブルシューティングについては、 [http://projects.edgewall.com/trac/wiki/TracSubversion TracSubversion] を参照して下さい。 |
52 | | * Trac は Subversion の配布物の中の [http://www.swig.org/ SWIG] bindings を使用します。[http://pysvn.tigris.org/ PySVN]''' ではありません'''。(ときどき標準の SWIG bindings と混同します) |
53 | | * もし Subversion が SWIG bindings なしでインストールされていた場合、 Subversion をre-`configure` して `make swig-py`, `make install-swig-py` を実行する必要があります。 |
54 | | * サードパーティが提供しているほかのバージョン管理システムに対応しています。 [http://projects.edgewall.com/trac/wiki/PluginList PluginList] と[http://projects.edgewall.com/trac/wiki/VersioningSystemBackend VersioningSystemBackend] を参照して下さい。 |
55 | | |
56 | | ==== Web サーバ ==== |
57 | | * CGI を利用可能な Web サーバ (see TracCgi) または |
58 | | * [http://www.fastcgi.com/ FastCGI] を利用可能な Web サーバ(see TracFastCgi) または |
59 | | * [http://httpd.apache.org/ Apache] と [http://www.modpython.org/ mod_python 3.1.3+] (see TracModPython) |
60 | | * mod_python の開発バージョンをインストールするとき、 Python と Apache が必要です。 (実際のライブラリとヘッダファイル) |
61 | | |
62 | | Apache 1.3 で実行するには、 Trac 0.8.4 と[http://www.modpython.org/ mod_python 2.7] を使用することで可能となります。([http://trac.edgewall.org/wiki/TracModPython2.7 TracModPython2.7] 参照) Trac 0.9 ではテストしていないので、動くかどうかは分かりません。 |
63 | | |
64 | | ==== その他の Python のユーティリティ ==== |
65 | | * プラグインを使用する場合 [http://peak.telecommunity.com/DevCenter/setuptools setuptools], バージョン 0.6 以上。 (see TracPlugins) |
66 | | * WikiRestructuredText を使用する場合 [http://docutils.sourceforge.net/ docutils], バージョン 0.3.9 以上 |
67 | | * [wiki:TracSyntaxColoring シンタックス ハイライト] を使用する場合 [http://silvercity.sourceforge.net/ SilverCity] または [http://www.gnu.org/software/enscript/enscript.html Enscript] もしくは両方。 |
68 | | * !SilverCity 0.9.6 には [http://sourceforge.net/tracker/index.php?func=detail&aid=1424436&group_id=45693&atid=443739 バグ] があり、 Trac で Python のシンタックスハイライトを壊してしまいます。更新バージョンが利用可能になるまで、バージョン 0.9.5 を使用することを推奨します。 |
69 | | |
70 | | ''注意''': これらのソフトウェアの依存するパッケージに利用可能なバージョンがいろいろありますが、かならずしも互換性あるとは限りません。上記のバージョン番号に注意してください。もし Trac が動かないようだったら、すべての依存関係をもう一度確認してください。確認したうえで、 [http://trac.edgewall.org/wiki/MailingList メーリングリスト] や [http://trac.edgewall.org/wiki/IrcChannel IRCチャンネル] をたずねてみてください。 |
71 | | |
72 | | これらのパッケージの最もよいインストール方法を理解するためにパッケージ付属のドキュメントを読んでください。加えて、 [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] にも、インストール時の依存関係が記述されています。ただしそれもインストールしようとしている Trac のバージョンより古いバージョンにおける情報かもしれないということを覚えておいて下さい。(特に、 |
73 | | いくつかのページは Trac 0.8 の説明になっています。) |
74 | | |
75 | | == Trac のインストール == |
76 | | |
77 | | 多くの Python プログラムと同様、ソースディレクトリの一番上で次のコマンドを実行することで、 Trac の Python パッケージをインストールできます: |
| 41 | * [http://initd.org/projects/psycopg2 psycopg2] |
| 42 | * See [http://trac.edgewall.org/wiki/DatabaseBackend#Postgresql DatabaseBackend] |
| 43 | |
| 44 | '''Warning''': PostgreSQL 8.3 は厳密な型チェックメカニズムを採用しています。 Trac で PostgreSQL の バージョン 8.3 を使用するには、 [http://trac.edgewall.org/changeset/6512 trac-0.11] 以降でなければなりません。 |
| 45 | |
| 46 | ==== MySQLの場合 ==== #ForMySQL |
| 47 | |
| 48 | '''Warning''': MySQL のサポートは今のところ ''まだ'' 実験段階です。 環境によっては動作しますが、特に unicode の使用と、リポジトリキャッシュのキー長に関して、いくつかの問題が残っています。より詳細な情報は [http://trac.edgewall.org/wiki/MySqlDb MySqlDb] を参照してください。 |
| 49 | |
| 50 | * [http://mysql.com/ MySQL] 4.1 以上 |
| 51 | * [http://sf.net/projects/mysql-python MySQLdb] 1.2.1 以上 |
| 52 | |
| 53 | == 非必須の条件 == #OptionalRequirements |
| 54 | |
| 55 | ==== バージョン管理システム ==== #VersionControlSystem |
| 56 | |
| 57 | '''Please note:''' Subversion を使用するなら Trac を同じマシンにインストールする必要があります。リモートリポジトリは現在サポートされていません。 |
| 58 | |
| 59 | * [http://subversion.tigris.org/ Subversion] 1.0 以上 (1.2.4, 1.3.2, 1.4.2 のいずれかが推奨されます) と '''''対応する''''' Python バインディングに対応しています。トラブルシューティングには [http://trac.edgewall.org/wiki///trac.edgewall.org/wiki/TracSubversion TracSubversion] を参照してください。 |
| 60 | * Trac は Subversion のディストリビューションに含まれる [http://svnbook.red-bean.com/svnbook-1.1/ch08s02.html#svn-ch-8-sect-2.3 SWIG] バインディングを使用します。 [http://pysvn.tigris.org/ PySVN] では '''ありません''' (PySVN は時々、標準の SWIG バインディングと混同されることがあります)。 |
| 61 | * SWIG バインディングを含まない Subversion が既にインストールされている場合、 Unix であれば `make swig-py` と `make install-swig-py` による Subversion の再構成が必要です。 |
| 62 | * Win32 の場合、 [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 pre-compiled bindings] から取得してください。 |
| 63 | * サードパーティから他のバージョン管理システムのサポートが提供されています。 [http://trac.edgewal.org/wiki/PluginList PluginList] と [http://trac.edgewall.org/wiki/VersioningSystemBackend VersioningSystemBackend] を参照してください。 |
| 64 | |
| 65 | ==== Web サーバ ==== #WebServer |
| 66 | * CGI が利用可能な Web サーバ (TracCgi を参照してください) または |
| 67 | * [http://www.fastcgi.com/ FastCGI] が利用可能な Web サーバ (TracFastCgi を参照してください) または |
| 68 | * [http://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP] 互換の Web サーバ ([http://trac.edgewall.org/wiki/TracOnWindowsIisAjp TracOnWindowsIisAjp] を参照してください) または |
| 69 | * [http://httpd.apache.org/ Apache] と [http://code.google.com/p/modwsgi/ mod_wsgi] ([wiki:TracModWSGI] や http://code.google.com/p/modwsgi/wiki/IntegrationWithTrac を参照してください) |
| 70 | * mod_wsgi は非常に新しく、いくらか実験的ですが、これは Apache 1.3, 2.0 または 2.2 で動作するはずで、 mod_python を使用するよりも良いパフォーマンスが出るはずです。 |
| 71 | * [http://httpd.apache.org/ Apache] と [http://www.modpython.org/ mod_python 3.1.3 以降] (TracModPython を参照してください) |
| 72 | * mod_python をインストールするときは、開発向けの Python と Apache が必須になります (実際にはライブラリとヘッダファイル) 。 |
| 73 | |
| 74 | Trac を Apache と [http://www.modpython.org/ mod_python 2.7] で動かすことも可能です。([http://trac.edgewall.org/wiki/TracModPython2.7 TracModPython2.7] を参照してください) 。このガイドは 0.8.4 以降更新されていないので動作が異なるかもしれません。 |
| 75 | |
| 76 | ==== その他の Python ユーティリティ ==== #OtherPythonUtilities |
| 77 | * WikiRestructuredText は [http://docutils.sourceforge.net/ docutils] 0.3.9 以降が必要です。 |
| 78 | * '''シンタックスハイライト''' を行うには [http://pygments.pocoo.org Pygments] が必要です。 [http://silvercity.sourceforge.net/ SilverCity] の 0.9.7 以降や、 [http://gnu.org/software/enscript/enscript.html GNU Enscript] なども併せて使用することができます。詳細は TracSyntaxColoring を参照してください。 |
| 79 | * [http://pytz.sf.net pytz] からタイムゾーンの完全なリストを取得します。 pytz を使用しなければ Trac は内部実装された短いリストを使用します。 |
| 80 | |
| 81 | '''Attention''': これらの依存関係は様々なバージョンで必ずしも置き換えできるとは限らないので、上記のバージョン番号に注意してください。 Trac を動かす上で問題が発生した場合は [http://trac.edgewall.org/wiki/MailingList メーリングリスト] や [http://trac.edgewall.org/wiki/IrcChannel IRC チャネル] で質問をする前にすべての依存関係を再度確認してください。 |
| 82 | |
| 83 | これらのパッケージのドキュメンテーションを参照して、それらが最も上手にインストールできる方法を探してください。また [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] の多くに、これらの依存関係のインストール方法が記述されています。しかしながら [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] の情報はあなたがインストールしている Trac より古い バージョンについての説明があることを覚えておいてください (なんと Trac 0.8 に関する説明をしているページもあります)。 |
| 84 | |
| 85 | == Tracのインストール == #InstallingTrac |
| 86 | |
| 87 | Trac をインストールする 1 つの方法は `setuptools` を使用することです。 |
| 88 | setuptools は subversion のリポジトリから Trac をインストールすることができます; |
| 89 | 0.11 のリリースバージョンをインストールするための例を以下に示します: |
| 90 | {{{ |
| 91 | easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11 |
| 92 | }}} |
| 93 | |
| 94 | もちろん、ソースディレクトリのトップでの典型的な python セットアップもできます: |
82 | | ''Note: このステップをおこなうには root 権限、またはそれと同等の権限が必要です。'' |
83 | | |
84 | | この手順は、 Python ソースコードをバイトコンパイルして、 Python の `site-packages` ディレクトリにインストールします。 |
85 | | また、ディレクトリ `cgi-bin`, `template`, `htdocs`, `wiki-default`, `wiki-macros` 配下のすべてのファイルを `$prefix/share/trac/` ディレクトリにコピーします。 `conf` と `plugins` ディレクトリは `$prefix/share/trac` 配下に新規に作成されます (''[http://trac.edgewall.org/milestone/0.10 milestone:0.10] 以降'')。 |
86 | | |
87 | | さらに、このスクリプトでは [wiki:TracEnvironment Trac environment] を作成したりメンテナンスするためのコマンドラインツールである [wiki:TracAdmin trac-admin] や、スタンドアロンで動作するサーバ [wiki:TracStandalone tracd] をインストールします。 |
88 | | |
89 | | === 上級オプション === |
90 | | |
91 | | Trac を上記以外の場所にインストールしたい場合や、その他の高度なインストールオプションを見たい場合は次のコマンドを実行してください: |
92 | | {{{ |
93 | | $ python ./setup.py install --help |
94 | | }}} |
95 | | |
96 | | 詳細は [http://docs.python.org/inst/inst.html Installing Python Modules] を参照。 |
97 | | |
98 | | 単純にインストールする場所を変えたいのであれば、以下の通りです: |
99 | | {{{ |
100 | | $ python ./setup.py install --prefix=/path/to/installdir |
101 | | }}} |
102 | | |
103 | | == プロジェクト環境の作成 == |
104 | | |
105 | | [wiki:TracEnvironment Trac environment] は Trac が Wiki ページ、チケット、レポート、設定などのような情報を保存するバックエンドストレージです。 [wiki:TracEnvironment Trac environment] は基本的に、人間が読むことができる設定ファイル、その他いろいろなファイルとディレクトリを含んだディレクトリです。 |
106 | | |
107 | | [wiki:TracAdmin trac-admin] を使用して、新しい Trac environment を作成します。: |
| 99 | ''Note: このステップを実行するためには root 権限 (または root 権限と同等の権限) が必要です。'' |
| 100 | |
| 101 | この操作で Python のソースコードがバイトコンパイルされ、 .egg ファイルかディレクトリが Python インストールの `site-packages` ディレクトリにインストールされます。 |
| 102 | .egg には htdocs や templates のような、ソースファイル以外に標準インストールの Trac が必要とするすべてのリソースが含まれています。 |
| 103 | |
| 104 | このスクリプトは [wiki:TracStandalone tracd] スタンドアロンサーバと一緒に、 [wiki:TracEnvironment プロジェクト Environment] を作成し維持するための [wiki:TracAdmin trac-admin] コマンドラインツールをインストールします。 |
| 105 | |
| 106 | ==== 高度なオプション ==== #AdvancedOptions |
| 107 | |
| 108 | Trac のインストール場所を変えるなどの高度なインストールオプションを知りたければ以下を実行してください: |
| 109 | {{{ |
| 110 | easy_install --help |
| 111 | }}} |
| 112 | |
| 113 | 詳細な情報は [http://docs.python.org/inst/inst.html Python モジュールをインストールする] を参照してください。 |
| 114 | |
| 115 | 特にあなたは以下に興味を持つかもしれません: |
| 116 | {{{ |
| 117 | easy_install --prefix=/path/to/installdir |
| 118 | }}} |
| 119 | Mac OS X に Trac をインストールする場合: |
| 120 | {{{ |
| 121 | easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages |
| 122 | }}} |
| 123 | |
| 124 | 上記の例は、 `tracd` と `trac-admin` コマンドを `/usr/local/bin` に、 Trac のライブラリと依存ファイルを `/Library/Python/2.5/site-packages` にインストールします。これらのパスは Apple での Pyhton サードパーティアプリケーションの標準ロケーションです。(訳注: つまり、上記と違うパスにインストールしたい場合のみ、オプションの指定が必要になります) |
| 125 | |
| 126 | == プロジェクト Environment の作成 == #CreatingaProjectEnvironment |
| 127 | |
| 128 | [wiki:TracEnvironment Trac Environment] は Trac が Wiki ページ、チケット、レポート、設定などの情報を保存するバックエンドストレージです。基本的に人間が読み込み可能な構成ファイルと他の様々なファイルやディレクトリで構成されます。 |
| 129 | |
| 130 | 新しい環境は [wiki:TracAdmin trac-admin] を使用して作成します: |
112 | | [wiki:TracAdmin trac-admin] がプロジェクト環境を作成するのに必要な情報を聞いてきます。たとえば、プロジェクトの名前や、[wiki:TracEnvironment#SourceCodeRepository ソースコードリポジトリ] の種類とパス、 [wiki:TracEnvironment#データベースに接続するための文字列 データベースに接続するための文字列] などです。もしこれらのオプションで設定を何にすればいいのか分からなければ、デフォルト値を使用するために空白にしておいてください。特にデータベースに接続するための文字列は SQLite をインストールしている限り、動くでしょう。ソースコードリポジトリへのパスを空白にしておくとバージョン管理に関する機能が無効になりますが、システムが動いてさえいれば、後からいつでも追加することができます。 |
113 | | |
114 | | また、ここで指定した値は後で [wiki:TracIni 設定ファイル] を編集することによって変更できます。 |
115 | | |
116 | | ''Note: Web サーバの起動ユーザには、この environment ディレクトリ、 |
117 | | およびその配下のすべてのファイルに対する書き込みパーミッションが必要です。'' |
118 | | |
119 | | |
120 | | == スタンドアロンサーバを起動する == |
121 | | |
122 | | Trac environment を作成した後, スタンドアロンサーバの [wiki:TracStandalone tracd] を起動することによって簡単に Web インタフェースを使ってみることができます。 |
| 135 | [wiki:TracAdmin trac-admin] はプロジェクト名、 [wiki:TracEnvironment#SourceCodeRepository ソースコードのリポジトリ] のタイプとパス、 [wiki:TracEnvironment#DatabaseConnectionStrings データベース接続文字列] など、 Environment を作成するのに必要な情報の入力を促します。これらのオプションを指定せず、空白を入力するとデフォルト値が使用されます。 SQLite がインストールされている場合、データベース接続文字列はいつでもデフォルト値で動作します。バージョン管理システムのリポジトリへのパスを指定しない場合、バージョン管理に関するすべての機能が無効化されますが、基本システムが動いていればいつでもバージョン管理に関する機能を追加することができます。 |
| 136 | |
| 137 | また、 ここで指定した値は [wiki:TracIni] 設定ファイルを直接編集することで後から変更できることに留意してください。 |
| 138 | |
| 139 | ''Note: Web サーバのユーザアカウントは Environment のディレクトリと、その中のすべてのファイルに対する書き込み権限が必要です。 Linux では、 Web サーバが apache というユーザ、 apache というグループで起動している場合は以下のように入力してください。:'' |
| 140 | |
| 141 | chown -R apache.apache /path/to/myproject |
| 142 | |
| 143 | '''Warning: インストールされたファイルの中から trac.cgi を探しても見つかりません。現在のドキュメントは不完全な状態です; trac-admin の 'deploy' コマンドを使う必要があります。詳細は http://trac.edgewall.org/ticket/7312 や http://trac.edgewall.org/ticket/6827 を参照してください。''' |
| 144 | |
| 145 | == スタンドアロンサーバの起動 == #RunningtheStandaloneServer |
| 146 | |
| 147 | Trac 環境を作成した後に、スタンドアロンサーバ [wiki:TracStandalone tracd] を実行することで簡単に Web インタフェースを試すことができます。 |
127 | | そして、ブラウザを起動して、 `http://localhost:8000/` にアクセスしてみてください。 tracd が認識しているすべての環境が簡単にリストされます。作成した環境へのリンクをクリックし、実際の Trac を見るべきです。 |
128 | | |
129 | | |
130 | | == Web サーバで Trac を起動する == |
131 | | |
132 | | Tracは“"本当の" Web サーバに接続するための 3 つのオプションを提供しています: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI] と [wiki:TracModPython mod_python] です。まともなパフォーマンスを引き出すために、 FastCGI か mod_python を使用することをおすすめします。 |
133 | | |
134 | | == 認証の設定 == |
135 | | |
136 | | ユーザアカウントの追加・削除・設定はどのような方法で Trac を動かしているかによります。基本的な手順は TracCgi ページの [wiki:TracCgi#認証を追加する 認証を追加する] セクションに書かれています。使用しているフロントエンドでの認証の設定方法を学ぶには、以下のページのどれかを参照してください: |
137 | | |
138 | | * TracStandalone スタンドアロンサーバ `tracd` を使用している場合 |
139 | | * TracCgi CGI または FastCGI を使用している場合 |
140 | | * TracModPython mod_python を使用している場合 |
141 | | |
142 | | == Trac を使う == |
143 | | |
144 | | 一度、 Trac のサイトを構築して起動したら、 Subversion のリポジトリをブラウズしたり、チケットを登録したり、タイムラインを見たりすることができます。 |
145 | | |
146 | | デフォルトの設定では、 anonymous ユーザ (ログインしていないユーザ) でも大半の機能を使用できますが、全てではありません。認証を設定し、認証済みのユーザがすべての機能を利用できるように [wiki:TracPermissions 権限] を追加するのを忘れないで下さい。 |
147 | | |
148 | | ''それでは楽しんで!'' |
| 152 | ブラウザを起動して、 `http://localhost:8000/` にアクセスしてください。 tracd が認識しているすべての Environment の簡単な一覧が表示されます。作成した Environment へのリンクにアクセスすることで Trac が動作中であることを確認できます。 Trac でプロジェクトをひとつだけ管理したい場合、以下のように起動することで、スタンドアロンサーバは Environment 一覧の表示をスキップして、直接 Environment を表示します: |
| 153 | {{{ |
| 154 | $ tracd -s --port 8000 /path/to/myproject |
| 155 | }}} |
| 156 | |
| 157 | |
| 158 | == Web サーバ上での Trac の起動 == #RunningTraconaWebServer |
| 159 | |
| 160 | Trac に "真の" Web サーバから接続するには 3 つの方法があります: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI], [wiki:TracModPython mod_python] です。まともな性能を出すには FastCGI か mod_python のどちらかを使用することが推奨されます。 |
| 161 | |
| 162 | また、新しいコードを実行することを恐れていないのであれば [wiki:TracModWSGI mod_wsgi] を実行してみることもできます。 mod_wsgi は mod_python 以上の性能を提供するはずですが、 mod_python に比べ充分テストされたわけではありません。 |
| 163 | |
| 164 | Trac では [http://trac.edgewall.org/wiki/TracOnWindowsIisAjp AJP] も使用できます。これを使うと IIS とも接続することができます。 |
| 165 | |
| 166 | ==== プラグインキャッシュの設定 ==== #SettingupthePluginCache |
| 167 | |
| 168 | Python プラグインの中にはキャッシュディレクトリを必要とするものがあります。デフォルトではキャッシュディレクトリは、現在のユーザのホームディレクトリに置かれます。 Trac を Web サーバで動作させている場合、ホームディレクトリを持たない専用ユーザであることが多く (強く推奨します)、プラグインの起動が妨げられることがあります。キャッシュディレクトリの場所を変更するには、環境変数 PYTHON_EGG_CACHE を設定してください。設定方法の詳細は使用しているサーバのドキュメントから参照してください。 |
| 169 | |
| 170 | == 認証の構成 == #ConfiguringAuthentication |
| 171 | |
| 172 | 認証のためのユーザアカウントを追加、削除、構成する方法は Trac を起動する方法により異なります。基本的な手順は TracCgi ページの [wiki:TracCgi#AddingAuthentication "認証を追加する"] セクションで説明されていますが、各フロントエンドのための認証をセットアップする方法は、以下のいずれかを参照してください: |
| 173 | |
| 174 | * TracStandalone スタンドアロンサーバ `tracd` を使用する場合 |
| 175 | * TracCgi CGI か FastCGI を使用する場合 |
| 176 | * TracModPython mod_python を使用する場合 |
| 177 | |
| 178 | == SVN のチェンジセットを Trac のチケットに自動リンクする方法 == #AutomaticreferencetotheSVNchangesetsinTractickets |
| 179 | |
| 180 | ファイルをリポジトリにコミットした時に、チェンジセットへのリンクをチケットのコメントに自動で追加するように SVN を設定することができます。コミットメッセージには以下に示すいずれかの書式が含まれていなければなりません: |
| 181 | * '''Refs !#123''' - このチェンジセットへのリンクをチケット !#123 に追加します |
| 182 | * '''Fixes !#123''' - このチェンジセットへのリンクをチケット !#123 に追加し、チケットを ''fixed'' でクローズします。 |
| 183 | |
| 184 | SVN リポジトリの ''post-commit'' hook を編集し、 Trac 配布物に含まれる ''trac-post-commit-hook'' が実行されるようにしてください。 |
| 185 | |
| 186 | ''post-commit'' hook を編集するときは、まず SVN リポジトリ内の hooks フォルダに移動し、 ''post-commit'' 用のテンプレートファイルを rename してファイルを作成します: |
| 187 | |
| 188 | {{{ |
| 189 | $ cd /path/to/svn/repository/hooks |
| 190 | $ mv post-commit.tmpl post-commit |
| 191 | $ chmod 755 post-commit |
| 192 | }}} |
| 193 | |
| 194 | 続いて、ファイルをテキストエディタで開き、以下の行を追加します。パスは編集中の SVN リポジトリに接続している Trac environment のパス、および ''trac-post-commit-hook'' スクリプトのパスで置き換えてください: |
| 195 | |
| 196 | {{{ |
| 197 | REPOS="$1" |
| 198 | REV="$2" |
| 199 | TRAC_ENV="/path/to/your/trac/project" |
| 200 | |
| 201 | /usr/bin/python /usr/local/bin/trac-post-commit-hook -p "$TRAC_ENV" -r "$REV" |
| 202 | }}} |
| 203 | |
| 204 | もちろん ''trac-post-commit-hook'' は上記のパスに存在し、 SVN を実行しているユーザの権限で実行できる必要があります。このスクリプトは Trac 配布物中では contrib フォルダに配置されています。最新のバージョンは [http://trac.edgewall.org/browser/trunk/contrib/trac-post-commit-hook trunk/contrib/trac-post-commit-hook] からダウンロードすることができます。 |
| 205 | |
| 206 | |
| 207 | == プラットフォーム固有のインストール方法 == #Platform-specificsinstallations |
| 208 | |
| 209 | * [http://trac.edgewall.org/wiki/TracInstallPlatforms TracInstallPlatforms] を参照してください。 |
| 210 | |
| 211 | |
| 212 | == Tracを使用する == #UsingTrac |
| 213 | |
| 214 | 一度 Trac サイトを稼働させれば、 Subversion のリポジトリをブラウズする、チケットを作成する、タイムラインを見るなどが可能になるはずです。 |
| 215 | |
| 216 | anonymous (ログインしていない) でアクセスするユーザは、デフォルトでほとんどの機能を使用することができますが、すべての機能を使用できるわけではないことに留意してください。すべての機能を使用するためには認証を構成して、認証されたユーザに対し [wiki:TracPermissions アクセス許可] を与える必要があるでしょう。 |
| 217 | |
| 218 | '' Enjoy! '' |