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

Confluence リリース ノート

このページの内容

お困りですか?

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

コミュニティに質問

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

アップグレードノート

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

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

共同編集の準備

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

個人用下書きの編集不可

Collaborative editing introduces a new type of draft which contains everyone's unpublished changes for a page. Your users will be able to access the content of their previous personal drafts at Profile > Drafts, but they'll need to manually copy the contents to a page if they want to resume editing.  When your users edit a page, they'll see a fresh draft of the page, not their personal draft (if one exists). 

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

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

監査に関する考慮事項 

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

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

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 のインストール/アップグレード後、以下を実施する必要があります。

  • Head to  > General Configuration > Collaborative editing and check the Synchrony status is running
  • ブラウザーが 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 ターミネーションを行うリバースプロキシを使用した例です。それぞれの図をクリックすると拡大表示されます。 

Internal Synchrony proxy (default configuration):

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

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

Documentation theme removal 

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

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

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

CSS クラスの変更

If you have customized the space CSS to change the appearance of the documentation theme, you'll probably need to make some changes to your CSS, as some class and ID names are different between the two themes.  For example, instead of specifying #splitter-sidebar , you'll need to use .acs-side-bar .

Problems with customized layouts

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

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

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

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

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

  1. Switch to another theme temporarily.
    If you're unable to use the space navigation, use this URL, replacing YOURSPACEKEY with the space key for the space.

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

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

Layouts can also be customised for the entire site. Head to  > General Configuration > Layouts if you need to reset the layout for the entire site.

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

If you're unable to reset the layouts via the Confluence UI, you can remove the affected layouts directly in the database. Be sure to make a full database backup before you try this.

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

Select *
FROM DECORATOR
ORDER BY SPACEKEY

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

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

The space jump macro was provided by the documentation theme and will not be available in Confluence 6.0. If you've used this macro on a page or in the header or footer of a space, it will show the following error after the upgrade  unknown macro: {spacejump}.  

To find out whether the Space Jump macro is used on any pages in your site before you upgrade, enter macroName:spacejump into the search bar. We'll list all pages containing the macro (it won't search the sidebar, header, or footer unfortunately). 

Old dashboard has been removed

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 はサポートされません。
  • End of support for Android 4.0.3 (Ice Cream Sandwich) mobile browser
    From this release onward we no longer support the default browser provided with Android 4.0.3 (Ice Cream Sandwich). We have added support for the default browser provided with current Android versions from 4.4 (KitKat) and later.
  • 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. Before you upgrade, we strongly recommend that you back up your installation directory, home directory and database.
  3. ご使用の Confluence のバージョンが 5.10 より前の場合、そのバージョンから最新バージョンまでのすべてのリリースリリースノートおよびアップグレードガイド読んでください。
  4. Confluence の最新バージョンをダウンロードします。
  5. アップグレードガイド」の説明に従ってください。

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

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

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

  • アップグレード中に問題が発生し、解決できない場合、サポートチケットを作成して、当社のサポートエンジニアのサポートを受けてください。
最終更新日 2019 年 3 月 25 日

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

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