Below are some important notes on upgrading to Confluence 5.0. For details of the new features and improvements in this release, please read the Confluence 5.0 Release Notes.

On this page:

Confluence 5のチームの準備

Confluence 5.0 introduces a number of significant changes to the user experience: A new way of creating content, a redesigned header, a new sidebar, and other changes to the look and feel of your site. People in your organisation will need to be aware of the coming changes, so that they can plan and prepare for them. We have written a guide to help you: Planning for Confluence 5.

In addition, if you are upgrading from Confluence 3.5 or earlier please note that the change to the Confluence editing experience is significant. See the guide to Planning for Confluence 4.

アップグレード ノート – ユーザー インターフェイスとエディター

「参照」メニューとスペース管理オプションの変更

For all spaces using the default theme, the 'Browse' menu has gone. It is replaced by options in the new sidebar. For help on preparing Confluence users for this change, see Planning for Confluence 5.

Confluence サイトに、「参照」メニューにオプションを追加するプラグイン (アドオン) が含まれている場合

  • オプションは、サイドバーの「スペースツール」に表示されるようになりました。プラグインの作成者が Confluence 5.0 のプラグインをすでに更新している場合は、そのプラグインが表示されます。
     
  • The options may appear in the help menu (accessible from the Confluence header) after upgrade. This will happen if the plugin author has not yet updated the plugin for Confluence 5.0. See our guidelines for plugin developers: Browse Menu and Space Tools changes in Confluence 5.0.

ダッシュボードの変更

「ダッシュボード」リンクがヘッダーから削除されました。Confluence ダッシュボードに移動するには、サイト ロゴをクリックします。

名前が変更されたマクロ: メタデータの詳細と詳細の要約

次のマクロの名前が変更されました。Metadata Details はページ プロパティになりました。Details Summary はページ プロパティ レポートになりました。Confluence 5.0 以降にアップグレードする際に、アップグレード タスクがご利用の Confluence ページにある既存の Metadata Details と Details Summary のマクロの名前を自動変更します。これらのマクロに対する Wiki マークアップとストレージ形式コードに変更はありません。 

グローバル スペースは「サイト スペース」に名前変更されました

現在、グローバル スペースは「サイト スペース」として知られています。スペースの機能は変更されていません。@global パラメーターを使用するマクロは変更されていません。

アップグレード ノート – 管理

スペース ロゴが丸くなりました

Confluence ユーザー インターフェイスの更新の一環として、スペース ロゴの形を変更しました。既存のロゴが影響を受ける可能性があり、新しい丸い形式では見栄えがよくない場合があります。

We have added a simple way for space administrators to crop and update logos, directly from the space sidebar. Go to a page in the space and choose 'Configure sidebar'. Then choose the edit icon  next to the space name. For step-by-step instructions, see Changing a Space's Logo.

既定のスペース コンテンツがグローバル テンプレートで管理されるようになりました

The 'Default Space Content' option has been removed from the Administrator Console. New site templates are available for customising the homepage content of new site and personal spaces. These site templates are available on the 'Global Templates' screen of the Administration Console. An upgrade task will convert any existing default space content (created using the old wiki markup editor) to the new format. The 'Default Space Content' template will show as 'Edited' with your custom content inside. 

ウェルカム メッセージはグローバル テンプレートで管理されるようになりました

The welcome message that appears in the top left of your Confluence dashboard can now be customised via a site template, available on the 'Global Templates' screen of the Administration Console. This means you can use the rich text editor to edit the content. An upgrade task will convert your existing welcome message (created using the old wiki markup editor) to the new format. The default welcome message template will show as 'Edited' with your custom content inside.

ダッシュボードの新しいスタート ガイド

By default, the Confluence dashboard now displays a quick-start guide for administrators, under the site welcome message on the left. This section of the dashboard is visible to Confluence administrators and system administrators only. It is not configurable via the web interface, but you can update or remove it by editing the site layout as described in Customising the Getting Started Guide on the Dashboard.

Confluence 5.0 includes version 3.10.6 of Application Links. Note that people with 'Confluence Administrator' permissions can now configure application links. For example, they can link Confluence to JIRA. Previously, you needed 'System Administrator' permissions to perform this function. Confluence administrators will be able to add, modify and remove application links and project links. However, Confluence administrators can configure only OAuth authentication for application links.

カスタム テーマ、レイアウト、CSS は壊れる可能性があります

Confluence 5.0 の新しいルック & フィールを実現するために、Confluence ページの CSS とレイアウトに大きな変更を加えました。Confluence サイトまたは任意のスペースでカスタム テーマまたはカスタム CSS を使用している場合は、アップグレード後に動作しなくなる可能性があります。

Confluence の既定のテーマまたは Confluence ドキュメンテーション テーマを使用している場合は、操作不要です。

If you are using the Easy Reader theme, your site and affected spaces will be moved to the Confluence default theme. See below.

