Changes between Version 1 and Version 2 of TracInstall


Ignore:
Timestamp:
2007/03/06 12:34:28 (19 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracInstall

    v1 v2  
    22[[TracGuideToc]] 
    33 
    4 Trac は軽量なプロジェクト管理ツールで、 Web ベースのアプリケーションとして実装されています。 Trac は Python で記述されており、データベースとして [http://sqlite.org/ SQLite] や [http://www.postgresql.org/ PostgreSQL] を使用することができます。 HTML レンダリングには [http://www.clearsilver.net/ Clearsilver] テンプレートシステムを使用します。 
     4Trac は軽量なプロジェクト管理ツールで、 Web ベースのアプリケーションとして実装されています。 Trac は Python で記述されており、データベースが必要です。 ([http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], [http://mysql.com/ MySQL] が使用可能です)。 HTML レンダリングには [http://www.clearsilver.net/ Clearsilver] テンプレートシステムを使用します。 
    55 
    6 以下に示すのは、 Trac のインストールと設定要件に関する一般的な説明です。 Trac を特定のシステムにインストールするための説明は Trac のメインサイトの [http://projects.edgewall.com/trac/wiki/TracInstallPlatforms TracInstallPlatforms] に掲載されています。インストールに必要なタスクをよく理解するためにこれらの一般的な説明を最初に必ず読んでください。 
     6以下に示すのは、 Trac のインストールと設定要件に関する一般的な説明です。 Trac を特定のシステムにインストールするための説明は Trac のメインサイトの [http://trac.edgewall.org/wiki/TracInstallPlatforms TracInstallPlatforms] に掲載されています。インストールに必要なタスクをよく理解するためにこれらの一般的な説明を最初に必ず読んでください。 
    77 
    88== インストール要件 == 
    … …  
    1111 
    1212 * [http://www.python.org/ Python], バージョン 2.3 以上。 
    13    * Python バージョン 2.4 は Windows でサポートされていません。利用できる Windows 用の Subversion bindings がありません。 
    1413   * RPM をベースとしたシステムでは `python-devel` と `python-xml` パッケージも必要かもしれません。 
    15  * [http://subversion.tigris.org/ Subversion], バージョン 1.0 以上 (バージョン 1.1 以上を推奨) と 対応する [http://svnbook.red-bean.com/svnbook-1.1/ch08s02.html#svn-ch-8-sect-2.3 Python bindings]。 
    16    * Trac は Subversion の中に含まれている [http://www.swig.org/ SWIG] bindings を使用します。[http://pysvn.tigris.org/ PySVN] ( ときどきSWIG binding と間違えることがあります) '''ではありません。''' 
    17    * もし すでに Subversion が SWIG bindings なしでインストールされていたら、Subversion を re-`configure` し、`make swig-py`, `make install-swig-py` を行う必要があります。 
     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 が利用可能となっています。 
    1816 * [http://www.clearsilver.net/ ClearSilver], バージョン 0.9.3 以上。 
    1917   * python-bindings (`./configure --with-python=/usr/bin/python`) 
     18 * データベースと使用するデータベースに適切な Python のドライバが必要です。 
     19   データベースとして SQLite, PostgreSQL, MySQL ''(実験的)'' が使用できます。 
    2020 
    21 === SQLite利用 === 
     21=== SQLite 利用 === 
    2222 
    23  * [http://www.sqlite.org/ SQLite], バージョン 2.8.x か 3.x 
    24  * [http://pysqlite.org/ PySQLite] 
    25    * version 1.0.x (for SQLite 2.8.x) 
    26    * version 1.1.x or 2.x (for SQLite 3.x) 
     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] 参照。 
    2725 
    28 === PostgreSQL利用 === 
     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 利用 === 
    2933 
    3034 * [http://www.postgresql.org/ PostgreSQL] 
    31  * [http://initd.org/projects/psycopg1 psycopg1], [http://initd.org/projects/psycopg2 psycopg2], or [http://pypgsql.sourceforge.net/ pyPgSQL] 
     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 以降です。'' 
    3247 
    3348=== オプション要件 === 
    3449 
    35  * CGI をサポートする Web サーバ (see TracCgi) または 
    36  * [http://www.fastcgi.com/ FastCGI] をサポートする Web サーバ(see TracFastCgi) または 
     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) または 
    3759 * [http://httpd.apache.org/ Apache] と [http://www.modpython.org/ mod_python 3.1.3+] (see TracModPython) 
    38  * プラグインを使用する場合 [http://peak.telecommunity.com/DevCenter/setuptools setuptools], バージョン 0.5a13 以上。 (see TracPlugins) 
    39  * WikiRestructuredText を使用する場合 [http://docutils.sourceforge.net/ docutils], バージョン 0.3.3 以上 
     60    * mod_python の開発バージョンをインストールするとき、 Python と Apache が必要です。 (実際のライブラリとヘッダファイル) 
     61 
     62Apache 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 以上 
    4067 * [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 を使用することを推奨します。 
    4169 
    42 ''注意''': これらのソフトウェアの依存するパッケージに利用可能なバージョンがいろいろありますが、かならずしも互換性あるとは限りません。上記のバージョン番号に注意してください。もし Trac が動かないようだったら、すべての依存関係をもう一度確認してください。確認したうえで、 [http://projects.edgewall.com/trac/wiki/MailingList メーリングリスト] や [http://projects.edgewall.com/trac/wiki/IrcChannel IRCチャンネル] をたずねてみてください。 
     70''注意''': これらのソフトウェアの依存するパッケージに利用可能なバージョンがいろいろありますが、かならずしも互換性あるとは限りません。上記のバージョン番号に注意してください。もし Trac が動かないようだったら、すべての依存関係をもう一度確認してください。確認したうえで、 [http://trac.edgewall.org/wiki/MailingList メーリングリスト] や [http://trac.edgewall.org/wiki/IrcChannel IRCチャンネル] をたずねてみてください。 
    4371 
    44 これらのパッケージの最もよいインストール方法を理解するためにパッケージ付属のドキュメントを読んでください。加えて、 [http://projects.edgewall.com/trac/wiki/TracInstallPlatforms プラットフォーム特有の説明] にも、インストール時の依存関係が記述されています。 
     72これらのパッケージの最もよいインストール方法を理解するためにパッケージ付属のドキュメントを読んでください。加えて、 [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] にも、インストール時の依存関係が記述されています。ただしそれもインストールしようとしている Trac のバージョンより古いバージョンにおける情報かもしれないということを覚えておいて下さい。(特に、 
     73いくつかのページは Trac 0.8 の説明になっています。) 
    4574 
    4675== Trac のインストール == 
    … …  
    5483 
    5584この手順は、 Python ソースコードをバイトコンパイルして、 Python の `site-packages` ディレクトリにインストールします。 
    56 また、ディレクトリ `cgi-bin`, `template`, `htdocs`, `wiki-default`, `wiki-macros` 配下のすべてのファイルを 
    57 `$prefix/share/trac/` ディレクトリにコピーします。   
     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] 以降'')。 
    5886 
    5987さらに、このスクリプトでは  [wiki:TracEnvironment Trac environment] を作成したりメンテナンスするためのコマンドラインツールである [wiki:TracAdmin trac-admin] や、スタンドアロンで動作するサーバ [wiki:TracStandalone tracd] をインストールします。 
    6088 
    61 === 上級ユーザ === 
     89=== 上級オプション === 
    6290 
    6391Trac を上記以外の場所にインストールしたい場合や、その他の高度なインストールオプションを見たい場合は次のコマンドを実行してください: 
    6492{{{ 
    65 $ python ./setup.py --help 
     93$ python ./setup.py install --help 
    6694}}} 
     95 
     96詳細は [http://docs.python.org/inst/inst.html Installing Python Modules] を参照。 
    6797 
    6898単純にインストールする場所を変えたいのであれば、以下の通りです: 
    6999{{{ 
    70 $ python ./setup.py install --prefix=/path/you/want 
     100$ python ./setup.py install --prefix=/path/to/installdir 
    71101}}} 
    72102 
     103== プロジェクト環境の作成 == 
    73104 
    74 == プロジェクト環境の作成  == 
    75  
    76 [wiki:TracEnvironment Trac environment] は Trac が Wiki ページ、チケット、レポート、設定などのような情報を保存するバックエンドストレージです。 [wiki:TracEnvironment Trac environment] は基本的に、人間が読むことができる設定ファイル、その他いろいろなファイルとディレクトリを含んだディレクトリです。  
     105[wiki:TracEnvironment Trac environment] は Trac が Wiki ページ、チケット、レポート、設定などのような情報を保存するバックエンドストレージです。 [wiki:TracEnvironment Trac environment] は基本的に、人間が読むことができる設定ファイル、その他いろいろなファイルとディレクトリを含んだディレクトリです。 
    77106 
    78107[wiki:TracAdmin trac-admin] を使用して、新しい Trac environment を作成します。: 
    79108{{{ 
    80 $ trac-admin /path/to/trac_project_env initenv 
     109$ trac-admin /path/to/myproject initenv 
    81110}}} 
    82111 
    83 [wiki:TracAdmin trac-admin] がプロジェクト環境を作成するのに必要な情報を聞いてきます。たとえば、プロジェクトの名前や、使用する Subversion リポジトリのパス、 [wiki:TracEnvironment#データベースに接続するための文字列 データベースに接続するための文字列] などです。もしこれらのオプションのひとつを何にすればいいのか分からなければ、デフォルト値を使用するために空白にしておいてください。特にデータベースに接続するための文字列は SQLite をインストールしている限り、動くでしょう。ただ唯一デフォルト値を使用した場合に動かないであろうというオプションは Subversion のリポジトリへのパスくらいでしょう。このオプションは確実に修正して下さい。 
     112[wiki:TracAdmin trac-admin] がプロジェクト環境を作成するのに必要な情報を聞いてきます。たとえば、プロジェクトの名前や、[wiki:TracEnvironment#SourceCodeRepository ソースコードリポジトリ] の種類とパス、 [wiki:TracEnvironment#データベースに接続するための文字列 データベースに接続するための文字列] などです。もしこれらのオプションで設定を何にすればいいのか分からなければ、デフォルト値を使用するために空白にしておいてください。特にデータベースに接続するための文字列は SQLite をインストールしている限り、動くでしょう。ソースコードリポジトリへのパスを空白にしておくとバージョン管理に関する機能が無効になりますが、システムが動いてさえいれば、後からいつでも追加することができます。 
    84113 
    85114また、ここで指定した値は後で [wiki:TracIni 設定ファイル] を編集することによって変更できます。 
    86115 
    87116''Note: Web サーバの起動ユーザには、この environment ディレクトリ、 
    88 およびその配下のすべてのファイルに対する書き込みパーミッションが必要です。 '' 
     117およびその配下のすべてのファイルに対する書き込みパーミッションが必要です。'' 
    89118 
    90119 
    … …  
    93122Trac environment を作成した後, スタンドアロンサーバの [wiki:TracStandalone tracd] を起動することによって簡単に Web インタフェースを使ってみることができます。 
    94123{{{ 
    95 $ tracd --port 8000 /path/to/projectenv 
     124$ tracd --port 8000 /path/to/myproject 
    96125}}} 
    97126 
    … …  
    105134== 認証の設定 == 
    106135 
    107 ユーザアカウントの追加・削除・設定はどのような方法で Trac を動かしているかによります。これらのタスクをどのようにこなしていくかを知るために、以下にあげるページを訪れてください: 
     136ユーザアカウントの追加・削除・設定はどのような方法で Trac を動かしているかによります。基本的な手順は TracCgi ページの [wiki:TracCgi#認証を追加する 認証を追加する] セクションに書かれています。使用しているフロントエンドでの認証の設定方法を学ぶには、以下のページのどれかを参照してください: 
    108137 
    109138 * TracStandalone スタンドアロンサーバ `tracd` を使用している場合 
    … …  
    119148''それでは楽しんで!'' 
    120149 
    121 [http://projects.edgewall.com/trac/wiki/TracTeam The Trac Team] 
     150[http://trac.edgewall.org/wiki/TracTeam The Trac Team] 
    122151 
    123152----