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

2018-01-31 (Wed)  •  By 伊藤  •  ドキュメント  •  Confluence アップグレード ノート 翻訳

本記事は、Confluence 管理ドキュメント「Confluence 6.7 Upgrade Notes 」の弊社翻訳版です。原文と差異がある場合は、原文の内容が優先されます。

このページには Confluence 6.7 へのアップグレードに関する重要な注意点が記載されています。本リリースに関する新しい機能および改善点の詳細については、「Confluence 6.7 リリース ノート」を参照してください。

アップグレード ノート

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

Confluence 5.x からアップグレードを行う場合は、以下のアップグレード ノートを熟読してください。また、完全バックアップを作成し、検証環境でアップグレードのテストを行ってから本番環境をアップグレードしてください。

新しいヘルス チェックの導入

データベース接続プールに対して HTTP スレッド プール (MaxThreads) が十分でない場合に警告をする新しいヘルス チェックが追加されました。アップグレード後に初めて Confluence を起動した際にこのヘルス チェックが実行されます。

このヘルス チェックを無視することもできます。しかし、デバッグや管理目的の場合、10 データベース接続を追加するか、もしくはデータベース接続よりも 25% 多くすることを推奨します (値の大きい方を選択します)。

配色の変更

Confluence 既定の配色が更新され、より明るいモダンな色使いになりました。(グローバル レベル、もしくは個別スペース レベルで) 配色をカスタマイズしている場合、その配色は変更されることはありません。カスタマイズされていない色のみが更新されます。

編集画面のフォント カラー ピッカーで選択可能な色には変更がありません。

番号付き列オプションの移動

表に番号付き列を自動で追加するオプションに対して表ツールバー 上に専用アイコンが割り当てられました。従来、このオプションは [表設定 (Table Settings)] メニューからアクセスしていました。

新しいアイコンの導入

今回のリリースでは多くのアイコンがすっきりとした新しい見栄えになっています。また、一部のアイコンはより大幅に変更されています。参考までに “変更の前と後” を紹介します。

ワークボックス通知
ページ
ブログ記事
コメント
番号付き列

アップグレード後の構成フィールドの更新

server.xmlsetenv.bat / setenv.sh、および confluenceinit.properties などの構成ファイルのコンテンツは、時折変更されます。

アップグレードの際、これらファイル (プロキシ構成、データーソース、JVM パラメーターなど) へのすべての追加を 手動で再適用する ことを推奨します。それらファイルを既存インストレーションから取得したファイルで上書きしないでください。さもないと弊社が適用した改善点を失うことになります。

Confluence 5.x からのアップグレード

共同編集は Synchrony を利用して実現しています。Confluence サーバーをインストールする際、Synchrony はサーバー上の別プロセスとして実行するように構成されます。

Confluence 5.x からアップグレードを行う場合、注意すべき点がいくつかあります。

  • メモリおよび CPU : 以前の Confluence リリースに比べ、サーバーにより多くのリソースを割り当てる必要があります。Confluence をインストールする際、Synchrony (共同編集に必須です) はサーバー上の別プロセスとして実行するように構成されます。Synchrony の最大ヒープ サイズの既定値は 1GB です (Confluence の要件とは別です)。
  • WebSockets : 共同編集は WebSockets で最適に動作します。お使いのファイアウォール/プロキシが WebSocket 接続を許可するように設定してください。
  • SSL Termination : SSL はロード バランサー、プロキシ サーバー、またはゲートウェイで終了するように設定します。その理由ですが、Synchrony は HTTPS の直接接続をサポートしていないためです。
  • データベース ドライバー : サポートされているデータベース ドライバーを必ず使用してください。サポートされていないドライバー、またはカスタム JDBC ドライバー (または JNDI データベース接続の場合は driverClassName) を使用している場合、共同編集はエラーを引き起こします。サポートされているドライバーの一覧については、「Database JDBC Drivers 」を参照してください。
  • データベース接続プール : Confluence および Synchrony の両方をサポートするために、お使いのデータベースに十分な接続を許可します (最大プール サイズの既定値は 15)。

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

開発者の方へ

変更に関する詳細については、「Preparing for Confluence 6.7 」を参照してください。

サポート終了のお知らせ

  • 事前通告 : PostgreSQL 9.2 に関するサポートの終了
  • Confluence 6.7.x は PostgreSQL 9.2 をサポートする最終リリースです。

詳細については、「End of Support Announcements for Confluence 」を参照してください。

既知の問題

  • Confluence が使用するいくつかのフォントが古い Linux ディストリビューションでは利用できないという既知の問題があります。「Confluence UI shows garbled or corrupt text on CAPTCHA, macros and/or diagrams due to missing fonts 」を参照してください。
  • アップグレード後、”Hibernate Dialect” プロパティが正しく保持されないという既知の問題があります。エラー「Upgrading fails with ERROR The size (16777215) given to the column ‘event’ exceeds the maximum allowed for any data type (8000) in Confluence 」を回避するために、Confluence をバージョン 2.4 以前からお使いのユーザーは Confluence 6.x へのアップグレード前に <confluence-home>/confluence.cfg.xml の Hibernate Dialect を確認してください。
  • Oracle データベースを使用している Confluence のアップグレードに関する既知の問題があります。Oracle ユーザーは、ドライバーを 12.2.0.x にアップグレードしてから Confluence 6.1 以降にアップグレードしてください。詳細については、「Upgrade to version 6.1.x Failed With Error “ORA-01000: maximum open cursors exceeded” 」を参照してください。

アップグレード手順

注意 : 最初に検証環境をアップグレードしてください。検証環境でアップグレードのテストを行った後に本番環境での作業を行ってください。

すでに Confluence をお使いの場合、以下の指示に従って最新バージョンにアップグレードしてください。

  1. 歯車アイコン > 一般設定 > サポート ツール > ヘルス チェック の順に移動し、ライセンスの有効性、アプリケーション サーバー、データベース セットアップ、その他を確認します。
  2. アップグレード前にインストール ディレクトリ、ホーム ディレクトリ、ならびにデータベースのバックアップを作成することを強く推奨します。
  3. お使いの Confluence がバージョン 6.5 よりも古い場合、そのバージョンと最新バージョン間の すべてのリリース に関する リリース ノートおよびアップグレード ノート を参照してください。
  4. 最新バージョンの Confluence を ダウンロード します。
  5. アップグレード ガイド の指示に従います。

Confluence アップグレードに関する既知の問題とトラブルシューティングの確認

Confluence インストレーションのアップグレードに必要な手順を完了した後、Confluence アップグレード後チェックリスト のすべての項目を確認してください。すべてが想定通りであることを確認します。正しく動作していない項目がある場合、以下の Confluence の既知の問題を確認し、トラブルシューティングを試してださい。

  • 既知の問題を確認する。最新バージョンの Confluenceがリリースされた後に問題が発見されることがあります。その場合、Confluence ナレッジベース に既知の問題として情報が公開されます。
  • コミュニティの回答を確認する。他のユーザーが同じ問題を経験している場合があります。Atlassian Answers 上のコミュニティの回答を確認してください。
  • Confluence アップグレード中に問題が発生した場合。Confluence ナレッジベースの「Upgrade Troubleshooting 」のガイドを参照してください。

アップグレード中に問題が発生し、かつそれを解決できない場合は、サポート チケット を作成してください。弊社サポート エンジニアがお手伝いします。


Related Articles

お気軽にお問い合わせください

お問い合わせ