If you are using a third-party theme, please use the plugin manager in your Confluence Administration Console to check if there is a new version of the theme that is compatible with Confluence 5.0. See Checking app compatibility with application updates.

If you have applied a custom theme, we recommend that you revert to the Confluence default theme before upgrading to Confluence 5.0. See how to apply a theme to a site or to a space.

If you have applied custom CSS, you will need to update the CSS after the upgrade. See our guide to styling Confluence with CSS. Confluence 5.0 introduces many new CSS rules to the application as well as heavily modifying existing CSS. You will need to update your CSS to reflect these changes. In order for your CSS to continue working you will need to ensure that any new rules added to Confluence are appropriately overridden in your CSS. Additionally you will probably want to go through your CSS and remove any overrides that are no longer required.

If you have applied custom decorators or layouts, you will need to update them after the upgrade. See our guide to customising your site and space layouts. Confluence 5.0 introduces many new markup patterns. If you do not have some or all of these patterns in place, you may find that your custom decorator does not look the way it is supposed to. The best way to update your decorator is to compare it to the decorators used in Confluence 5.0 and adapt yours to follow the same patterns.

Confluence UI を介してオプションにアクセスできない範囲で CSS が壊れている際に、これらの URL が便利です。

  • サイト全体のテーマを選択する

    http://MY.CONFLUENCE.COM/admin/choosetheme.action

  • サイト全体の CSS を編集する

    http://MY.CONFLUENCE.COM/admin/editstylesheet.action

  • サイト全体のカスタム HTML を編集する

    http://MY.CONFLUENCE.COM/admin/editcustomhtml.action

  • スペースのテーマを選択する

    http://MY.CONFLUENCE.COM/spaces/choosetheme.action?key=SPACEKEY

  • スペースの CSS を編集する

    http://MY.CONFLUENCE.COM/spaces/editstylesheet.action?key=SPACEKEY

アップグレード ノート - 削除または置換された機能

Easy Reader テーマは利用できなくなりました

Confluence 5.0 以降のリリースには、Easy Reader テーマは含まれていません。シンプルな既定のエクスペリエンスを提示する、単一の Confluence テーマに移行しています。同時に、アドオン開発者がカスタム テーマで Confluence を簡単に拡張できるようにしたいと考えています。分析の結果、Easy Reader テーマを使用している Confluence サイトはごくわずかであることがわかっています。

現在、Confluence サイトに Easy Reader テーマを使用している場合は、Confluence 5.0 にアップグレードする際に、そのテーマを使用するサイトとスペースは既定のテーマに自動変換されます。

ドキュメント用テーマを既定のテーマにマージする計画の事前警告

これは、Confluence のドキュメント用テーマの機能を Confluence の既定のテーマとマージする予定があることに関する事前通知です。この予定の具体的な日付は決まっておらず、お客様のフィードバックを求めています。Confluence 5.0 で導入される新しい既定のテーマには、コンテキスト ナビゲーション付きのサイドバーが含まれています。今後のリリースでは、ドキュメント用テーマのすべての機能を既定のテーマに含めた上で、Confluence からドキュメント用テーマを削除する予定です。

If you are interested in this change and would like to give us feedback, please add a comment on this blog post: Advance warning of plans to merge Documentation theme with the default theme. We are especially interested to know which features of the Documentation theme you use and value the most.

最上位スペースへのリンクの宛先は設定できなくなりました

使用頻度の低いオプションを Confluence サイト設定から削除しました。今まで、Confluence には「スペースの表示をスペースの参照に移動する」というオプションがありました。このオプションは、ユーザーがスペースのルートを指すリンクをクリックしたときに発生する内容を決定していました。例: http://my.confluence.com/display/MYSPACE

このオプションを設定すると、Confluence は、ユーザーをスペースのホーム ページではなく「スペースの参照」ビューに転送していました。このオプションは削除され、Confluence はこのようなリンクがクリックされると常に、ユーザーをスペースのホーム ページに転送するようになりました。

