Changes between Initial Version and Version 1 of TracUpgrade

Timestamp:

06/11/06 17:57:32 (18 years ago)

Author:

trac

Comment:

--

TracUpgrade

@@ +1 @@
+= アップグレードの説明 =
+[[TracGuideToc]]
+
+Trac を新しいバージョンで使用する前に Trac Environment をアップグレードしなければならない場合があります。このドキュメントでは Trac Environment をアップグレードするのに必要な手順を説明します。
+
+ '''Note''': ''特に指示がない限り、マイナーバージョンのリリース時には TracEnvironment のアップグレードは必要ありません。例えば、0.8.0で作成した（もしくはそれ以前のバージョンからアップグレードした）TracEnvironment を 0.8.4（もしくは0.8.x）インストール時にアップグレードする必要はありません。''
+
+== 一般的な手順 ==
+
+通常、Tracを新しいバージョンにアップグレードするときに、4ステップを踏まなければなりません:
+
+=== Trac のコードを更新する ===
+
+Trac の新しいバージョンを入手してください。オフィシャルリリースのパッケージをダウンロードするかもしくは [http://projects.edgewall.com/trac/wiki/SubversionRepository Subversionリポジトリ] からチェックアウトして下さい。
+
+ソースコードを入手したら、以下のコマンドを実行して下さい。
+{{{
+python setup.py install
+}}}
+
+新しいバージョンをインストールするコマンドです。もし、Windows インストーラバージョンをダウンロードしたならば、インストーラを実行するなどして下さい。
+
+どのような場合でも、メジャーバージョンをアップグレードする場合 (0.8 から 0.9 にアップグレードするなど) 最初に今現在、存在している Trac のコードを削除することを''特に'' お勧めします。削除するには、 `trac` のディレクトリを Python の `lib/site-packages` ディレクトリから削除します。もし Trac `cgi-bin`, `htdocs`, `templates` ディレクトリも削除したいならば、それらは `share/trac` というディレクトリの中で見つかるでしょう。(正確なロケーションはプラットフォームに依存します)
+
+=== TracEnvironment をアップグレードする ===
+
+指示がない限り、メジャーバージョンをアップグレードする (例えば 0.8 から 0.9) ときは、データベーススキーマの変更と、おそらく [wiki:TracEnvironment TracEnvironmentのディレクトリ] 構成の変更が生じます。幸運なことに Trac は自動アップデートのスクリプトを提供しているので、負担が軽減されるでしょう。これらのスクリプトは [wiki:TracAdmin trac-admin] を通して起動されます:
+{{{
+trac-admin /path/to/projenv upgrade
+}}}
+
+このコマンドはもし TracEnvironment がすでに最新の状態になっているときは、何もしません。
+
+Note: PostgreSQL データベースを使用している場合、このコマンドは「 Environment のバックアップは SQLite を使っているときしか出来ない」というメッセージを出力して失敗します。リポジトリとデータベースのバックアップは手動で行う必要があります。その後、アップグレードを行うために次のコマンドを実行してください:
+{{{
+trac-admin /path/to/projenv upgrade --no-backup
+}}}
+
+=== Trac ドキュメントを更新する ===
+
+すべての [wiki:TracEnvironment Tracenvironment] インストールされたバージョンの Trac ドキュメントのコピーを含んでいます。新しくインストールした Trac のドキュメントと同期を取りたいでしょう。 [wiki:TracAdmin trac-admin] がドキュメントを更新するコマンドを提供しています:
+{{{
+trac-admin /path/to/projenv wiki upgrade
+}}}
+
+このプロシージャは `WikiStart` ページをそのままにしておくことを気に留めておいてください。
+
+=== Web サーバを再起動する ===
+
+新しい Trac コードをリロードするために、 Web サーバを再起動する必要があります。 (古い [wiki:TracCgi CGI] プログラムを使用しているときは必要ありません。)
+
+== 特定のバージョン間のアップグレードについての付記 ==
+
+以下のセクションでは Trac の特定のバージョンにアップグレードするときにやらなければならないことについて記述します。
+
+== 0.9-beta から 0.9 へのアップグレード ==
+
+静的リソース (CSS, javascript, 画像ファイル) のインクルードは機能しません。 trac.ini の `htdocs_location` を確認してください。 [wiki:TracModPython mod_python], [wiki:TracStandalone Tracd], [wiki:TracFastCgi FastCGI] を使用している場合、単にオプションを削除してください。 [wiki:TracCgi CGI] を使用している場合、Trac の `htdocs` ディレクトリへの URL マップを修正しなければいけません (以前の記述を削除し、 [wiki:TracCgi#静的なリソースをマッピングする 静的なリソースをマッピングする])。オプションを削除した後でも問題が残っている場合、ファイル `trac/siteconfig.py` のパスを確認し、誤っていれば修正してください。
+
+Trac 0.9 のベータリリースでプラグインを使用しているか、組み込みコンポーネントの無効化を行っていたら、 [wiki:TracIni trac.ini] でコンポーネントの無効化 / 有効化のルールを更新しなければならないかもしれません。特にグローバルにインストールされたプラグインは、現在では明示的に有効化する必要があります。詳しくは TracPlugins と TracIni を参照して下さい。
+
+タイムラインでチケットの全ての更新を表示させたい ("チケットの詳細" オプション) 場合も、 [wiki:TracIni trac.ini] での明示的な有効化が必要です:
+
+{{{
+[timeline]
+ticket_show_details = true
+}}}
+
+== 0.8.x から 0.9 へのアップグレード ==
+
+[wiki:TracModPython mod_python] を使用している場合は Apache HTTPD の設定で mod_python ハンドラの名前を変更する必要があります:
+{{{
+   from: PythonHandler trac.ModPythonHandler
+   to:   PythonHandler trac.web.modpython_frontend
+}}}
+
+[http://initd.org/tracker/pysqlite PySQLite] の 2.x がインストールされているなら、注意してください。今や Trac は SQLite 3.x のファイルフォーマットで 2.x のデータベースを開こうとします。 SQLite 2.8.x と 3.x のデータベースのフォーマットに互換性がありません。もしアップデート後に ''"file is encrypted or is not a database"'' といったエラーが出力されたら、データベースファイルを 3.x 形式に変換しなければなりません。
+
+もし変換を行うならば、 SQLite の 2.8.x と 3.x の両方をインストールする必要があります (バージョンごとにファイル名が異なるので、同じシステム内に共存できます)。以下に示すコマンドを使用して下さい:
+{{{
+ $ mv trac.db trac2.db
+ $ sqlite trac2.db .dump | sqlite3 trac.db
+}}}
+
+変換が成功した後、 `trac2.db` ファイルは削除することができます。 SQLite のアップグレードに関するより詳しい情報は [http://www.sqlite.org/version3.html] を参照して下さい。
+
+== 0.7 から 0.8 へのアップグレード ==
+
+0.8では追加のパーミッションを必要とする新しい機能が加わりました。
+新規にインストールを行なった場合は、 anonymous に ROADMAP_VIEW と MAILSTONE_VIEW パーミッションがデフォルトで与えられますが、
+既存のtrac をアップグレードしたときは、
+これらのパーミッションを手動で与えなければなりません。:
+{{{
+ $ trac-admin /path/to/projectenv permission add anonymous MILESTONE_VIEW
+ $ trac-admin /path/to/projectenv permission add anonymous ROADMAP_VIEW
+}}}
+
+-----
+See also: TracGuide, TracInstall