• Showing Page History #3573

Show page source of Install #4847

= インストール =
== 新規インストール ==
[http://sourceforge.jp/frs/index.php?group_id=2810 TracLight-x.x.exe]をクリックして実行するだけです。インストール終了後、コンピュータを再起動してください。再起動後、プログラムメニューのTracから「サービスとして実行」もしくは、「コマンドプロンプトから実行」を選択すると、Apacheが起動します。 http://localhost/にアクセスして動作を確認してください。より詳しく知りたい方は、[http://discypus.jp/wiki/?%A5%BD%A5%D5%A5%C8%2FBug%20Tracking%2Ftrac%2FTrac%B7%EE#content_1_2  discypusさんのサイト]をご覧ください。



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\default||C:\TracLight\projects\trac\default||tracのリポジトリ||
||C:\trac-0.1.1\svn_repo\projects\default||C:\TracLight\projects\svn\default||SVNリポジトリ ||
||C:\trac-0.1.1\svn_repo\projects\trac.htpasswd||C:\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
  AuthUserFile "C:\TracLight\projects\trac.htpasswd"
...
}}}
上記の設定はhttpd.conf内に2箇所あるので、注意してください。

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