Confluence 5.0 アップグレード ノート

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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 では、コンテンツを作成する新しい方法、再設計されたヘッダー、新しいサイドバー、およびサイトのルック & フィールに対するその他の変更など、ユーザー エクスペリエンスに対する重要な変更が多数導入されました。組織内でこの新しい変更を認識した上で、準備して対応する必要があります。「Confluence 5 への準備」をサポートするガイドを用意しました。

また、Confluence バージョン 3.5 以前からアップグレードする場合は、Confluence 編集エクスペリエンスに大幅な変更があることにご注意ください。「Confluence 4 への準備」のガイドをご参照ください。

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

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

既定のテーマを使用しているすべてのスペースで [参照] メニューがなくなりました。これは、新しいサイドバーのオプションに置き換えられます。この変更に対する Confluence ユーザーの準備に関するヘルプについては「Confluence 5 への準備」をご参照ください。

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

  • オプションは、サイドバーの「スペースツール」に表示されるようになりました。プラグインの作成者が Confluence 5.0 のプラグインをすでに更新している場合は、そのプラグインが表示されます。
     
  • これらのオプションは、アップグレード後にヘルプ メニュー (Confluence ヘッダーからアクセス可能) に表示される場合があります。これは、プラグインの作成者がまだ Confluence 5.0 のプラグインをまだ更新していない場合に発生します。プラグイン開発者向けのガイドライン: Confluence 5.0 における参照メニューとスペース ツールの変更をご参照ください。

ダッシュボードの変更

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

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

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

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

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

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

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

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

スペース管理者がスペース サイドバーからロゴをトリミングして更新するための簡単な方法を追加しました。スペース内のページに移動して [サイドバーを設定] を選択します。次に、スペース名の横にある編集アイコン を選択します。ステップバイステップの手順については「スペースのロゴを変更する」をご参照ください。

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

「既定のスペース コンテンツ」オプションが管理者コンソールから削除されました。新しいサイト テンプレートを使用して、新しいサイトと個人用スペースのホームページ コンテンツをカスタマイズできます。これらのサイト テンプレートは、管理コンソールの [グローバル テンプレート] 画面で利用できます。アップグレード タスクは、既存のスペース コンテンツ (古い Wiki マークアップ エディターを使用して作成) を新しい形式に変換します。「既定のスペース コンテンツ」テンプレートは、カスタム コンテンツを内部に含む「編集済み」と表示されます。

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

Confluence ダッシュボードの左上に表示されるウェルカム メッセージは、管理コンソールの [グローバル テンプレート] 画面で利用できるサイト テンプレートを使用してカスタマイズできるようになりました。つまり、リッチ テキスト エディターを使用してコンテンツを編集できます。アップグレード タスクは、既存のウェルカム メッセージ (古い Wiki マークアップ エディターを使用して作成) を新しい形式に変換します。既定のウェルカム メッセージ テンプレートは、カスタム コンテンツを内部に含む「編集済み」と表示されます。

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

初期設定では、Confluence ダッシュボードの左側のサイト ウェルカム メッセージに、管理者向けのクイック スタート ガイドが表示されるようになりました。ダッシュボードのこのセクションは、Confluence 管理者とシステム管理者にのみ表示されます。Web インターフェイスからは設定できませんが、「ダッシュボードのスタート ガイドのカスタマイズ」で説明されているように、サイト レイアウトを編集して更新または削除できます。

Confluence 5.0 には、アプリケーション リンクのバージョン 3.10.6 が含まれています。「Confluence 管理者」権限を持つユーザーは、アプリケーション リンクを設定できるようになりました。たとえば、Confluence を Jira にリンクさせられます。以前は、この機能を実行するには「システム管理者」権限が必要でした。Confluence 管理者は、アプリケーション リンクとプロジェクト リンクを追加、変更、削除できます。ただし、Confluence 管理者は、アプリケーション リンクに OAuth 認証のみを設定できます。

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

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

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

Easy Reader テーマを使用している場合は、サイトと影響を受けるスペースは Confluence の既定のテーマに移動されます。下記をご参照ください。

サードパーティのテーマを使用している場合は、Confluence 管理コンソールのプラグイン マネージャーを使用して、Confluence 5.0 と互換性のあるテーマの新しいバージョンがあるかどうかをご確認ください。「アプリケーション更新に伴うアプリの互換性を確認する」をご確認ください。

カスタム テーマを適用した場合は、Confluence 5.0 にアップグレードする前に Confluence の既定のテーマに戻すことをお勧めします。「サイトにテーマを適用する方法」または「スペースにテーマを適用する方法」をご参照ください。

