| 60 | {{{ |
| 61 | trac-admin /path/to/projenv repository resync '*' |
| 62 | }}} |
| 63 | |
| 64 | === 5. 静的リソースをリフレッシュする === #a5.Refreshstaticresources |
| 65 | |
| 66 | もし、静的リソースを直接配布できる ( URL `/chrome/` を使用してアクセス) ようにウェブサーバをセットアップしていたら、同じくコマンドを使用してそれらをリフレッシュする必要があります: |
| 67 | {{{ |
| 68 | trac-admin /path/to/env deploy /deploy/path |
| 69 | }}} |
| 70 | このコマンドは、新しい Trac のバージョンとそのプラグインから `/deploy/path` に静的リソースと CGI スクリプト (`trac.wsgi`, など) を抽出します。 |
| 71 | |
| 72 | いくつかのウェブブラウザは、 CSS や Javascript ファイルをしつこくキャッシュしているので、ユーザにはこれらのブラウザのキャッシュの中身を手動で削除するように指示したほうがいいかもしれません。 |
| 73 | |
| 74 | === 6. 特定の Trac バージョンでの特記事項 === #a6.StepsspecifictoagivenTracversion |
| 75 | ==== Trac 0.11 から Trac 0.12 にアップグレードする ==== #UpgradingfromTrac0.11toTrac0.12 |
| 76 | ===== Python 2.3 サポート ===== #Python2.3nolongersupported |
| 77 | 現在 Python 2.4 以降 をサポートします。 |
| 78 | |
| 79 | ===== SQLite v3.x ===== #SQLitev3.xrequired |
| 80 | SQLite v2.x のサポートは終了しました。もしいまだに Trac で SQLite v2.x のデータベースを使用しているようならば、まず最初に SQLite v3.x に変換する必要があります。詳細は [http://trac.edgewall.org/wiki/PySqlite#UpgradingSQLitefrom2.xto3.x] を参照して下さい。 |
| 81 | |
| 82 | ===== [http://trac.edgewall.org/wiki/PySqlite PySqlite] 2 ===== #PySqlite2required |
| 83 | [http://trac.edgewall.org/wiki/PySqlite PySqlite] 1.1.x のサポートは終了しました。可能であれば、バージョン 2.5.5 以降のバージョンをインストールして下さい。 (下記 [#Tracdatabaseupgrade Trac データベースのアップグレード] を参照して下さい。) |
| 84 | |
| 85 | ===== 複数のリポジトリのサポート===== #MultipleRepositorySupport |
| 86 | 最新のバージョンでは複数リポジトリの取り扱いをサポートしています。Trac に複数のリポジトリを追加する予定であるならば、今では複数のリポジトリを扱えるようになっています。詳細については、 [TracRepositoryAdmin#Migration 単一リポジトリからの移行手順] を参照して下さい。 |
| 87 | |
| 88 | もし単一のリポジトリでの運用を行なっていたとしてもこの手順は興味深いものとなるかもしれません。なぜなら、この方法によってリクエスト毎に発生する潜在的に負荷の高い再同期のチェックを避けることができるからです。 |
| 89 | |
| 90 | ===== 向上したリポジトリの再同期 ===== #Improvedrepositorysynchronization |
| 91 | 複数のリポジトリをサポートするのに加えて、今では Trac と リポジトリの同期でより効果的な方法があります。 |
| 92 | |
| 93 | バージョン 0.11 と同様に post-comit フックを使用した同期方法を続けることもできますが、[TracRepositoryAdmin#Synchronization リポジトリの同期方法] や [TracRepositoryAdmin#ExplicitSync 明示的な同期] に書かれている方法の方が、より効果的な同期を行なうことができ、多かれ少なかれ、複数のリポジトリを扱う際に必須となります。 |
| 94 | |
| 95 | Note: もし、 `trac-post-commit-hook` を使用していたならば、上記を参照して、新しいフックに ''アップグレードすることを強くお勧めします'' 。なぜなら、古いフックはデフォルトのリポジトリ以外では動きません。そしてこの場合、適切な通知のトリガーとなりません。 |
| 96 | |
| 97 | ===== Authz のパーミッションチェック ===== #Authzpermissionchecking |
| 98 | 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` コマンドまたは、管理パネルの "権限" から削除されます。) |
| 99 | |
| 100 | ==== マイクロ秒のタイムスタンプ ==== #Microsecondtimestamps |
| 101 | データベースのテーブルにある全てのタイムスタンプ (セッションテーブルは除く) は "エポックからの秒数" から "エポックからのマイクロ秒数" へ値を変更しました。この変更はカスタムレポートを除いて、ほとんどのユーザは意識せずにすむはずです。レポートで計算に日付/時刻カラムを使用するような場合 (例えば、`datetime()`に渡す場合)、データベースから取り出した値を 1,000,000 で割る必要があります。同様に、もしレポートで日付/時刻と表示される計算された値 (カラム名が "time", "datetime", "changetime", "date", "created" や "modified") をマイクロ秒のタイムスタンプで用いる必要がある場合には、先の計算を1,000,000倍して下さい。 |
| 102 | |
| 103 | ==== Trac 0.10 から Trac 0.11 へのアップグレード ==== #UpgradingfromTrac0.10toTrac0.11 |
| 104 | ===== テンプレート と スタイルシート ===== #SiteTemplatesandStyles |
| 105 | テンプレートエンジンが Trac 0.11 から Genshi に変わりました。詳細については、 TracInterfaceCustomization を参照して下さい。 |
| 106 | |
| 107 | もし、TracEnvironment の `templates` ディレクトリの中のカスタマイズされた CSS や 修正したテンプレートを使用しているならば、 Genshi のスタイルに変換する必要があります。カスタマイズしたスタイルシートを使い続けるためには、[TracInterfaceCustomization#SiteAppearance サイトの外観] の手順に従ってください。 |
| 108 | |
| 109 | ===== Trac マクロプラグイン ===== #TracMacrosPlugins |
| 110 | [http://trac.edgewall.org/wiki/ClearSilver ClearSilver] と HDF が使用されなくなったことで、古いスタイルの Wiki マクロ は使用できなくなります。そのため Trac マクロを適応させる必要があるでしょう; 新しいスタイルのマクロに変更する必要があれば WikiMacros を参照してください。新しいスタイルにコンバートした後、配置するディレクトリは wiki-macros ではなく、 plugins を使用してください。 wiki-macros ディレクトリからマクロやプラグインを探すことはもうありません。 |
| 111 | |
| 112 | ===== FCGI/WSGI/CGI を使用する場合 ===== #ForFCGIWSGICGIusers |
| 113 | CGI で Trac を起動している場合、以下のコマンドを実行して trac.*gi ファイルを取得してください: |
| 114 | {{{ |
| 115 | trac-admin /path/to/env deploy /deploy/directory/path |
| 116 | }}} |
| 117 | |
| 118 | このコマンドでは、デプロイ用ディレクトリを作成します。デプロイ用ディレクトリには `cgi-bin` と `htdocs` の二つのサブディレクトリが含まれています。 Apache の `httpd.conf` を新しい `trac.cgi` と `htdocs` の場所に更新してください。 |
| 119 | |
| 120 | ===== Web アドミンプラグインのインテグレーション ===== |
| 121 | もし、 Web アドミンプラグインをインストールしていたら、 Trac 0.11 以降より、 Trac のコードベースの一部となっているのでアンインストールできます。 |
| 122 | |
| 123 | === 7. Web サーバを再起動する === #RestarttheWebServer |
| 124 | |
| 125 | [wiki:TracCgi CGI] 以外で起動している場合は、 Web サーバを再起動して、新しい Trac コードをリロードしてください。 |
62 | | === コアモジュールがロードされない === #somecoremoduleswontload |
63 | | Windows で Python 2.3 を使用している場合、最初にアンインストールを行わずにアップグレードすると時々発生します。 |
64 | | いくつかのモジュールは、以前はキャピタライズされていましたが、小文字のみに変更されました (例えば、 trac/About.py が trac/about.py に変更されるなど)。以下のようなメッセージが Trac のログに出てくる場合: |
65 | | {{{ |
66 | | ERROR: Skipping "trac.about = trac.about": (can't import "No module named about") |
67 | | }}} |
68 | | `Lib/site-packages/trac` ディレクトリを削除してから、再インストールしてください。 |
69 | | === Wiki Upgrade === WikiUpgrade |
70 | | `trac-admin` はページを削除しません。バージョン 0.10 では存在し、バージョン 0.11 では存在しないページはそのまま残ります。 (0.11 開発中に存在した !TracWikiMacros など) |
| 131 | |
| 132 | === Wiki のアップグレード === |
| 133 | `trac-admin` は新しいバージョンでは存在しない以前のバージョンの Wiki ページを削除や移動しません。 |
| 134 | |
| 135 | === Trac データベースのアップグレード === #Tracdatabaseupgrade |
| 136 | |
| 137 | 既知の問題として、PySqlite のいくつかのバージョン (2.5.2-2.5.4) では、 trac-admin upgrade スクリプトを使用してデータベースを更新することができません。このエラーを避けるために、 sqlite の python バインディングのバージョンをより新しいものかより古いバージョンを使用することを推奨します。詳細については、 [http://trac.edgewall.org/ticket/9434 本家チケット 9434] を参照して下さい。 |
| 138 | |
| 139 | == Python のアップグレード== #UpgradingPython |
| 140 | |
| 141 | Python を新しいバージョンにアップグレードすると Python パッケージの再インストールが必要となります: Trac も例外ではないですし、 [http://pypi.python.org/pypi/setuptools easy_install] も然りです (もし使用しているならばですが)。 Subversion を使用しているならば、 Subversion の Python のバインディングもアップグレードする必要があります。 |
| 142 | |
| 143 | === Windows と Python 2.6 === #WindowsandPython2.6 |
| 144 | |
| 145 | もしあなたが、 !CollabNet の Subversion のパッケージを使用しているならばアンインストールする必要があるかもしれません。というのも、 [http://alagazam.net/ Algazam] に気軽に使える Python バインディングがあるからです。 ([http://trac.edgewall.org/wiki/TracSubversion TracSubversion] 参照) いいニュースとして、調整なしに動作します。 |