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

2017-12-12 (Tue)  •  By 伊藤  •  ドキュメント  •  Confluence アップグレード ノート 翻訳

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

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

アップグレード ノート

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

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

SQL Server ドライバーの更新

オープンソースの Microsoft SQL Server 用 jTDS Driver は公式の Microsoft SQL Serve 用 JDBC Driver に置き換えられました。

jTDS ドライバーを使用して Microsoft SQL Server に接続している場合、Confluence 6.6 へのアップグレード後に新しいドライバーへ自動的に切り替わります。

何らかの原因でこれに失敗する場合 (例えば、データソース接続を使用している場合)、この変更を手動で行う必要があります。切り替え方法については、この ナレッジベース記事 を参照してください。

Data Center をお使いの場合は、Synchrony も新しいドライバーを使用していることを確認する必要があります。詳細については、この ナレッジベース記事 を参照してください。

パフォーマンスの改善

ユーザーを検索する操作に関する CPU およびメモリの負荷を削減する変更が行われました。例えば、誰かをメンションする、ページを共有する、およびブループリント フィールドやマクロ パラメーターでユーザーを選択するなどの操作です。

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

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.6 」を参照してください。

サポート終了のお知らせ

以前にもご案内したとおり、以下のサポートが終了しています。

  • Microsoft SQL Server 用 jTDS Driver はサポート対象から外れました。
  • JUnit レポート マクロはサポート対象から外れました。このマクロは今後のリリースで廃止されます。

詳細については、「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

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

お問い合わせ