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

このページの内容

お困りですか?

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

コミュニティに質問

以下は、Confluence 6.0 へのアップグレード時の重要注意事項です。このリリースの新機能と改善点に関する詳細は、「Confluence 6.0 リリースノート」を参照してください。

アップグレード ノート

Confluence 6.0 はメジャーアップグレードです

これらのアップグレードノートを熟読し、フルバックアップを行い、非本番環境でアップグレードをテストしてから、本番サイトのアップグレードを実行してください。リバースプロキシを使用している場合、いくつか設定を変更する必要もあります。

共同編集の準備

共同編集は偉大な方法によってユーザーの作業方法を変更します。ユーザーがこの変更の準備をするのを支援するため、この機能を最大限活用するのに役立つ共同編集のガイドをお送りします。 

個人用下書きの編集不可

共同編集に導入された新しいタイプの下書きでは、ページに対する全員の未公開の変更が含まれます。ユーザーは [プロファイル] > [下書き] の順に移動して、以前の個人用下書きのコンテンツにアクセスできます。編集を再開する場合は、コンテンツをページに手動でコピーする必要があります。ユーザーがページを編集すると、個人の下書き (存在する場合) ではなく、このページの新しい下書きが表示されます。 

下書きのバージョン履歴を保存しない

共同編集は常に保存されていますが、未公開の変更のバージョンは保存されません。変更を破棄する場合や、古いページバージョンを復元する場合、既存の公開済みバージョンへのロールバックのみ可能です。未公開の変更は、変更を破棄するか、旧バージョンを復元すると失われます。 

監査に関する考慮事項 

当社は、一部のお客さまにとって監査が主要な考慮事項であることを理解しています。共同編集には非常に細分性の高い監査機能がまだありません。ページ履歴内のすべてのページ変更は、今のところ、各特定ページの変更者ではなく、そのページの発行者に帰属します。

お客様のサイトでこれが問題になる場合、アップグレード後は共同編集をオフにすることをお勧めします。

Confluence 5.x から Confluence 6.1 以降にアップグレードする場合、下記のシステム要件の一部はこのバージョンにのみ適用され、6.1 以降へのアップグレードには適用されないため、Confluence 6.1 アップグレードノートを参照することをお勧めします。

共同編集のシステム要件

アップグレードする前に以下の要件を満たしていることを確認する必要があります。  

  • メモリおよび CPU:以前の Confluence リリースよりも多くのリソースをサーバーに与える必要がある場合があります。Confluence をインストールすると、Synchrony (共同編集に必要)はサーバー上で別のプロセスとして動作するように設定されます。Synchrony デフォルトの最大ヒープ サイズは 1GB です(Confluence の要件の最上位)。 
  • WebSocket:WebSocket 接続を許可するように、ファイアウォール / プロキシを設定する必要があります。 
  • プロキシ:プロキシサーバーを挟んで Confluence を稼動させている場合、ポート 8091 で稼動する Synchrony を設定に追加する必要があります。詳細については、「Confluence のプロキシリクエストに NGINX を使用する方法」(NGINX 1.3 以降が必要) または「Apache で mod_proxy を使用する」(Apache httpd 2.4.10 以降が必要) を参照してください。 
  • SSL 終端:SSL 終端はご使用のロードバランサー、プロキシサーバー、またはゲートウェイ (使用している場合) で設定する必要があります。これにより、Synchrony は Web ブラウザーからの XHR 要求を受け入れることができます。設定例については、「Apache で mod_proxy を使用する」(2.4.10 以降が必要) または「SSL を使用して NGINX のバックグラウンドで Confluence を実行する」を参照してください。Synchrony は、HTTPS 直接接続をサポートしていません。 
  • Database drivers: You must use a supported database driver. Collaborative editing will fail with an error if you're using an unsupported or custom JDBC driver (or driverClassName in the case of a JNDI datasource connection). See Database JDBC Drivers for the list of drivers we support.
  • データベース接続プール:ご使用のデータベースは、Confluence と Synchrony の両方をサポートできるように十分な接続数を許可する必要があります (既定値は最大プールサイズの 15)。  

短期間で上記の要件を満たすことができない場合、サイトでの共同編集を無効にする機能が用意されています。 

インストール/アップグレード後に共同編集が動作しているか確認する

Confluence のインストール/アップグレード後、以下を実施する必要があります。

  • [管理] > [一般設定] > [共同編集] に移動し、Synchrony のステータスが実行中であることを確認します。 
  • ブラウザーが Synchrony に接続できることを確認するために任意のページを編集します。リバースプロキシを使用している場合、これを実行する際は必ずそのプロキシ経由で Confluence にアクセスし、直接アクセスしないでください。 