これによる影響

  • 何もする必要はありません。
  • 「スペースの表示をスペースの参照に移動する」設定は、このオプションを以前設定していた場合でも、いずれのスペースにも適用されなくなります。
  • ユーザーがスペース キーで終わるリンク (例: http://my.confluence.com/display/MYSPACE,) をクリックすると、スペースのホーム ページに移動します。

Office コネクタ設定はシステム管理者に制限されています

Configuration of the Office Connector was previously available to both Confluence administrators and system administrators. In Confluence 5.0 and later, this action is now available to system administrators only. See Global Permissions Overview.

ページ レベルのエクスポートの権限を設定できなくなりました

Confluence の以前のバージョンでは、PDF と Microsoft Word にページをエクスポートできるユーザーを制御するために、スペース管理インターフェイスで設定可能な権限が提供されていました。Confluence 5.0 以降、この権限は設定できなくなりました。ページを表示する権限を持つユーザーは、そのページを PDF と Word にもエクスポートできます。

これはページのエクスポートにのみ影響します。スペースのエクスポート権限は引き続き残って、設定可能です。

メニューからラベル表示に直接アクセスできなくなりました

Confluence のこれまでのバージョンでは、'閲覧' > 'ラベル' の順に選択することでラベル表示が可能でした。既定のテーマから '閲覧' メニューがなくなったので、このオプションは利用できなくなりました。

ラベル表示を見つけるには:

  • ページ、ブログ投稿、添付上にラベルが表示された場合、そのラベルを選択するとラベル ビューへ進めます。 (ラベルを含んだページやブログ投稿には、必ずそのページ下部のブロックにラベルが一覧表示されます。)
  • また、’添付' (Attachments) ビュー、または、添付マクロが生成する添付リストでラベルを見ることもできます。

別の方法としては、次の URL をご覧ください:

<MY.CONFLUENCE.SITE>/labels/listlabels-alphaview.action?key=MYSPACEKEY.

For example: https://confluence.atlassian.com/labels/listlabels-alphaview.action?key=DOC

注: ドキュメント用テーマは Confluence 5.0 で '閲覧' メニューを保持しているため、'閲覧 > ラベル' オプションを引き続き利用できます。

スペース ラベルの追加機能は利用できなくなりました

スペースにおけるラベルの使用を簡素化するために、スペース ラベルを追加する機能が削除されました。既存のスペース ラベルは保持されますが、スペースに新規スペース ラベルを追加できません。この変更はスペース カテゴリに影響しません。 

JavaScript の設定オプション

管理コンソールの一般設定セクションから、ヘッダーではなくフッターに JavaScript を提供できるようにするオプションを削除しました。常に、JavaScript がヘッダーで提供されるようになります。

アップグレードに関する注意事項 – 統合とサポートされるプラットフォーム

Team Calendars 3.1 以降が必須

If you are using the Team Calendars add-on for Confluence, you will need to upgrade to Team Calendars 3.1 or later. Earlier versions of this add-on will not work with the new design in Confluence 5.0.

Google Gears のサポート終了

Confluence はドラッグ & ドロップで Google Gears をサポートしなくなりました。

java 6 サポートの終了

As previously announced, from this release onwards we no longer offer support for Java 6 (JRE and JDK 1.6). Please see End of Support Announcements for Confluence.

Tomcat 5.5 のサポートの終了

As previously announced, from this release onwards we no longer offer support for Tomcat 5.5.x. Please see End of Support Announcements for Confluence.

アップグレード手順

注: まずテスト環境をアップグレードします。本番環境に適用する前に、テスト環境でアップグレードをテストしてください。

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

  1. Before you upgrade, we strongly recommend that you back up your Confluence Home Directory and database. See the documentation on backing up your Confluence site. If you are using an external database, perform a database backup.
  2. If your version of Confluence is earlier than 4.3, read the  release notes and upgrade guides for all releases between your version and the latest version.
    In particular:
    • Read the Confluence 3.5 Upgrade Notes.
    • If you are upgrading from 2.1 or earlier, read the 2.2 release notes too.
    • If your site contains links to a file system (for example [\\\C:\Foo\Bar\foobarpreso.ppt] these may break when upgrading to Confluence 5.0.  We recommend that you upgrade directly to Confluence 5.0.3. Refer to  CONF-23575 - Getting issue details... STATUS  for more details.
  3. Download the latest version of Confluence.
  4. Follow the instructions in the Upgrade Guide.
  5. "Create" option not activated on some sites: If the global default language of your Confluence site is not English, you will need to install a patch in the form of a plugin. For more information, please refer to this article in our knowledge base: Nothing Happens when Users Click on The "Create" Button.

Confluence 5 にアップグレードすると、アップグレードの完了後、すべてのユーザーの個人情報のインデックスが再構築されます。大規模なユーザー ベース (> 10,000) のインストールでは、アップグレード直後の新しいコンテンツのインデックス作成に多少の遅延が発生する可能性があります。これによって、アップグレード直後の短期間、検索ストリームとアップデート ストリームが古くなる場合があります。

 

既知の問題のチェックとConfluenceアップグレードのトラブルシューティング

After you have completed the steps required to upgrade your Confluence installation, check all the items on the Confluence post-upgrade checklist to ensure that everything works as expected. If something is not working correctly, please check for known Confluence issues and try troubleshooting your upgrade as described below:

  • Check for known issues. Sometimes we find out about a problem with the latest version of Confluence after we have released the software. In such cases we publish information about the known issues in the Confluence Knowledge Base. Please check the known issues for the relevant release on this page of the Knowledge Base and follow the instructions to solve the problem.
  • Check for answers from the community. Other users may have encountered the same issue. You can check for answers from the community at Atlassian Answers.
  • Did you encounter a problem during the Confluence upgrade? Please refer to the guide to troubleshooting upgrades in the Confluence Knowledge Base.

  • If you encounter a problem during the upgrade and cannot solve it, please create a support ticket and one of our support engineers will help you.
  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.