Confluence 2.7 アップグレード ガイド

Refer to the release notes for details of the features, improvements and bug fixes in this release.

On this page:

アップグレード ノート

プラグイン

サードパーティ プラグインを使用している場合は、2.7 を本番環境で導入する前に徹底的にテストしてください。

Resin の設定

この注意事項は、Resin アプリケーション サーバーを使用している場合に適用されます。Confluence のコア コンポーネントの一つ (Spring) へアップグレードされたことにより、Resin の出荷時設定では使用できなくなりました。この問題を解決するには、XSD 対応のの XML パーサーを使用するよう Resin を構成する必要があります。詳細:

• Resin 設定のトラブルシューティング
• Spring Framework のドキュメント

JIRA と Confluence の間の信頼できる通信

Confluence 2.7 provides a new trusted communication protocol, to allow secure authentication for the JIRA Issues and JIRA Portlet macros.

When upgrading, consider whether to disable warning messages or turn off trusted communication altogether. You may like to do this if you have a number of existing JIRA Issues or JIRA Portlet macros in your Confluence pages, and you do not intend to set up trusted communications soon. Read more about configuring trusted communications.

デフォルトでは、Confluence 2.7 をアップグレードすると、信頼できる通信が有効化されます。これは、次のように、既存のマクロに影響を与えます。

• マクロ マークアップにユーザー名とパスワードが含まれている場合、機能は変更されません。
• If you have already set up trusted communication with a JIRA instance, the macro output will be as described in the guide on trusted communication.
• If the macro markup does not contain a username and password and you have not set up trusted communication with a JIRA instance, your Confluence pages will show a warning message above the macro output. See more information on troubleshooting.

WebDAV attachment manager は非推奨となりました

WebDAV サーバーに Confluence 添付ファイルに保存するオプションは不便であったため、多くのバージョンには含まれていません。

The WebDAV attachment manager is deprecated from Confluence 2.7, and will be removed from a future version of Confluence. If you store attachments on external WebDAV servers, we recommend that you migrate to file-system or database-backed attachment storage immediately. Refer to CONF-9313 and CONF-2887.

This DOES NOT affect the operation of the WebDAV plugin.

ユーザーの移行

Confluence 2.7 replaces OSUser with AtlassianUser as the underlying user management framework, greatly improving performance. Read more information about user management in Confluence.

Confluence を以前のバージョンから 2.7.0 以降にアップグレードする場合、ユーザーは AtlassianUser へと自動的に移行されます (ただし、次の段落の例外を参照してください)。この移行プロセスにより、アップグレードには通常よりも長い時間がかかる場合があります。

Automatic migration will not occur if any of the following is true:

• Jira または LDAP にユーザー管理を委任している、またはユーザー管理を標準構成から変更している。この場合、atlassian-user.xml または osuser.xml ファイルを保持するため、通常通りアップグレードする必要があります。
• すでに AtlassianUser に移行している。

移行プロセスはログ ファイルに表示されます。たとえば、移行が成功した場合は次のようになります。

2007-10-08 21:33:07,979 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] userMigrationStarted Starting user migration. 12288 users to migrate.
2007-10-08 21:33:09,784 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] userMigrated 100 users migrated out of 12288.
...
2007-10-08 21:36:18,304 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] userMigrated 12100 users migrated out of 12288.
2007-10-08 21:36:20,112 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] userMigrated 12200 users migrated out of 12288.
2007-10-08 21:36:21,562 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] userMigrationComplete User migration complete.
2007-10-08 21:36:35,957 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] groupMigrationStarted Group migration started. 44 groups to migrate.
2007-10-08 21:36:35,960 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] groupMigrated 10 groups migrated out of 44.
..
2007-10-08 21:36:38,055 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] groupMigrated 40 groups migrated out of 44.
2007-10-08 21:36:38,208 INFO [main] [atlassian.confluence.upgrade.OSUserToAtlassianUserMigrationUpgradeTask] groupMigrationComplete Group migration complete.

システム管理者権限と Confluence 管理者権限

Confluence 2.7 brings two administrator-level permissions in place of one. The new permissions are 'System Administrator' and 'Confluence Administrator'. Refer to the documentation for details.

バージョンを 2.7 にアップグレードすると、古い「Confluence の管理」権限を持つすべてのユーザーとグループは、新しい「システム管理者」権限に変換されます。「confluence-administrators」グループの力は変更されず維持されます。

Confluence ログの場所

Confluence's default logging behaviour has changed with Confluence 2.7. Both Standalone and EAR/WAR editions follow the same default behaviour:

• Confluence を起動すると、Confluence の初期 bootstrap が完了するまで、ログ エントリがアプリケーション サーバーに送られます。後述のように、すべてのログ エントリが <confluence-home> ログに繰り返されます。
• Once the initial startup sequence is complete, all logging will be to <confluence-home>/logs/atlassian-confluence.log. For example: c:/confluence/data/logs/atlassian-confluence.log.
  Note that the default location is now the Confluence home directory instead of the application server's log file.

Java バージョン

Confluence 2.7 は Java 1.4、Java 5 および Java 6 をサポートします。メモリ ダンプとプロファイル機能の強化によって、パフォーマンスが優れ、トラブルシューティングが簡単な Java 6 をお勧めします。

予告: Java 1.4 は将来のリリースでは非推奨となる予定です。Confluence 2.8 は Java 1.4 をサポートする最後のバージョンになる予定です。

アップグレード手順

すでに Confluence のいずれかのバージョンを実行している場合、以下の手順に従って最新バージョンにアップグレードしてください。

1. アップグレードを開始する前に、confluence.home ディレクトリとデータベースをバックアップすることを強くおすすめします。
   
   
2. If your version of Confluence is earlier than 2.6.x, read the release notes and upgrade guides for all releases between your version and the latest version. In particular:
   • If you are upgrading from 2.1 or earlier, please read the 2.2 release notes.
   • If you are upgrading from a version earlier than 2.6.0, please read the 2.6 upgrade notes.
     
     
3. Download the latest version of Confluence.
   
   
4. Follow the instructions in the Upgrade Guide.