カスタム CSS を適用した場合は、アップグレード後に CSS を更新する必要があります。「Confluence を CSS でスタイリングする」ためのガイドをご確認ください。Confluence 5.0 では、アプリケーションに多くの新しい CSS ルールが導入されているほか、既存の CSS が大幅に変更されています。これらの変更を反映するには、CSS を更新する必要があります。CSS を引き続き機能させるためには、Confluence に追加されたすべての新しいルールが CSS で適切にオーバーライドされていることを確認する必要があります。さらに、CSS を精査して、不要になったオーバーライドを削除することをお勧めします。

カスタム デコレーターまたはレイアウトを適用した場合は、アップグレード後にそれらを更新する必要があります。サイトとスペースの各レイアウトをカスタマイズするためのガイドをご確認ください。Confluence 5.0 では、多くの新しいマークアップ パターンが導入されています。これらのパターンの一部またはすべてが配置されていない場合は、カスタム デコレーターが想定どおりに表示されないことがあります。デコレーターを更新する最適な方法は、Confluence 5.0 で使用されているデコレーターと比較して、同じパターンに従うようにデコレーターを適応させることです。

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 からドキュメント用テーマを削除する予定です。

この変更に興味をお持ちでフィードバックをお寄せになる場合は、ブログ投稿「ドキュメンテーション テーマを既定のテーマにマージする計画の事前警告」にコメントを追加してください。特に、ドキュメンテーション テーマで使用している機能と最も重視している機能についてのご意見をお待ちしております。

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

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

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

これによる影響

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

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

Office コネクタの設定は、以前は Confluence 管理者とシステム管理者の両方が使用できました。Confluence 5.0 以降、このアクションはシステム管理者のみが利用できるようになりました。「グローバル権限の概要」をご参照ください。

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

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 以降が必須

Confluence の Team Calendars アドオンを使用している場合、Team Calendars 3.1 以降にアップグレードする必要があります。このアドオンの以前のバージョンは、Confluence 5.0 の新しいデザインでは動作しなくなります。

Google Gears のサポート終了

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

java 6 サポートの終了

以前お知らせしたように、このリリースから、Java 6 (JRE および JDK 1.6)をサポートしなくなります。「Confluence のサポート終了のお知らせ」を参照してください。

Tomcat 5.5 のサポートの終了

以前お知らせしたように、このリリースから、Tomcat 5.5.x をサポートしなくなります。「Confluence のサポート終了のお知らせ」を参照してください。

アップグレード手順

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

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

  1. Before you upgrade, we strongly recommend that you back up your Confluence Home and other important directories and database. See the documentation on backing up your Confluence site. If you are using an external database, perform a database backup.
  2. ご利用の Confluence のバージョンが 4.3 より前の場合は、そのバージョンから最新バージョンまでのすべてのリリースリリース ノートとアップグレード ガイドをお読みください。
    主なガイドは次のとおりです。
    • Confluence 3.5 アップグレード ノート」をお読みください。
    • 2.1 以前のバージョンからアップグレードする際には「2.2 リリース ノート」もお読みください。
    • サイトにファイル システムへのリンクが含まれている場合は ([\\\C:\Foo\Bar\foobarpreso.ppt] など)、Confluence 5.0 にアップグレードするとリンクが壊れる可能性があります。Confluence 5.0.3 に直接アップグレードすることをお勧めします。詳細は CONF-23575 - 課題情報を取得中... ステータスをご参照ください。
  3. Download the latest version of Confluence.
  4. Follow the instructions in the Upgrade Guide.
  5. "作成" オプションが一部のサイトで有効にならない: Confluence サイトのグローバル既定言語が英語でない場合は、プラグインの形式でパッチをインストールする必要があります。詳細については、ナレッジ ベースで記事「ユーザーが "作成" ボタンをクリックしても何も起こらない」をご参照ください。

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

 

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

Confluence インストールのアップグレードに必要な手順が完了したら、「Confluence のアップグレード後のチェックリスト」のすべての項目を確認し、すべてが期待どおりに動作していることを確認します。適切に動作していないところがあれば、既知の Confluence の問題を確認し、以下に記載されているアップグレードのトラブルシューティングを試してください。

  • 既知の問題を確認してください。Confluence のリリース後にその最新バージョンで問題が見つかる場合があります。そのような場合、既知の問題に関する情報を Confluence ナレッジベースで公開します。
  • コミュニティで回答をご確認ください。他のユーザーに同じ問題が発生している可能性があります。アトラシアン コミュニティ で回答を確認できます。
  • Confluence のアップグレード中に問題が発生しましたか?Confluence ナレッジベースで、アップグレードのトラブルシューティングを行うガイドを参照してください。

  • アップグレード中に問題が発生して解決できない場合は、サポート チケットを作成してください。弊社のサポート エンジニアがお手伝いします。
最終更新日 2016 年 5 月 27 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.