Changes between Version 1 and Version 2 of TracUpgrade
- Timestamp:
- Aug 13, 2014, 12:08:17 AM (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracUpgrade
v1 v2 1 1 = アップグレードの説明 = #UpgradeInstructions 2 2 [[TracGuideToc]] 3 [[PageOutline(2-4,,inline,unnumbered)]] 3 4 4 5 == 一般的な手順 == #Instructions 5 6 6 通常、 Trac を新しいバージョンにアップグレードするときに、 5ステップを踏まなければなりません:7 通常、 Trac を新しいバージョンにアップグレードするときに、 7 ステップを踏まなければなりません: 7 8 8 === 1. Trac のコードを更新する === #UpdatetheTracCode 9 === 1. サーバーをオフラインにする === #Bringyourserveroff-line 10 11 サーバー起動中にアップデートを行うのはやめてください。パッケージの一部をメモリにキャッシュしているかもしれませんし、コードのアップデートによって内部エラーを引き起こす可能性があります。 12 13 === 2. Trac のコードを更新する === #UpdatetheTracCode 9 14 10 15 TracInstall または、あなたの OS に合った方法で新しいバージョンの Trac を取得してください。 11 16 12 {{{easy_install}}} を使って、最近の 0.11 のバージョンの Trac をインストールしていた場合は、最も簡単に Trac をアップグレードできます。 17 `easy_install` を使って、バージョン 0.11 の Trac をインストールした場合は、 Trac のアップグレードにも `easy_install` を使うのが最も簡単な方法でしょう: 13 18 14 19 {{{ 15 # easy_install --upgrade Trac 20 # easy_install --upgrade Trac==0.12 16 21 }}} 17 22 18 手 で (OS 特有でない) アップグレードをするのであれば、インストールを実行する前に起動中の Trac サーバを停止してください。 "ホット" アップグレードは問題を生じることが多いです。特に Windows では出来ないと考えてください ([http://trac.edgewall.org/ticket/7265 #7265])。23 手動で (OS 特有でない) アップグレードをするのであれば、インストールを実行する前に起動中の Trac サーバを停止してください。 "ホット" アップグレードは問題を生じることが多いです。特に Windows では出来ないと考えてください ([trac:#7265 本家チケット 7265])。 19 24 20 25 すでに存在する Trac のコードを削除するには、 Python の `lib/site-packages` ディレクトリから `trac` ディレクトリか、 Trac の .egg の古いバージョンを削除します。 21 26 site-packages ディレクトリの位置は OS のシステム、および Python のインストールパスにより異なりますが、一般的には以下の位置にあります: 22 * Linux の場合: /usr/lib/python2.X/site-packages23 * Windows の場合: C:\Python2.X\lib\site-packages24 * MacOSX の場合: /Library/Python/2.X/site-packages27 * Linux の場合: `/usr/lib/python2.X/site-packages` 28 * Windows の場合: `C:\Python2.X\lib\site-packages` 29 * MacOSX の場合: `/Library/Python/2.X/site-packages` 25 30 26 31 また、 `share/trac` (正確な位置はプラットフォームに依存しますが一般的にはこの位置です。) ディレクトリ内の `cgi-bin`, `htdocs`, `templates`, `wiki-default` といったディレクトリを削除してもかまいません。 (訳注: 0.11 では、これらのディレクトリは `site-packages/trac` の配下に移動しています) … … 28 33 このクリーンアップは必須ではありませんが、あとでトラブルシュートを行う場合の切り分けが容易になります。すでに使われていない前のリリースのコードやテンプレートを見るなどという時間の浪費をしたくないのであれば、削除しておく方が楽です。もちろん、ファイルを削除する前にバックアップを作成する方が良いでしょう。 29 34 30 webadmin plugin をインストールしていた場合は、アンインストールしてください。今や webadmin plugin は Trac コードベースの一部です。 31 32 === 2. TracEnvironment をアップグレードする === #UpgradetheTracEnvironment 35 === 3. Trac Environment をアップグレードする === #UpgradetheTracEnvironment 33 36 34 37 Environment のアップグレードは、マイナーバージョンアップに特別な注意書きがない限り、不要です。 … … 47 50 }}} 48 51 49 カスタム CSS スタイルを使用していたり、 TracEnvironment の templates ディレクトリテンプレートを変更している場合、 Genshi のやり方にコンバートする必要があります。スタイルシートを使用し続けたい場合、 TracInterfaceCustomization#SiteAppearance の手順を読んでください。 50 51 === 3. Trac ドキュメントを更新する === #UpdatetheTracDocumentation 52 === 4. Trac ドキュメントを更新する === #UpdatetheTracDocumentation 52 53 53 54 すべての [TracEnvironment Trac Environment] で、インストールされたバージョンの Trac ドキュメントのコピーを含んでいます。新しくインストールした Trac のドキュメントと同期を取りたいでしょう。 [TracAdmin trac-admin] がドキュメントを更新するコマンドを提供しています: … … 56 57 }}} 57 58 58 当然このプロシージャはあなたの `WikiStart` ページ (訳注: `InterMapText` も) をまったく変更せず、そのままに残しておきます。59 このプロシージャはあなたの `WikiStart` ページ (訳注: `InterMapText` も) をまったく変更せず、そのままに残しておきます。 59 60 60 === 4. Trac Environment とソースコードリポジトリの再同期 === #a4.ResynchronizetheTracEnvironmentAgainsttheSourceCodeRepository61 61 62 Trac でソースコードをブラウズしているときに "[http://trac.edgewall.org/ticket/6120 リポジトリにチェンジセット ??? が存在しません]" のようなエラーが出る場合は、それぞれの [TracEnvironment Trac environment] のソースコードリポジトリと再同期をする必要があります。 62 === 5. 静的リソースをリフレッシュする === #a5.Refreshstaticresources 63 64 もし、静的リソースを直接配布できる ( URL `/chrome/` を使用してアクセス) ようにウェブサーバをセットアップしていたら、同じくコマンドを使用してそれらをリフレッシュする必要があります: 65 {{{ 66 trac-admin /path/to/env deploy /deploy/path 67 }}} 68 このコマンドは、新しい Trac のバージョンとそのプラグインから `/deploy/path` に静的リソースと CGI スクリプト (`trac.wsgi`, など) を抽出します。 69 70 いくつかのウェブブラウザ (IE, Opera) は、 CSS や Javascript ファイルを強引にキャッシュしてしまうので、ユーザにはこれらのブラウザのキャッシュの中身を手動で削除するために強制的に更新すること (`<F5>`) を十分行うように指示したほうがいいかもしれません。 71 {{{#!comment 72 Remove above note once #9936 is fixed. 73 }}} 74 75 === 6. 特定の Trac バージョンでの特記事項 === #a6.StepsspecifictoagivenTracversion 76 ==== Trac 0.12 から Trac 1.0 にアップグレードする ==== #UpgradingfromTrac0.12toTrac1.0 77 78 サブバージョンサポートの Trac コンポーネントはデフォルト状態では有効にならなくなりました。サブバージョンのサポートを有効にするためには、 `tracopt.versioncontrol.svn` コンポーネントを有効にしてください。例えば、 TracIni に以下のように記述してください: 79 {{{ 80 [components] 81 tracopt.versioncontrol.svn.* = enabled 82 }}} 83 明示的にサブバージョンのコンポーネントを無効に設定していない場合は、この対応をとり、 TracIni を適切に変更してください。 84 85 今回の自動アップグレードで添付ファイルが格納される場所が変わります。心配性な人は、アップグレードの前に `attachments` ディレクトリのバックアップを取りたいと思うかもしれません(本当に心配性な人は、すでに environment のフルコピーを取っているでしょうね)。 `attachments` ディレクトリに添付ファイル //以外// のファイルが格納されていると、新しいレイアウトへの移行の最後のステップで失敗してしまいます:何かファイルやフォルダが格納されていると、今バージョンから使用しない `attachments` ディレクトリを削除することができません。このエラーは無視してもかまいませんが、environment をクリーンアップするために、ファイル内容を確認し、別の場所へ移動させ、 `attachments` ディレクトリを手動で削除したほうがよいでしょう。添付ファイルは今バージョンから environment 配下の `files/attachments` ディレクトリ内に格納されます。 86 87 88 ==== Trac 0.11 から Trac 0.12 にアップグレードする ==== #UpgradingfromTrac0.11toTrac0.12 89 90 ===== Python 2.3 サポート ===== #Python2.3nolongersupported 91 現在 Python 2.4 以降 をサポートします。 92 93 ===== SQLite v3.x ===== #SQLitev3.xrequired 94 SQLite v2.x のサポートは終了しました。もしいまだに Trac で SQLite v2.x のデータベースを使用しているようならば、まず最初に SQLite v3.x に変換する必要があります。詳細は [trac:PySqlite#UpgradingSQLitefrom2.xto3.x] を参照して下さい。 95 96 ===== [trac:PySqlite PySqlite] 2 ===== #PySqlite2required 97 [trac:PySqlite PySqlite] 1.1.x のサポートは終了しました。可能であれば、バージョン 2.5.5 以降のバージョンをインストールして下さい。 (下記 [#Tracdatabaseupgrade Trac データベースのアップグレード] を参照して下さい) 98 99 ===== 複数のリポジトリのサポート===== #MultipleRepositorySupport 100 最新のバージョンでは複数リポジトリの取り扱いをサポートしています。Trac に複数のリポジトリを追加する予定であるならば、今では複数のリポジトリを扱えるようになっています。詳細については、 [TracRepositoryAdmin#Migration 単一リポジトリからの移行手順] を参照して下さい。 101 102 もし単一のリポジトリでの運用を行なっていたとしてもこの手順は興味深いものとなるかもしれません。なぜなら、この方法によってリクエスト毎に発生する潜在的に負荷の高い再同期のチェックを避けることができるからです。 103 104 ===== Trac Environment とソースコードリポジトリの再同期 ===== #ResynchronizetheTracEnvironmentAgainsttheSourceCodeRepository 105 106 Trac でソースコードをブラウズしているときに "[trac:#6120 リポジトリにチェンジセット ??? が存在しません]" のようなエラーが出る場合は、それぞれの [TracEnvironment Trac environment] のソースコードリポジトリと再同期をする必要があります: 63 107 64 108 {{{ 65 trac-admin /path/to/projenv re sync109 trac-admin /path/to/projenv repository resync '*' 66 110 }}} 67 111 68 === 5. 特定の Trac バージョンでの特記事項 === #a5.StepsspecifictoagivenTracversion 69 ==== Trac 0.11 より古いバージョンからアップグレードする ==== #UpgradingtoTrac0.11 70 ===== サイトテンプレート ===== #SiteTemplates 71 0.11 でテンプレートエンジンが変更されました。 TracInterfaceCustomization を参照してください。 112 ===== 向上したリポジトリの再同期 ===== #Improvedrepositorysynchronization 113 複数のリポジトリをサポートするのに加えて、今では Trac と リポジトリの同期でより効果的な方法があります。 114 115 バージョン 0.11 と同様に post-comit フックを使用した同期方法を続けることもできますが、[TracRepositoryAdmin#Synchronization リポジトリの同期方法] や [TracRepositoryAdmin#ExplicitSync 明示的な同期] に書かれている方法の方が、より効果的な同期を行なうことができ、多かれ少なかれ、複数のリポジトリを扱う際に必須となります。 116 117 Note: もし、 `trac-post-commit-hook` を使用していたならば、上記を参照して、新しいフックに ''アップグレードすることを強くお勧めします'' 。なぜなら、古いフックはデフォルトのリポジトリ以外では動きません。そしてこの場合、適切な通知のトリガーとなりません。 118 119 ===== Authz のパーミッションチェック ===== #Authzpermissionchecking 120 authz のパーミッションチェックが粒度の細かいパーミッションポリシーとしてマイグレートされました。もし authz パーミッションを使用しているならば、 ( `[trac] authz_file` や `authz_module_name` を参照)、 `[trac] permission_policies` で定義するパーミッションポリシーの先頭に、 `AuthzSourcePolicy` を追加しなければなりません。また、グローバルのパーミッション設定から `BROWSER_VIEW`, `CHANGESET_VIEW`, `FILE_VIEW`, `LOG_VIEW` を削除しなければなりません (`trac-admin $ENV permission remove` コマンドまたは、管理パネルの "権限" から削除されます)。 121 122 ==== マイクロ秒のタイムスタンプ ==== #Microsecondtimestamps 123 データベースのテーブルにある全てのタイムスタンプ (セッションテーブルは除く) は "エポックからの秒数" から "エポックからのマイクロ秒数" へ値を変更しました。この変更はカスタムレポートを除いて、ほとんどのユーザは意識せずにすむはずです。レポートで計算に日付/時刻カラムを使用するような場合 (例えば、`datetime()`に渡す場合)、データベースから取り出した値を 1,000,000 で割る必要があります。同様に、もしレポートで日付/時刻と表示される計算された値 (カラム名が "time", "datetime", "changetime", "date", "created" や "modified") をマイクロ秒のタイムスタンプで用いる必要がある場合には、先の計算を1,000,000倍して下さい。 124 125 ==== Trac 0.10 から Trac 0.11 へのアップグレード ==== #UpgradingfromTrac0.10toTrac0.11 126 ===== テンプレート と スタイルシート ===== #SiteTemplatesandStyles 127 テンプレートエンジンが Trac 0.11 から Genshi に変わりました。詳細については、 TracInterfaceCustomization を参照して下さい。 128 129 もし、TracEnvironment の `templates` ディレクトリの中のカスタマイズされた CSS や 修正したテンプレートを使用しているならば、 Genshi のスタイルに変換する必要があります。カスタマイズしたスタイルシートを使い続けるためには、[TracInterfaceCustomization#SiteAppearance サイトの外観] の手順に従ってください。 72 130 73 131 ===== Trac マクロプラグイン ===== #TracMacrosPlugins 74 !ClearSilver と HDF が使用されなくなったことで、古いスタイルの Wiki マクロ は使用できなくなります。そのため Trac マクロを適応させる必要があるでしょう;新しいスタイルのマクロに変更する必要があれば WikiMacros を参照してください。新しいスタイルにコンバートした後、配置するディレクトリは wiki-macros ではなく、 plugins を使用してください。 wiki-macros ディレクトリからマクロやプラグインを探すことはもうありません。132 [trac:ClearSilver] と HDF が使用されなくなったことで、古いスタイルの Wiki マクロ は使用できなくなります。そのため Trac マクロを適応させる必要があるでしょう。新しいスタイルのマクロに変更する必要があれば WikiMacros を参照してください。新しいスタイルにコンバートした後、配置するディレクトリは wiki-macros ではなく、 plugins を使用してください。 wiki-macros ディレクトリからマクロやプラグインを探すことはもうありません。 75 133 76 134 ===== FCGI/WSGI/CGI を使用する場合 ===== #ForFCGIWSGICGIusers … … 82 140 このコマンドでは、デプロイ用ディレクトリを作成します。デプロイ用ディレクトリには `cgi-bin` と `htdocs` の二つのサブディレクトリが含まれています。 Apache の `httpd.conf` を新しい `trac.cgi` と `htdocs` の場所に更新してください。 83 141 84 === 6. Web サーバを再起動する === #RestarttheWebServer 142 ===== Web アドミンプラグインのインテグレーション ===== 143 もし、 Web アドミンプラグインをインストールしていたら、 Trac 0.11 以降より、 Trac のコードベースの一部となっているのでアンインストールできます。 144 145 === 7. Web サーバを再起動する === #RestarttheWebServer 85 146 86 147 [wiki:TracCgi CGI] 以外で起動している場合は、 Web サーバを再起動して、新しい Trac コードをリロードしてください。 … … 88 149 == 既知の問題 == #KnownIssues 89 150 151 アップグレードの際、以下のことに留意してください。 152 153 === カスタマイズされたテンプレート === #CustomizedTemplates 154 155 Trac は [TracEnvironment Environment] の `<env>/templates` フォルダ内、または [[TracIni#GlobalConfiguration| [inherit] templates_dir]] コンフィグに設定された共通のディレクトリ内にテンプレートのコピーを置くことによって、Genshi テンプレートのカスタマイズをサポートします。もしこの方法を採用している場合、テンプレートはおそらく今後も進化していくので、新しくリリースされた Trac (以前のバージョンでも) にアップグレードする際には、新しいテンプレートのコピーを手動で変更することが繰り返し必要になることに注意してください。diff は取っておいてください ;-) 156 157 TracInterfaceCustomization を行うには、適切な `ITemplateStreamFilter` 変換を行うカスタムプラグインを書く方法が望ましいでしょう。この場合、通常 id の修正や CSS の `class` の変更を行わないため、変更が生じても影響をうけません。もし必要になるのであれば、[trac:TracDev/ApiChanges TracDev/ApiChanges] ページにドキュメントが記載されるでしょう。 158 159 === !ZipImportError === #ZipImportError 160 161 zip形式で圧縮されたパッケージの内部キャッシングにより、ディスク上でパッケージの内容が変わるたびに、メモリ内のzip インデックスは一致せず、回復不能な !ZipImportError が出ます。アップグレードをする前にメンテナンスのために予めサーバーを停止してください。 162 詳細については、 [trac:#7014 本家チケット 7014] を参照して下さい。 163 164 === Wiki のアップグレード === #WikiUpgrade 165 `trac-admin` は新しいバージョンでは存在しない以前のバージョンの Wiki ページを削除や移動しません。 166 167 === Trac データベースのアップグレード === #Tracdatabaseupgrade 168 169 既知の問題として、!PySqlite のいくつかのバージョン (2.5.2-2.5.4) では、 trac-admin upgrade スクリプトを使用してデータベースを更新することができません。このエラーを避けるために、 sqlite の python バインディングのバージョンをより新しいものかより古いバージョンを使用することを推奨します。詳細については、 [trac:#9434 本家チケット 9434] を参照して下さい。 170 90 171 === 複数プロジェクトのホストに関して === #parentdir 91 172 複数のプロジェクトをホストした場合に、配下のプロジェクトのうち一つのプロジェクトで、プラグインの一つが動作していないとき、配下のすべてのプロジェクトではそのプラグインは動作していません。 92 173 93 === コアモジュールがロードされない === #somecoremoduleswontload 94 Windows で Python 2.3 を使用している場合、最初にアンインストールを行わずにアップグレードすると時々発生します。 95 いくつかのモジュールは、以前はキャピタライズされていましたが、小文字のみに変更されました (例えば、 trac/About.py が trac/about.py に変更されるなど)。以下のようなメッセージが Trac のログに出てくる場合: 96 {{{ 97 ERROR: Skipping "trac.about = trac.about": (can't import "No module named about") 98 }}} 99 `Lib/site-packages/trac` ディレクトリを削除してから、再インストールしてください。 174 == 関連するトピック == #Relatedtopics 100 175 101 === Wiki Upgrade === #WikiUpgrade 102 `trac-admin` は新しいバージョンでは存在しない以前のバージョンの Wiki ページを削除や移動しません。 176 === Python のアップグレード === #UpgradingPython 103 177 178 Python を新しいバージョンにアップグレードすると Python パッケージの再インストールが必要となります: Trac も例外ではないですし、 [http://pypi.python.org/pypi/setuptools easy_install] も然りです (もし使用しているならばですが)。 Subversion を使用しているならば、 Subversion の Python のバインディングもアップグレードする必要があります。 104 179 105 == データベースの変更 == #ChangingDatabaseBackend 106 === SQLite から PostgreSQL へ === #SQLitetoPostgreSQL 180 ==== Windows と Python 2.6 ==== #WindowsandPython2.6 107 181 108 [http://trac-hacks.org trac-hacks.org] の [http://trac-hacks.org/wiki/SqliteToPgScript sqlite2pg] は SQLite のデータベースを PostgreSQL に移行するためのサポートをするスクリプトです。 182 もしあなたが、 !CollabNet の Subversion のパッケージを使用しているならばアンインストールする必要があるかもしれません。というのも、 [http://alagazam.net/ Alagazam] に気軽に使える Python バインディングがあるからです。 ([trac:TracSubversion TracSubversion] 参照) いいニュースとして、調整なしに動作します。 109 183 110 == より古いバージョン == #OlderVersions 184 === データベースの変更=== #ChangingDatabaseBackend 185 ==== SQLite から PostgresSQL へ ==== #SQLitetoPostgreSQL 111 186 112 さらに前のバージョンからのアップグレードについては [http://trac.edgewall.org/wiki/0.10/TracUpgrade 0.10/TracUpgrade] をまずは参照してください。187 [http://trac-hacks.org trac-hacks.org] の [http://trac-hacks.org/wiki/SqliteToPgScript sqlite2pg] は SQLite のデータベースを PostgreSQL に移行するためのサポートをするスクリプトです。 113 188 114 Note: Trac 0.11 から Trac 0.10.4 や 0.10.5 にダウングレードするには、手作業が必要になります: 115 {{{ 116 $ sqlite3 db/trac.db "update system set value=20 where name='database_version'" 117 }}} 118 (あとで再度、正常にアップグレードすることができます) 189 === より古いバージョンからのアップグレード === #OlderVersions 190 191 さらに前のバージョンからのアップグレードについては [trac:wiki:0.10/TracUpgrade#SpecificVersions] を最初に参照してください。 119 192 120 193 -----