All-In-One Tracとは

Tracとは、Pythonで実装されたプロジェクト管理ツールで、以下のような機能があります。

Wikiによるプロジェクト内の情報共有
Subversionとの連携
要件管理（Issue Tracking）機能
更新履歴（タイムライン）や要件一覧のRSS配信機能

しかし、Tracをインストールするためにはいろいろなツールをインストール必要があり、手軽に試すことができませんでした。

All-In-One TracではTracの実行に必要なほぼすべてのツールをひとまとめにしてインストールできるようにしました。

All-In-One Tracの提供する機能

All-In-One TracではTracのもともとの機能に追加して以下の機能を提供しています。

Apacheの.htaccessを利用してTracの認証とSubversionの認証を一括に行う機能
Apache/Trac/Subversionのコマンドを使いやすくラップしたコマンド群の提供
インターネットに接続できない環境でもダウンロードできる様、Subversionを利用するためのクライアントソフト（TortoiseSVN/Subclipse/Ankhsvn）を梱包
インターネットに接続できない環境でもSubversionの使い方をすぐに調べられる様、Subversionによるバージョン管理を梱包

動作環境

All-In-One Tracは現在の所、WindowsXP上でのみ動作を確認しています。また、インストール時にWindows Scripting Host(WSH)を利用しているので、 WSHが無い環境ではインストールすることができません。（これはAll-In-One Tracの制限で、TracやSubversion、Apacheの制限ではありません）

All-In-One Tracに含まれるツール群

ツールの名前	バージョン
Trac-ja	v0.9.4
Subversion	v1.3.0
Apache	v2.0.54
Python	v2.3.5
Python bindings for Subversion 1.3.0 on Win32	v2.3用
Clearsilver	v0.9.12
PySQLite	v1.1.6.win32-py2.3
docutils	v0.3.9
JapaneseCodecs	v1.4.11
CilverCity	v0.9.6
diffutils	v2.8.7
regex	v0.12

Tracのマルチプロジェクト対応

プロジェクトIDとは

All-In-One TracはTracのマルチプロジェクトに対応しています。 All-In-One Tracではプロジェクト情報を識別するために、プロジェクトIDを各プロジェクト情報に付加しています。

インストール時に作成されるプロジェクトのプロジェクトIDはdefaultです。プロジェクトIDはプロジェクト情報を格納するフォルダの名前や、Tracにアクセスする際のURLなどに利用されています。そのためプロジェクトIDにはアルファベットと数字以外使用しないようにしてください。

プロジェクトの作成方法

All-In-One Tracで新しくプロジェクトを作成する場合、以下のコマンドを実行してください。

cd [All-In-One Tracのインストールディレクトリ]/admin/trac
create-trac-env.bat プロジェクト名称（日本語可） プロジェクトID

コマンドが成功すると、新たにSubversionリポジトリとtrac-envが作成されます。 http://インストールしたPC名:指定したポート番号/ にアクセスすると新しく作成したプロジェクトのリンクが表示されるので、クリックしてください。新しいプロジェクトに対するTracが表示されます。

制限事項

現在の所、各プロジェクトで利用できるユーザ名とパスワードは共有されます。

All-In-One Tracのサービス化手順

All-In-One Tracはインストールしてすぐ利用できること、できるだけ多くの環境で利用できること、をモットーとしているため、Trac（Apache）の起動はスタートアップからのコマンドライン起動になっています。

しかし、タスクバーにコマンドプロンプトが表示されるのが邪魔だったり、複数人で利用する場合に、いちいちログインする必要があったりと、少し面倒な部分もあります。

そういった場合に、All-In-One Tracで利用しているApacheをWindowsのサービスに登録することで問題が解決します。

手順

条件

Apacheのサービス化を行うにはシステム環境変数を設定や、サービスの登録を行える権限が必要です。（Administrator権限など）

事前準備

以降の操作を行う前に、コマンドラインで起動しているAll-In-One Tracは終了させおいてください。

環境件数の確認

まずはAll-In-One Tracをインストールしたフォルダに移動して、apache_start.batをテキストエディタ（notepadなど）で開いてください。このファイルに以下の環境変数が記述されています。

PYTHONHOME

pythonのホームディレクトリ（変数名にも意味あり）

SVN_HOME

Subversionのホームディレクトリ

APR_ICONV_PATH

APRを探す際のパス（変数名にも意味あり）

DIFFUTILS_HOME

diffutilsのホームディレクトリ

また、環境変数PATHに上記の環境変数を使用して以下のように値が追加されています。

set PATH=%PATH%;%PYTHONHOME%;%SVN_HOME%\bin;%DIFFUTILS_HOME%\bin;

システム環境変数の設定

コントロールパネル - システムを選択（またはマイコンピュータを選択して右クリック－プロパティを選択）してシステムのプロパティを表示します。
詳細設計タブを選択し、下のほうにある環境設定(N)ボタンを押下し環境変数ダイアログを表示させてください。
システム環境変数（ユーザ環境変数ではないので注意）の新規(W)ボタンを押して新しいシステム変数ダイアログを表示させてください。
変数名(N)と変数値(V)にそれぞれapache_start.batで確認した環境変数（PYTHONHOME/SVN_HOME/APR_ICONV_PATH/DIFFUTILS_HOME）とその値を設定してください。
環境変数PATHを選択し編集(I)ボタンを押下して、システム変数の編集ダイアログを表示させてください。
表示された変数値(V)の最後にapache_start.batで確認したPATHの追加部分（%PYTHONHOME%;%SVN_HOME%\bin;%DIFFUTILS_HOME%\bin;）を追加します。
各ダイアログのOKボタンを押してシステムのプロパティを閉じてください。

コマンドプロンプトを開き、

set（リターン）

と入力して、環境変数の一覧を表示させ、先ほど設定した環境変数が設定されていることを確認してください。

Apacheのサービス登録

All-In-One Tracのインストールフォルダの下のapacheフォルダの中に、install_service.batというバッチファイルがあるので、ダブルクリック、または、コマンドプロンプトから実行してください。Apacheがサービスとして登録されます。

サービスの設定

コントロールパネル－管理ツール－サービスを選択し、　サービスウィンドウを表示させてください。サービスの中にApache2という名前のサービスがあるので以下の内容を確認してください。

状態開始

スタートアップの種類自動

もし、上記のようになっていない場合は、Apache2のプロパティを表示させ、設定を変更してください。

動作確認

PCを再起動した後、All-In-One Tracのコマンドプロンプトがスタートアップで立ち上がるようであれば、終了させてください。その後、All-In-One Tracにアクセスできることを確認してください。Tracの画面が表示されればOKです。後処理

All-In-One Tracのサービスが正常に動作していることを確認した後、スタート－すべてのプログラム(P) －スタートアップを選択し、表示されるサブメニューからtracの起動.lnkを削除して、ログオン時にAll-In-One Tracがコマンドラインから起動しないようにしてください。

その他

サービス化を行った後、All-In-One Tracにアクセスした際に500 Server Errorが発生する場合は、システム環境変数に設定したPYTHONHOMEがサービスからうまく参照できていないことが原因です。この場合はPCを再起動してシステム環境変数を正しく反映させてください。サーバーなどで再起動ができない場合はBBS-Tracご意見・ご質問掲示板/20でdomblyさんがとられたように、管理者権限のあるユーザでサービスを実行するように設定してみてください。

All-In-One Project