リバースプロキシの設定が誤っている可能性があるため、Synchrony が実行されないか、エディターでエラーが発生する場合、推奨される次の手順について、「共同編集のトラブルシューティング」を参照してください。 

既知のブラウザー拡張子の非互換性

エディターと相互作用する一部のサードパーティ製ブラウザー拡張子 (Grammarly など) は、共同編集が正常に機能しない場合があります。Confluence サイトでのみ Grammarly を無効にする方法については「(アーカイブ済み) Confluence 共同編集により Grammarly 拡張子がブロックされる」をご参照ください。 

Data Center インストールに関する柔軟性

Confluence Server をインストールすると、Synchrony (共同編集に必要) はサーバー上で別のプロセスとして動作するよう自動的に設定されます。

Data Center の場合、Synchrony を自分で設定することを許可することで、完全な制御を取得します。これによって、同じノード上に Confluence として Synchrony を配置したり、必要な数のノードと共に独自のクラスター内に配置することができます。 

Synchrony クラスタの設定方法については、「Confluence Data Center のインストール」を参照してください。 

リバースプロキシで必要な変更 

リバースプロキシで Confluence を実行している場合、Synchrony 用にプロキシ設定を一部変更する必要があります。これは共同編集を行う上で必須です。プロキシは WebSockets (Apache httpd 2.4.10 以降、NGINX 1.3 以降、 IIS 8.0 以降など) をサポートしている必要があります。IIS を使用している場合、Application Request Routing 3.0 (ARR) がインストールされていることを確認する必要があります。 

いくつかの設定例を「Apache で mod_proxy を使用する」および「Confluence でプロキシ要求に対して NGINX を使用する方法 」で紹介しています。同じ原則が Microsoft Internet Information Services (IIS) など、他のプロキシにも当てはまります。   

下記の図は、2 つの構成例を示しています。1 つ目は Confluence の内部プロキシを使用した例、2 つ目は SSL ターミネーションを行うリバースプロキシを使用した例です。それぞれの図をクリックすると拡大表示されます。 

内部同期プロキシ (既定の構成)

リバースプロキシを使用:

プロキシおよび SSL の考慮事項に関する詳細は、「共同編集の管理」を参照してください。

ドキュメンテーション テーマの削除 

Confluence 6.0 にアップグレードすると、ドキュメント用テーマはご使用のサイトから削除されます。現在ドキュメント用テーマを使用しているスペースがある場合、自動的に既定のテーマがオンになります。

カスタマイズ済みのドキュメント用テーマ (サイドバー、ヘッダー、またはフッターへの Wiki マークアップの追加など) がある場合、その Wiki マークアップは既定テーマのサイドバー、ヘッダー、およびフッターに配置されます。アップグレード後はスペースサイドバーの表示が少し異なる可能性がありますが、ほとんどの場合、大幅に変わることはありません。  

ドキュメント用テーマについて不明な点がある場合は、ドキュメント用テーマの移行に関する FAQ の回答を参照してください。 

CSS クラスの変更

スペース用 CSS をカスタマイズしてドキュメント用テーマの外観を変更している場合は、2 つのテーマにある同じ名前のクラスと ID は別物なので、CSS に変更を加える必要がある場合があります。たとえば、#splitter-sidebar を指定する代わりに .acs-side-bar を使用する必要があります。

Problems with customized layouts

Confluence UI を介してカスタマイズ済み既定のテーマをレイアウトする場合、ドキュメント用テーマを使用していたスペースに既定のテーマを再適用すると、スペースの外観が異なって表示されたり、壊れたりします。 

この問題は、Confluence 5.0 へのアップグレード前にカスタマイズ済みサイトまたはスペースに既定のテーマレイアウトを設定しており、その後ドキュメント用テーマを有効にしたお客様に影響を与える可能性があります。 

問題が生じた場合、壊れたレイアウトをリセットする必要があります。 
  

UI を介してカスタマイズ済みレイアウトをリセットします...

この方法は、サイトで複数のテーマを利用できる場合にのみ役立ちます。これを実行するには、システム管理者グローバル権限が必要です。

  1. 一時的に別のテーマに切り替えます。
    スペース ナビゲーションを使用できない場合、次の URL で YOURSPACEKEY を対象のスペースのスペース キーと置き換えたものを使用します。

    http://<yoursite>/spaces/choosetheme.action?key=YOURSPACEKEY
  2. スペース管理オプションで [レイアウト] (利用可能な場合) に移動するか、次のリンクで YOURSPACEKEY を対象のスペースのスペース キーと置き換えたものを使用します。

    http://<yoursite>/spaces/listdecorators.action?key=YOURSPACEKEY
  3. カスタマイズ済みテンプレートの横にある既定値に戻すを選択します。
  4. テーマページに戻り、もう一度既定のテーマを適用してみてください。

