XPressME Integration Kit

Trac

Initial Version から Version 1 における更新: TracInstall

差分発生行の前後
Ignore:
Timestamp:
Oct 30, 2008, 4:53:49 PM (16 years 前)
Author:
trac (IP: 127.0.0.1)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v1 v1  
     1= Trac インストールガイド 0.11 = #TracInstallationGuidefor0.11 
     2[[TracGuideToc]] 
     3 
     4Trac は Python で書かれており、データベースとして [http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], [http://mysql.com/ MySQL] のどれかが必要です。 Trac は HTML レンダリングのために [http://genshi.edgewall.org Genshi] テンプレートシステムを使用します。 
     5 
     6Trac のインストールとセットアップに対する一般的な手順を以下に示します。 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 がすでにインストールされていなければなりません (各バージョンは、より新しいものでも可)。 
     10{{{ 
     11sudo easy_install Trac==0.11 
     12}}} 
     13 
     14== インストール条件 - 古いバージョンである可能性があります == #Requirements-alsoolderversionspossible 
     15 
     16Trac をインストールするためには以下のソフトウェアパッケージがインストールされていなければなりません: 
     17 
     18 * [http://www.python.org/ Python] 2.3 以上 
     19   * XML 関連が組み込まれた mod_python を使用する場合、 python-2.5 を使用してください。 expat モジュールがネームスペース化されているので、 apache のクラッシュが引き起こされることがなくなります。 (詳細は [http://www.dscpl.com.au/wiki/ModPython/Articles/ExpatCausingApacheCrash ここ] を参照してください) 。 
     20   * RPM ベースのシステムでは、 `python-devel` と `python-xml` パッケージが必要になるかもしれません。 
     21   * 注意事項を参照してください。 [http://trac.edgewall.org/wiki/TracOnWindows/Python2.5 "TracOnWindows/Python2.5"] 
     22 * [http://peak.telecommunity.com/DevCenter/setuptools setuptools] 0.6 以上 
     23 * [http://genshi.edgewall.org/wiki/Download Genshi] 0.4.1 以上 
     24 * データベースシステムと対応する Python ドライバが必要です。 
     25   データベースは SQLite, PostgreSQL, ''MySQL (実験的)'' のどれかが使えます。 
     26 * プラグインが必要とする場合は [http://www.clearsilver.net/ ClearSilver] が必要です。 
     27 
     28=== SQLiteの場合 === #ForSQLite 
     29 
     30 * [http://www.sqlite.org/ SQLite] 3.3.4 以上を推奨します。 
     31 * 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] を参照してください。 (訳注: Python-2.5 には PySQLite2 (つまり SQLite3 向け) のライブラリが同梱されています) 
     32 
     33''Note: 'contrib/trac-post-commit-hook' を使用する場合、 Trac は 0.9 以降、 PySQLite は 2.x が必要です。 
     34 
     35''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) を使用するのがおそらく最も良いでしょう。'' 
     36 
     37=== PostgreSQLの場合 === #ForPostgreSQL 
     38 
     39 * [http://www.postgresql.org/ PostgreSQL] 
     40 * [http://initd.org/projects/psycopg2 psycopg2] または [http://pypgsql.sourceforge.net/ pyPgSQL] 
     41 
     42'''Warning''': PostgreSQL 8.3 は厳密な型チェックメカニズムを採用しています。 Trac で PostgreSQL の バージョン 8.3 を使用するには、 [http://trac.edgewall.org/changeset/6512 trac-0.11] 以降でなければなりません。 
     43 
     44=== MySQLの場合 === #ForMySQL 
     45 
     46'''Warning''': MySQL のサポートは今のところ ''まだ'' 実験段階です。 環境によっては動作しますが、特に unicode の使用と、リポジトリキャッシュのキー長に関して、いくつかの問題が残っています。より詳細な情報は [http://trac.edgewall.org/wiki/MySqlDb MySqlDb] を参照してください。 
     47 
     48 * [http://mysql.com/ MySQL] 4.1 以上 
     49 * [http://sf.net/projects/mysql-python MySQLdb] 1.2.1 以上 
     50 
     51=== 任意の条件 === #OptionalRequirements 
     52 
     53==== バージョン管理システム ==== #VersionControlSystem 
     54 
     55'''Please note:''' Subversion を使用するなら Trac を同じマシンにインストールする必要があります。リモートリポジトリは現在サポートされていません。 
     56 
     57 * [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] を参照してください。 
     58   * 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 バインディングと混同されることがあります)。 
     59   * SWIG バインディングを含まない Subversion が既にインストールされている場合、 Unix であれば `make swig-py` と `make install-swig-py` による Subversion の再構成が必要です。 
     60   * Win32 の場合、 [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 pre-compiled bindings] から取得してください。 
     61 * サードパーティから他のバージョン管理システムのサポートが提供されています。 [http://trac.edgewal.org/wiki/PluginList PluginList] と [http://trac.edgewall.org/wiki/VersioningSystemBackend VersioningSystemBackend] を参照してください。 
     62 
     63==== Web サーバ ==== #WebServer 
     64 * CGI が利用可能なウェブサーバ (TracCgi を参照してください) または 
     65 * [http://www.fastcgi.com/ FastCGI] が利用可能なウェブサーバ (TracFastCgi を参照してください) または 
     66 * [http://httpd.apache.org/ Apache] と [http://code.google.com/p/modwsgi/ mod_wsgi] ([http://trac.edgewall.org/wiki/TracModWSGI TracModWSGI] を参照してください) 
     67    * mod_wsgi は非常に新しく、いくらか実験的ですが、これは Apache 1.3, 2.0 または 2.2 で動作するはずで、 mod_python を使用するよりも良いパフォーマンスが出るはずです。 
     68 * [http://httpd.apache.org/ Apache] と [http://www.modpython.org/ mod_python 3.1.3 以降] (TracModPython を参照してください) 
     69    * mod_python をインストールするときは、開発向けの Python と Apache が必須になります (実際にはライブラリとヘッダファイル) 。 
     70 
     71Trac を Apache と [http://www.modpython.org/ mod_python 2.7] で動かすことも可能です。([http://trac.edgewall.org/wiki/TracModPython2.7 TracModPython2.7] を参照してください) 。このガイドは 0.8.4 以降更新されていないので動作が異なるかもしれません。 
     72 
     73==== その他の Python ユーティリティ ==== #OtherPythonUtilities 
     74 * WikiRestructuredText は [http://docutils.sourceforge.net/ docutils] 0.3.9 以降が必要です。 
     75 * [wiki:TracSyntaxColoring シンタックスハイライト] は [http://pygments.pocoo.org Pygments] が必要です。また [http://silvercity.sourceforge.net/ SilverCity], [http://gnu.org/software/enscript/enscript.html Enscript] も、まだ使用できます。 
     76    * !SilverCity0.9.6 には Trac の Python 向けシンタックスハイライトを壊す [http://sourceforge.net/tracker/index.php?func=detail&aid=1424436&group_id=45693&atid=443739 バグ] があるのに注意してください。更新プログラムが利用可能になるまで 0.9.5 を使用することを推奨します。 
     77 * [http://pytz.sf.net pytz] からタイムゾーンの完全なリストを取得します。 pytz を使用しなければ Trac は内部実装された短いリストを使用します。 
     78 
     79'''Attention''': これらの依存関係は様々なバージョンで必ずしも置き換えできるとは限らないので、上記のバージョン番号に注意してください。 Trac を動かす上で問題が発生した場合は [http://trac.edgewall.org/wiki/MailingList メーリングリスト] や [http://trac.edgewall.org/wiki/IrcChannel IRC チャネル] で質問をする前にすべての依存関係を再度確認してください。 
     80 
     81これらのパッケージのドキュメンテーションを参照して、それらが最も上手にインストールできる方法を探してください。また [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] の多くに、これらの依存関係のインストール方法が記述されています。しかしながら [http://trac.edgewall.org/wiki/TracInstallPlatforms プラットフォーム特有の説明] の情報はあなたがインストールしている Trac より古い バージョンについての説明があることを覚えておいてください (なんと Trac-0.8 に関する説明をしているページもあります)。 
     82 
     83== Tracのインストール == #InstallingTrac 
     84 
     85Trac をインストールする 1 つの方法は `setuptools` を使用することです。 
     86setuptools は subversion のリポジトリから Trac をインストールすることができます; 
     870.11b2 のリリースバージョンをインストールするための例を以下に示します: 
     88{{{ 
     89easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11b2 
     90}}} 
     91 
     92もちろん、ソースディレクトリのトップでの典型的な python セットアップもできます: 
     93{{{ 
     94$ python ./setup.py install 
     95}}} 
     96 
     97''Note: このステップを実行するためには root 権限 (または root 権限と同等の権限) が必要です。'' 
     98 
     99この操作で Python のソースコードがバイトコンパイルされ、 .egg ファイルかディレクトリが Python インストールの `site-packages` ディレクトリにインストールされます。 
     100.egg には htdocs や templates のような、ソースファイル以外に標準インストールの Trac が必要とするすべてのリソースが含まれています。 
     101 
     102このスクリプトは [wiki:TracStandalone tracd] スタンドアロンサーバと一緒に、 [wiki:TracEnvironment プロジェクト Environment] を作成し維持するための [wiki:TracAdmin trac-admin] コマンドラインツールをインストールします。 
     103 
     104=== 高度なオプション === #AdvancedOptions 
     105 
     106Trac のインストール場所を変えるなどの高度なインストールオプションを知りたければ以下を実行してください: 
     107{{{ 
     108easy_install --help 
     109}}} 
     110 
     111詳細な情報は [http://docs.python.org/inst/inst.html Python モジュールをインストールする] を参照してください。 
     112 
     113特にあなたは以下に興味を持つかもしれません: 
     114{{{ 
     115easy_install --prefix=/path/to/installdir 
     116}}} 
     117Mac OS X に Trac をインストールする場合: 
     118{{{ 
     119easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages 
     120}}} 
     121 
     122上記の例は、 `tracd` と `trac-admin` コマンドを `/usr/local/bin` に、 Trac のライブラリと依存ファイルを `/Library/Python/2.5/site-packages` にインストールします。これらのパスは Apple での Pyhton サードパーティアプリケーションの標準ロケーションです。(訳注: つまり、上記と違うパスにインストールしたい場合のみ、オプションの指定が必要になります) 
     123 
     124== プロジェクト Environment の作成 == #CreatingaProjectEnvironment 
     125 
     126[wiki:TracEnvironment Trac Environment] は Trac が Wiki ページ、チケット、レポート、設定などの情報を保存するバックエンドストレージです。基本的に人間が読み込み可能な構成ファイルと他の様々なファイルやディレクトリで構成されます。 
     127 
     128新しい環境は [wiki:TracAdmin trac-admin] を使用して作成します: 
     129{{{ 
     130$ trac-admin /path/to/myproject initenv 
     131}}} 
     132 
     133[wiki:TracAdmin trac-admin] はプロジェクト名、 [wiki:TracEnvironment#SourceCodeRepository ソースコードのリポジトリ] のタイプとパス、 [wiki:TracEnvironment#DatabaseConnectionStrings データベース接続文字列] など、 Environment を作成するのに必要な情報の入力を促します。これらのオプションを指定せず、空白を入力するとデフォルト値が使用されます。 SQLite がインストールされている場合、データベース接続文字列はいつでもデフォルト値で動作します。バージョン管理システムのリポジトリへのパスを指定しない場合、バージョン管理に関するすべての機能が無効化されますが、基本システムが動いていればいつでもバージョン管理に関する機能を追加することができます。 
     134 
     135また、 ここで指定した値は [wiki:TracIni] 設定ファイルを直接編集することで後から変更できることに留意してください。 
     136 
     137''Note: Web サーバのユーザアカウントは Environment のディレクトリと、その中のすべてのファイルに対する書き込み権限が必要です。 Linux では、 Web サーバが apache というユーザ、 apache というグループで起動している場合は以下のように入力してください。:'' 
     138 
     139  chown -R apache.apache /path/to/myproject 
     140 
     141 
     142== スタンドアロンサーバの起動 == #RunningtheStandaloneServer 
     143 
     144Trac 環境を作成した後に、スタンドアロンサーバ [wiki:TracStandalone tracd] を実行することで簡単に Web インタフェースを試すことができます。 
     145{{{ 
     146$ tracd --port 8000 /path/to/myproject 
     147}}} 
     148 
     149ブラウザを起動して、 `http://localhost:8000/` にアクセスしてください。 tracd が認識しているすべての Environment の簡単な一覧が表示されます。作成した Environment へのリンクにアクセスすることで Trac が動作中であることを確認できます。 Trac でプロジェクトをひとつだけ管理したい場合、以下のように起動することで、スタンドアロンサーバは Environment 一覧の表示をスキップして、直接 Environment を表示します: 
     150{{{ 
     151$ tracd -s --port 8000 /path/to/myproject 
     152}}} 
     153 
     154 
     155== Web サーバ上での Trac の起動 == #RunningTraconaWebServer 
     156 
     157Trac に "真の" Web サーバから接続するには 3 つの方法があります: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI], [wiki:TracModPython mod_python] です。まともな性能を出すには FastCGI か mod_python のどちらかを使用することが推奨されます。 
     158 
     159また、開発コードを実行することを恐れていないのであれば mod_wsgi を実行してみることもできます。 mod_wsgi は mod_python 以上の性能を提供するはずですが、安定した動作をするかは分かりません。 
     160 
     161== 認証の構成 == #ConfiguringAuthentication 
     162 
     163認証のためのユーザアカウントを追加、削除、構成する方法は Trac を起動する方法により異なります。基本的な手順は TracCgi ページの [wiki:TracCgi#AddingAuthentication "認証を追加する"] セクションで説明されていますが、各フロントエンドのための認証をセットアップする方法は、以下のいずれかを参照してください: 
     164 
     165 * TracStandalone スタンドアロンサーバ `tracd` を使用する場合 
     166 * TracCgi CGI か FastCGI を使用する場合 
     167 * TracModPython mod_python を使用する場合 
     168 
     169== Trac 0.11 と SVN を Mac OS X Leopard (10.5) で使用する == #Trac0.11SVNonMacOSXLeopard10.5 
     170 
     171 * [http://trac.edgewall.org/wiki/TracOnLeopardServer TracOnLeopardServer] 
     172 
     173== Tracを使用する == #UsingTrac 
     174 
     175一度 Trac サイトを稼働させれば、 Subversion のリポジトリをブラウズする、チケットを作成する、タイムラインを見るなどが可能になるはずです。 
     176 
     177anonymous (ログインしていない) でアクセスするユーザは、デフォルトでほとんどの機能を使用することができますが、すべての機能を使用できるわけではないことに留意してください。すべての機能を使用するためには認証を構成して、認証されたユーザに対し [wiki:TracPermissions アクセス許可] を与える必要があるでしょう。 
     178 
     179'' Enjoy! '' 
     180 
     181[http://trac.edgewall.org/wiki/TracTeam The Trac Team] 
     182 
     183---- 
     184See also:  TracGuide, TracCgi, TracFastCgi, TracModPython, [http://trac.edgewall.org/wiki/TracModWSGI TracModWSGI], TracUpgrade, TracPermissions 
     185