= !TracLightning3.xから!TracLightning4.xへのアップグレードの注意 =
!TracLightning4.0.0からは以前のバージョンからTracとPythonがバージョンアップになっています。そのため、従来のTracLightningに上書きインストールしても正しく動作しない場合があります。基本的には、スクラッチからインストールしてください。そうは言っても新しいTracLightningへ古いプロジェクトを移行したい方も居るでしょう。そんな人のために'''非公式'''ドキュメントとしてプロジェクトのアップグレード方法を解説します。
== アップデート時の注意 ==
projectsディレクトリのバックアップを取っておいて、新しいTracをインストール後、バックアップしたprojectsディレクトリを基に戻します。[[BR]]
その後、Tracにアクセスした際に表示されるメッセージに基づきDBとWikiのUpgradeを行ってください。
== アップデートの手順 ==
1.最新のデータで移行する場合は![スタート]メニューから![Trac]-![バックアップ]をクリックしてバックアップをとって下さい。[[br]]
[[Thumb(01.png)]]
[[br]][[br]]
2.バックアップが完了したら、インストールフォルダの![back]を開きます。デフォルトは C:\!TracLight\backup になります。[[br]]
backupフォルダの最新フォルダ(手順1でバックアップしていれば今日の日付になっています)をCドライブの直下やデスクトップなどにコピーします。[[br]]
[[Thumb(02.png)]]
[[br]][[br]]
3.![コントロールパネル]-![プログラムと機能]をクリックします。Trac Lightning 3.xを選択してアンインストールします。[[br]]
Windowsを再起動して下さい。[[br]]
[[Thumb(03.png)]]
[[br]][[br]]
4.Windows起動後にインストールフォルダを削除、またはリネームします。デフォルトは C:\!TracLight になります。[[br]]
[[Thumb(04.png)]]
[[br]][[br]]
5.!TracLightning4.xのインストーラーをダブルクリックして、インストールして下さい。[[br]]
なお、インストールフォルダはTrac Lightning 3.xと同じ設定にして下さい。デフォルトは C:\!TracLight になります。[[br]]
[[Thumb(05.png)]]
[[br]][[br]]
6.バックアップした認証関係のファイル svnauthz 、trac.htdigest を C:\!TracLight に上書きコピーします。[[br]]
[[Thumb(06.png)]]
[[br]][[br]]
7.![backup] - ![trac]にある移行対象のプロジェクトフォルダを C:\!TracLight\project\trac にコピーします。[[br]]
SampleProjectフォルダは設定の確認用に移行しないことを推奨します。[[br]]
[[Thumb(07.png)]]
[[br]][[br]]
8.![backup] - ![svn]にある移行対象のバージョン管理フォルダを C:\!TracLight\project\svn にコピーします。[[br]]
[[Thumb(08.png)]]
[[br]][[br]]
9.![スタート]メニューから![Trac]-![コマンドプロンプト]をクリックします。プロジェクトのアップグレードコマンドを実行します。[[br]]
{{{
trac-admin C:\TracLight\project\trac\プロジェクト名 upgrade
}}}
例えば、プロジェクト名が trac-demo の場合は下記のように
{{{
trac-admin C:\TracLight\project\trac\trac-demo upgrade
}}}
となります。[[br]]
[[Thumb(09.png)]]
[[br]][[br]]
10.エラーが表示されなかった場合、Wikiのアップグレードが促されます。下記のようにコマンドを実行します。[[br]]
{{{
trac-admin C:\TracLight\project\trac\プロジェクト名 wiki upgrade
}}}
プロジェクト名が trac-demo の場合は
{{{
trac-admin C:\TracLight\project\trac\trac-demo wiki upgrade
}}}
となります。[[br]]
[[Thumb(10.png)]]
[[br]][[br]]
11.問題なければTracサイトにプロジェクト名が表示されます。[[br]]
[[Thumb(11.png)]]
[[br]][[br]]
12.問題なくTrac Lightning 4.0にデータが移行できているか確認して下さい。[[br]]
[[Thumb(12.png)]] [[Thumb(13.png)]]
== 上手くいかない場合 ==
=== プラグインが正しく動作しない
新Tracでプラグインが正しくオンになっていない場合はTracの[管理]から各プラグインをオンにして下さい。
例えば、下図のようにプラグインの項目が表示されていない場合はiniadminプラグインがオンになっているか確認して下さい。
[[Thumb(14.png)]]