• Showing Page History #2915

インストール

新規インストール

TracLight-x.x.exeをクリックして実行するだけです。インストール終了後、コンピュータを再起動してください。再起動後、プログラムメニューのTracから「サービスとして実行」もしくは、「コマンドプロンプトから実行」を選択すると、Apacheが起動します。 http://localhost/にアクセスして動作を確認してください。

Trac月はデフォルトで80番と8980番のポートを利用します。インストール時の注意として、IISやApache等のWebサーバが起動していないことを確認してください。起動している場合は、停止もしくはアンインストールしておいてください。Trac月をインストールするとマシンを再起動するので再起動後、インストール済みのIISやApacheが自動的に起動しないようにしておく必要があります。また、PythonやSubversionを既にインストールされている場合、これらのアプリケーションの環境が変更されるので注意してください。分からない場合は、PythonやSubversionをコントロールパネルのプログラムの追加と削除からアンインストールしておくことをお勧めしておきます (プログラムの追加と削除に表示されていない場合はアンインストールする必要はありません)。

バージョンアップ

旧バージョンのTracからバージョンアップするには、インストール中のダイアログで「 httpd.confを上書きしない」を選択します。インストール後、trac-adminでtracのプロジェクトをupgradeします。例えば、SampleProjectをupgradeするには、次のようにします。

> trac-admin.bat C:\TracLight\project\trac\SampleProject upgrade

All In One Tracからの移行

All In One Tracを既にお扱いの方は、ここの手順に従い移行してください。All In One TracからTrac月へ移行時のポイントは次の通りです。

  • ディレクトリ構成が異なる
  • Trac月はHTTPの認証にDigest認証を利用しているが、All In One TracはBasic認証である。
  • Trac月はtrac0.10を採用しているが、All In One Tracは0.9(trac-admin upgradeが必要)
  • All In One Tracはpython2.3だが、Trac月はpython2.4(キャラクタセットの名前が異なる)

このポイントを抑えておけば、それほど難しくありません。まず最初に、 All In One Tracのプロジェクトのファイルをコピーします。All In One Tracのデフォルトプロジェクトの例で示すと下記の通りとなります。

コピー元コピー先説明
C:\trac-0.1.1\trac_repo\projects\defaultC:\TracLight\projects\trac\defaulttracのリポジトリ
C:\trac-0.1.1\svn_repo\projects\defaultC:\TracLight\projects\svn\defaultSVNリポジトリ
C:\trac-0.1.1\svn_repo\projects\trac.htpasswdC:\TracLight\projectsパスワードファイル

tracのtrac.iniファイル(projects\trac\default\conf\trac.ini)を次のように変更します。

...
#default_charset = japanese.ms932   変更前
default_charset = cp932             変更後
...
#templates_dir = C:\trac-0.1.1\python\share\trac\templates 変更前
templates_dir = C:\TracLight\python\share\trac\templates   変更後
...
#repository_dir = C:\trac-0.1.1\svn_repo\projects\default  変更前
repository_dir =C:\TracLight\projects\svn\default         変更後
...
# 以下追加
[account-manager]
password_format = htpasswd
password_store = HtPasswdStore
password_file = C:/TracLight/projects/trac.htpasswd

プログラムメニューの「Trac」->「コマンドプロンプト」でコマンドプロンプトを起動し、次のようにして、Tracのデータベースのアップグレード、SVNリポジトリとの再同期、htpasswdファイルのコピーを行います。

trac-admin.bat C:\TracLight\projects\trac\default upgrade trac-admin.bat C:\TracLight\projects\trac\default resync

Apacheの設定(httpd.conf)をBasic認証を利用するように変更します。

...
  AuthType Digest
  AuthName trac
  AuthDigestFile "C:\TracLight\projects\trac.htdigest"
...
↓ ...
  AuthType Basic
  AuthName trac
  AuthDigestFile "C:\TracLight\projects\trac.htpasswd"
...
上記の設定はhttpd.conf内に2箇所あるので、注意してください。

Apacheのサービスを再起動します。他にもプロジェクトがある場合は、同等の手順で移行します。