| Version 1 (modified by trac, 18 years ago) (diff) |
|---|
Trac インストールガイド
Table of Contents
Trac は軽量なプロジェクト管理ツールで、 Web ベースのアプリケーションとして実装されています。 Trac は Python で記述されており、データベースとして SQLite や PostgreSQL を使用することができます。 HTML レンダリングには Clearsilver テンプレートシステムを使用します。
以下に示すのは、 Trac のインストールと設定要件に関する一般的な説明です。 Trac を特定のシステムにインストールするための説明は Trac のメインサイトの TracInstallPlatforms に掲載されています。インストールに必要なタスクをよく理解するためにこれらの一般的な説明を最初に必ず読んでください。
インストール要件
ソフトウェア要件:
- Python, バージョン 2.3 以上。
- Python バージョン 2.4 は Windows でサポートされていません。利用できる Windows 用の Subversion bindings がありません。
- RPM をベースとしたシステムでは python-devel と python-xml パッケージも必要かもしれません。
- Subversion, バージョン 1.0 以上 (バージョン 1.1 以上を推奨) と 対応する Python bindings。
- ClearSilver, バージョン 0.9.3 以上。
- python-bindings (./configure --with-python=/usr/bin/python)
SQLite利用
- SQLite, バージョン 2.8.x か 3.x
- PySQLite
- version 1.0.x (for SQLite 2.8.x)
- version 1.1.x or 2.x (for SQLite 3.x)
PostgreSQL利用
オプション要件
- CGI をサポートする Web サーバ (see TracCgi) または
- FastCGI をサポートする Web サーバ(see TracFastCgi) または
- Apache と mod_python 3.1.3+ (see TracModPython)
- プラグインを使用する場合 setuptools, バージョン 0.5a13 以上。 (see TracPlugins)
- WikiRestructuredText を使用する場合 docutils, バージョン 0.3.3 以上
- シンタックス ハイライト を使用する場合 SilverCity または Enscript もしくは両方。
注意: これらのソフトウェアの依存するパッケージに利用可能なバージョンがいろいろありますが、かならずしも互換性あるとは限りません。上記のバージョン番号に注意してください。もし Trac が動かないようだったら、すべての依存関係をもう一度確認してください。確認したうえで、 メーリングリスト や IRCチャンネル をたずねてみてください。
これらのパッケージの最もよいインストール方法を理解するためにパッケージ付属のドキュメントを読んでください。加えて、 プラットフォーム特有の説明 にも、インストール時の依存関係が記述されています。
Trac のインストール
多くの Python プログラムと同様、ソースディレクトリの一番上で次のコマンドを実行することで、 Trac の Python パッケージをインストールできます:
$ python ./setup.py install
Note: このステップをおこなうには root 権限、またはそれと同等の権限が必要です。
この手順は、 Python ソースコードをバイトコンパイルして、 Python の site-packages ディレクトリにインストールします。 また、ディレクトリ cgi-bin, template, htdocs, wiki-default, wiki-macros 配下のすべてのファイルを $prefix/share/trac/ ディレクトリにコピーします。
さらに、このスクリプトでは Trac environment を作成したりメンテナンスするためのコマンドラインツールである trac-admin や、スタンドアロンで動作するサーバ tracd をインストールします。
上級ユーザ
Trac を上記以外の場所にインストールしたい場合や、その他の高度なインストールオプションを見たい場合は次のコマンドを実行してください:
$ python ./setup.py --help
単純にインストールする場所を変えたいのであれば、以下の通りです:
$ python ./setup.py install --prefix=/path/you/want
プロジェクト環境の作成
Trac environment は Trac が Wiki ページ、チケット、レポート、設定などのような情報を保存するバックエンドストレージです。 Trac environment は基本的に、人間が読むことができる設定ファイル、その他いろいろなファイルとディレクトリを含んだディレクトリです。
trac-admin を使用して、新しい Trac environment を作成します。:
$ trac-admin /path/to/trac_project_env initenv
trac-admin がプロジェクト環境を作成するのに必要な情報を聞いてきます。たとえば、プロジェクトの名前や、使用する Subversion リポジトリのパス、 データベースに接続するための文字列 などです。もしこれらのオプションのひとつを何にすればいいのか分からなければ、デフォルト値を使用するために空白にしておいてください。特にデータベースに接続するための文字列は SQLite をインストールしている限り、動くでしょう。ただ唯一デフォルト値を使用した場合に動かないであろうというオプションは Subversion のリポジトリへのパスくらいでしょう。このオプションは確実に修正して下さい。
また、ここで指定した値は後で 設定ファイル を編集することによって変更できます。
Note: Web サーバの起動ユーザには、この environment ディレクトリ、 およびその配下のすべてのファイルに対する書き込みパーミッションが必要です。
スタンドアロンサーバを起動する
Trac environment を作成した後, スタンドアロンサーバの tracd を起動することによって簡単に Web インタフェースを使ってみることができます。
$ tracd --port 8000 /path/to/projectenv
そして、ブラウザを起動して、 http://localhost:8000/ にアクセスしてみてください。 tracd が認識しているすべての環境が簡単にリストされます。作成した環境へのリンクをクリックし、実際の Trac を見るべきです。
Web サーバで Trac を起動する
Tracは“"本当の" Web サーバに接続するための 3 つのオプションを提供しています: CGI, FastCGI と mod_python です。まともなパフォーマンスを引き出すために、 FastCGI か mod_python を使用することをおすすめします。
認証の設定
ユーザアカウントの追加・削除・設定はどのような方法で Trac を動かしているかによります。これらのタスクをどのようにこなしていくかを知るために、以下にあげるページを訪れてください:
- TracStandalone スタンドアロンサーバ tracd を使用している場合
- TracCgi CGI または FastCGI を使用している場合
- TracModPython mod_python を使用している場合
Trac を使う
一度、 Trac のサイトを構築して起動したら、 Subversion のリポジトリをブラウズしたり、チケットを登録したり、タイムラインを見たりすることができます。
デフォルトの設定では、 anonymous ユーザ (ログインしていないユーザ) でも大半の機能を使用できますが、全てではありません。認証を設定し、認証済みのユーザがすべての機能を利用できるように 権限 を追加するのを忘れないで下さい。
それでは楽しんで''
See also: TracGuide, TracCgi, TracFastCgi, TracModPython, TracUpgrade, TracPermissions
