TracLightning3.xからTracLightning4.xへのアップグレードの注意

TracLightning4.0.0からは以前のバージョンからTracとPythonがバージョンアップになっています。そのため、従来のTracLightningに上書きインストールしても正しく動作しない場合があります。基本的には、スクラッチからインストールしてください。そうは言っても新しいTracLightningへ古いプロジェクトを移行したい方も居るでしょう。そんな人のために非公式ドキュメントとしてプロジェクトのアップグレード方法を解説します。

アップデート時の注意

projectsディレクトリのバックアップを取っておいて、新しいTracをインストール後、バックアップしたprojectsディレクトリを基に戻します。
その後、Tracにアクセスした際に表示されるメッセージに基づきDBとWikiのUpgradeを行ってください。

アップデートの手順

1.最新のデータで移行する場合は[スタート]メニューから[Trac]-[バックアップ]をクリックしてバックアップをとって下さい。


2.バックアップが完了したら、インストールフォルダの[back]を開きます。デフォルトは C:\TracLight\backup になります。
backupフォルダの最新フォルダ（手順1でバックアップしていれば今日の日付になっています）をCドライブの直下やデスクトップなどにコピーします。


3.[コントロールパネル]-[プログラムと機能]をクリックします。Trac Lightning 3.xを選択してアンインストールします。
Windowsを再起動して下さい。


4.Windows起動後にインストールフォルダを削除、またはリネームします。デフォルトは C:\TracLight になります。


5.TracLightning4.xのインストーラーをダブルクリックして、インストールして下さい。
なお、インストールフォルダはTrac Lightning 3.xと同じ設定にして下さい。デフォルトは C:\TracLight になります。


6.バックアップした認証関係のファイル svnauthz 、trac.htdigest を C:\TracLight に上書きコピーします。


7.[backup] - [trac]にある移行対象のプロジェクトフォルダを C:\TracLight\project\trac にコピーします。
SampleProjectフォルダは設定の確認用に移行しないことを推奨します。


8.[backup] - [svn]にある移行対象のバージョン管理フォルダを C:\TracLight\project\svn にコピーします。


9.[スタート]メニューから[Trac]-[コマンドプロンプト]をクリックします。プロジェクトのアップグレードコマンドを実行します。

trac-admin  C:\TracLight\project\trac\プロジェクト名 upgrade 

例えば、プロジェクト名が trac-demo の場合は下記のように

trac-admin  C:\TracLight\project\trac\trac-demo upgrade

となります。


10.エラーが表示されなかった場合、Wikiのアップグレードが促されます。下記のようにコマンドを実行します。

trac-admin  C:\TracLight\project\trac\プロジェクト名 wiki upgrade 

プロジェクト名が trac-demo の場合は

trac-admin  C:\TracLight\project\trac\trac-demo wiki upgrade

となります。


11.問題なければTracサイトにプロジェクト名が表示されます。


12.問題なくTrac Lightning 4.0にデータが移行できているか確認して下さい。

上手くいかない場合

プラグインが正しく動作しない

新Tracでプラグインが正しくオンになっていない場合はTracの管理から各プラグインをオンにして下さい。 例えば、下図のようにプラグインの項目が表示されていない場合はiniadminプラグインがオンになっているか確認して下さい。