サイト全体のレイアウトもカスタマイズできます。サイト全体のレイアウトをリセットする必要がある場合は、[管理] > [一般設定] > [レイアウト] に移動します。

データベース内のカスタマイズ済みレイアウトを削除する...

Confluence UI を介してレイアウトをリセットできない場合は、影響を受けたレイアウトをデータベースで直接削除できます。これを実行する前に、データベースを必ずフル バックアップしてください。

まず、次のクエリを使用してカスタマイズ済みレイアウトを特定します。

Select *
FROM DECORATOR
ORDER BY SPACEKEY

これで、影響を受けたスペースのレコードを選択して削除できます。

スペースジャンプマクロは削除

スペース ジャンプ マクロはドキュメント用テーマが提供していたため、Confluence 6.0 では利用できなくなります。このマクロをページ上またはスペースのヘッダーやフッターで使用している場合は、アップグレード後にエラー unknown macro: {spacejump}. が表示されるようになります。  

アップグレード前にスペース ジャンプ マクロがサイト内のいずれかのページで使用されているかどうかを確認するには、検索バーに macroName:spacejump と入力します。マクロを含むすべてのページがリストされます (申し訳ありませんが、サイドバー、ヘッダー、フッターは検索されません)。 

古いダッシュボードを削除しました

Confluence 5.9 では、まったく新しいダッシュボードデザインを導入しましたが、一時的に古いダッシュボードに戻すオプションもユーザーに提供していました。今回のリリースでは、古いダッシュボードを完全になくしました。

ダッシュボードの外観をカスタマイズしている場合、影響する可能性があるダッシュボード変更点の詳細については、Confluence 5.9 アップグレードノートのダッシュボードの変更に関するセクションを参照してください。

32 ビットインストーラーが使用不可に

Windows および Linux については、32-bit インストーラーの提供を終了しました。  

32-bit オペレーティングシステムで Confluence を稼動している場合、アーカイブファイルメソッドを使用してアップグレードできます。詳細は、「Windows で Zip ファイルから Confluence をインストール」または「Linux でアーカイブファイルから Confluence をインストール」を参照してください。 

インフラストラクチャの変更

開発者向けの情報

このリリースでは、アドオンに影響を与える可能性のある多くの重要なライブラリー アップグレードがありました。 

変更の詳細については、「Confluence 6.0 の準備」を参照してください。

サポート終了のお知らせ

  • Internet Explorer 10 のサポート終了
    以前にお知らせしたとおり、このリリース以降、Internet Explorer 10 はサポートされません。
  • Android 4.0.3 (Ice Cream Sandwich) モバイル ブラウザーのサポート終了
    このリリース以降、Android 4.0.3 (Ice Cream Sandwich) で提供される既定のブラウザーはサポートされなくなりました。現在の Android バージョン 4.4 (KitKat) 以降で提供される既定のブラウザーのサポートが追加されました。
  • MySQL 5.5 のサポート終了
    以前お知らせしたとおり、このリリースから MySQL 5.5 はサポートされなくなります。
  • 事前通知:ファイル表示マクロ
    既にお知らせしているとおり、ファイル表示マクロ (Office Word、Office PowerPoint、Office Excel、PDF) のサポートを正式に終了しました。これらのマクロは、引き続き Confluence 6.0 で使用可能です。いつ削除されるかは未定ですが、その時期が来たら様々なお知らせをしていく予定です。

既知の問題

アップグレード手順

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

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

  1. Go to  > General Configuration > Support Tools > Health Check to check your license validity, application server, database setup and more.
  2. アップグレードする前に、インストール ディレクトリ、ホーム ディレクトリ、およびデータベースをバックアップすることを強くおすすめします。
  3. ご使用の Confluence のバージョンが 5.10 より前の場合、そのバージョンから最新バージョンまでのすべてのリリースリリース ノートおよびアップグレード ガイドお読みください。
  4. Confluence の最新バージョンをダウンロードします。
  5. アップグレード ガイド」の説明に従います。

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

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

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

  • アップグレード中に問題が発生し、解決できない場合、サポート チケットを作成してください。弊社のサポート エンジニアがお手伝いします。
Last modified on Mar 25, 2019

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

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