= アップグレードの説明 = #UpgradeInstructions
[[TracGuideToc]]

[TracEnvironment Trac Environment] をアップグレードする前に Trac-0.11 が使用可能になっている必要があります。このドキュメントでは TracEnvironment をアップグレードするのに必要な手順を説明します。

特に指示がない限り、マイナーバージョンのリリース時には TracEnvironment のアップグレードは必要ありません。

== 一般的な手順 == #Instructions

通常、 Trac を新しいバージョンにアップグレードするときに、 4 ステップを踏まなければなりません:

=== Trac のコードを更新する === #UpdatetheTracCode

TracInstall または、あなたの OS に合った方法で新しいバージョンの Trac を取得してください。

手で (OS 特有でない) アップグレードをするのであれば、インストールを実行する前に起動中の Trac サーバを停止してください。 "ホット" アップグレードは問題を生じることが多いです。特に Windows では出来ないと考えてください ([http://trac.edgewall.org/ticket/7265 #7265])。

すでに存在する Trac のコードを削除するには、 Python の `lib/site-packages` ディレクトリから `trac` ディレクトリか、 Trac の .egg の古いバージョンを削除します。
site-packages ディレクトリの位置は OS のシステム、および Python のインストールパスにより異なりますが、一般的には以下の位置にあります:
 * Linux を使用している場合: /usr/lib/python2.X/site-packages
 * Windows を使用している場合: C:\Python2.X\lib\site-packages
 * MacOSX を使用している場合: /Library/Python/2.X/site-packages

また、 `share/trac` (正確な位置はプラットフォームに依存しますが一般的にはこの位置です。) ディレクトリ内の `cgi-bin`, `htdocs`, `templates`, `wiki-default` といったディレクトリを削除してもかまいません。 (訳注: 0.11 では、これらのディレクトリは `site-packages/trac` の配下に移動しています)

このクリーンアップは必須ではありませんが、あとでトラブルシュートを行う場合の切り分けが容易になります。すでに使われていない前のリリースのコードやテンプレートを見るなどという時間の浪費をしたくないのであれば、削除しておく方が楽です。もちろん、ファイルを削除する前にバックアップを作成する方が良いでしょう。

webadmin plugin をインストールしていた場合は、アンインストールしてください。今や webadmin plugin は Trac コードベースの一部です。

=== TracEnvironment をアップグレードする === #UpgradetheTracEnvironment

アップグレードした Trac がロードされると、アップグレードする必要があるインスタンスが表示されます。アップグレードはオートメーションされたスクリプトを手で実行します。これらのスクリプトでは [TracAdmin trac-admin] を使用します。
{{{
trac-admin /path/to/projenv upgrade
}}}

このコマンドはもし TracEnvironment がすでに最新の状態になっているときは、何もしません。

Note: PostgreSQL データベース (訳注: MySQL も) を使用している場合、このコマンドは「 Environment のバックアップは SQLite を使っているときしか出来ない」というメッセージを出力して失敗します。リポジトリとデータベースのバックアップは手動で行う必要があります。その後、アップグレードを行うために次のコマンドを実行してください:
{{{
trac-admin /path/to/projenv upgrade --no-backup
}}}

カスタム CSS スタイルを使用していたり、 TracEnvironment の templates ディレクトリテンプレートを変更している場合、 Genshi のやり方にコンバートする必要があります。スタイルシートを使用し続けたい場合、 TracInterfaceCustomization#SiteAppearance の手順を読んでください。

=== Trac ドキュメントを更新する === #UpdatetheTracDocumentation

すべての [TracEnvironment Trac Environment] で、インストールされたバージョンの Trac ドキュメントのコピーを含んでいます。新しくインスト