Confluence 2.8 アップグレード ノート
Below are some essential notes on upgrading to Confluence 2.8. For details of the new features and improvements in this release, please read the Confluence 2.8 Release Notes.
On this page:
アップグレード ノート
Crowd Integration
If you are using Atlassian Crowd as your Confluence user management and single sign-on solution, please upgrade to Crowd 1.3.2 or later. With Confluence 2.8 the atlassian-user interface has changed, and Crowd 1.3.2 provides the required update to Crowd's atlassian-user integration module.
Default Order of Pages Changed from Alphabetical to Natural
Confluence 2.8 introduces the ability to move pages into any order you choose.
As part of the above feature, we have changed the default page order in Confluence, from simple alphabetical ordering to a 'natural' ordering. The natural ordering handles numeric values correctly when doing string comparisons.
Impact:
- The new natural ordering is the same as the ordering already used by the PageTree plugin, which some customers use to create a left-hand navigation panel.
- The change to natural ordering should have little effect on most users because, under most situations, natural ordering and alphabetical ordering will produce the same results.
- For customers who have inserted chapter or page numbers to force the correct order, the new natural ordering will show the existing pages in the correct order.
If you do find that the order of your pages is adversely affected, you can use the new page-ordering function to move the pages.
プラグイン
Please check the following if you have added any plugins to Confluence:
- サードパーティ プラグインを使用している場合は、2.8 を本番環境で導入する前に徹底的にテストしてください。
- The PageTree plugin has been updated. If you are using this plugin, please download the latest version to ensure compatibility with Confluence 2.8.
Velocity Template Engine
Confluence's Velocity template engine has been upgraded from 1.3 to 1.5. Please test carefully for compatibility problems with existing third-party themes and plugins.
Dynamic Tasklist 2
The Dynamic Tasklist 2 plugin is now bundled with Confluence. The new tasklist macro replaces the older tasklist and dynamictasklist macros. What happens to existing tasklists?
- By default, the new macro will be enabled and the older macros disabled in your Plugin Repository.
- When someone views a page containing an older version of the task list, the display will show the new format but the page will not be updated.
- When someone first adds a task or changes anything in the task list, the data will be converted to the new format.
Customized Page Layouts
The Confluence Upgrade Guide includes instructions on re-applying your customizations after the upgrade. We're repeating some of that information here, because it's particularly important due to the UI changes in this release.
If a space uses a customized page layout, the new Confluence 2.8 layout will not be applied. This means that you will not see the new menu structure within that space. For example, this will happen if you are using pagetree navigation to form a table of contents on the left.
Fix: Apply the Default Page Layout, then re-insert your custom code.
詳細な手順
- スペース管理画面に移動し、[編集] をクリックしてカスタム ページ レイアウトを表示します。
- カスタマイズしたコードをコピーします。
- 編集をキャンセルします。
- [デフォルトにリセット] をクリックして、新しい Confluence 2.8 のデフォルト ページのレイアウトを適用します。
- スペース管理画面から、[カスタムを作成] をクリックしてカスタムのページ レイアウトを作成します。
- カスタマイズしたコードを再挿入し、[保存] をクリックします。
JavaScript Libraries
jQuery is the supported JavaScript library for plugin developers.
Advance notice — deprecated libraries: We have decided to standardize on jQuery as the JavaScript library for Confluence. This library will eventually replace all others. For this reason, use of the following JavaScript libraries in Confluence is deprecated:
- The Yahoo! User Interface Library (YUI)
- Prototype
- Scriptaculous
Because there is a lot of legacy plugin code using Prototype and Scriptaculous, these will continue to be available for at least one more major release of Confluence.
Java Versions
Confluence 2.8 は Java 1.4、Java 5 および Java 6 をサポートします。メモリ ダンプとプロファイル機能の強化によって、パフォーマンスが優れ、トラブルシューティングが簡単な Java 6 をお勧めします。
Advance notice — Java 1.4 will be deprecated in a future release. Confluence 2.8 will be the last version that supports Java 1.4. Please refer to the Java 1.4 Support Timeline for more information.
アップグレード手順
As always please test your upgrades in your TEST environment before rolling into PRODUCTION.
すでに Confluence のいずれかのバージョンを実行している場合、以下の手順に従って最新バージョンにアップグレードしてください。
- Before you upgrade, we strongly recommend that you back up your Confluence Installation Directory and your Confluence Home Directory, as directed in the Upgrade Guide. If you are using an external database, perform a database backup.
- If your version of Confluence is earlier than 2.7.x, read the release notes and upgrade guides for all releases between your version and the latest version.
- 2.1 以前のバージョンからアップグレードする際には、2.2 リリース ノートをお読みください。
- If you are upgrading from 2.2 or earlier, you will need to upgrade to Confluence 2.7.0 first, confirm the upgrade was successful, then upgrade again from version 2.7.0 to version 2.8. For more details, please refer to CONF-11767.
- Download the latest version of Confluence.
- Follow the instructions in the Upgrade Guide.
- If you encounter a problem during the upgrade, please create a support ticket and one of our support engineers will assist you through the process.