Confluence 7.2 アップグレード ノート
以下は、Confluence 7.2 にアップグレードする際の重要な注意事項です。このリリースの新機能と改善点の詳細については、「Confluence 7.2 リリース ノート」を参照してください。
On this page:
Using Companion app in single sign-on environments
If you've configured single sign-on (SSO) in such a way that your reverse proxy redirects the requests to your SSO gateway, and only successfully authenticated requests ever reach Confluence, your users won't have been able to use Atlassian Companion app. This is because the Atlassian Companion app uses JWT tokens to authenticate requests, and only Confluence can authenticate these requests, not your SSO authenticator.
To make sure requests from the Atlassian Companion app can be authenticated, you can now configure your reverse proxy to always allow requests from the following URLs:
<base-url>/rest/token-auth/api/*
<base-url>/download/token-auth/attachments/*
<base-url>/plugins/servlet/imgFilter*
<base-url>/rest/analytics/1.0/publish/bulk
(this is only necessary if you have opted in to data collection)
If an unauthenticated user tries to access these URLs directly, they would be redirected to the Confluence login screen. They wouldn't be able to access any content or download files while unauthenticated.
Chart macro maximum size
We now limit the maximum height and width of the Chart macro. This will help avoid performance problems if a user accidentally enters a very large value, as we'll automatically resize the chart to 3000px by 3000px. You can modify the default maximum using the following system properties:
confluence.chart.macro.width.max
confluence.chart.macro.height.max
Changes to Data Center clustering
As mentioned in the release notes, you can now choose to deploy Data Center as a standalone (non-clustered) installation. If you're currently running Confluence Data Center in a cluster, there's no need to do anything. If you'd prefer to make the switch to a standalone setup, you can follow the process described in Adding and Removing Data Center nodes.
Minor change to Lucene implementation
We've made a change to the implementation of the term filter. A bitset is now only created when the number of matches is large enough to benefit from it. This helps reducing unnecessary CPU and memory usage and avoid bottlenecks. The threshold can be changed via the confluence.search.lucene.termFilterBitSetThreshold
system property, but we don't expect you should need to do this.
MySQL 8
We've added support for MySQL 8. If you plan to upgrade, you should upgrade Confluence first, then upgrade your database.
You'll need to switch to the latest database driver, see Database JDBC Drivers. If you use a datasource connection you'll also need to update the driver classname to com.mysql.cj.jdbc.Driver
.
Upgrade task to remove temporary files
When files are added to a page via the REST API an attachment-*.tmp
temporary file is created in the <install-directory>/temp
folder. To prevent this temp directory from growing too large over time, we now clean up these temp files at the end of the REST request.
We've also implemented an upgrade task to clean up these files when you upgrade to Confluence 7.2. The upgrade task could take some time in sites that have a large number of files in the <install-directory>/temp
directory.
Upgrading from 6.x or earlier
(server.xml で) JNDI ロケーションを使用してメール サーバーをセットアップしている場合は、<confluence-install>\confluence\WEB-INF\lib
から <confluence-install>\lib
に 2 つの追加 jar ファイルを移動させる必要があります。
javax.activation-x.x.x.jar
javax.activation-api-1.2.0.jar
6.3 以前からのアップグレード
Confluence 6.3 以前からアップグレードする場合、スペース ディレクトリにスペースが表示されない既知の課題があります。これを修正するには、アップグレード後にサイトを再インデックスする 必要があります。
サポート対象プラットフォームの変更
In this release we have:
- Added support for MySQL 8.
サポート終了のお知らせ
Advance Notice: End of support for Internet Explorer 11
アトラシアンでは、最新の Web 標準を引き続き活用して、すべての製品で改善された機能と最高のユーザー エクスペリエンスを提供できるようにするため、Internet Explorer 11 のサポートを終了することにしました。
Confluence 7.4.x (Enterprise Release) will be the last release to support Internet Explorer 11.
Advance Notice: End of support for several databases
Confluence 7.3.x will be the last release to support the following databases:
- PostgreSQL 9.4
- MySQL 5.6
- Oracle 12c R1
- Microsoft SQL Server 2012
Confluence 7.4.x (Enterprise Release) will be the last release to support the following databases:
- Microsoft SQL Server 2014
- PostgreSQL 9.5
これらの告知の詳細については「Confluence のサポート終了のお知らせ」をご確認ください。
インフラストラクチャの変更
変更の詳細については、「Confluence 7.2 の準備」を参照してください。
既知の問題
- Some plugins will not work with Confluence 7.2 running on MySQL 8. See CONFSERVER-59391.
- There's a known issue in JavaMail 1.6.2 which may affect you if you set up your mail server in the
server.xml
. See CONFSERVER-59040. - 一部のブラウザーでは、Atlassian Companion アプリを使用してファイルを編集することはできません。「Confluence Server では Internet Explorer、Edge、Firefox、または Safari で Atlassian Companion アプリを使用してファイルを編集することはできない」を参照してください。
- Windows で AdoptOpenJDK jdk8u212 を使用しているときに Synchrony が開始されない。CONFSERVER-58784 で回避策をご確認ください。
- 管理コンソールにアクセスできるユーザーを制御するために Apache を使用している場合、構成を更新する必要があります。アトラシアンが推奨する構成を「Confluence の管理インターフェイスへのアクセスの制御に Apache を使用する」でご確認ください。
- 読み取り専用モードで
<shared-home>/confluence.cfg.xml
への書き込みを試行するが、ファイルが共有ホーム ディレクトリに存在しない、既知の問題があります。この問題は、過去に Confluence 6.0 以前からアップグレードしたサイトに適用されます。「Confluence Data Center 6.10 にアップグレードしたあとに、access.mode を共有の confluence.cfg.xml ファイルに保存できなかった旨のエラーが表示される」をご確認ください。 - Confluence が依存するフォントの一部が古い Linux ディストリビューションで使用できない既知の問題があります。詳細については、「フォントの欠落により、Confluence の UI で CAPTCHA、マクロ、図のテキストが文字化けする」を参照してください。
- アップグレード後に hibernate dialect プロパティが誤って保持される既知の問題があります。バージョン 2.4 以前から Confluence をお使いの場合、Confluence 6.x にアップグレードする前に
<confluence-home>/confluence.cfg.xml
ファイルで hibernate dialect を確認し、"イベント" 列に指定されたサイズ (16777215) が Confluence で許可される任意のデータ型 (8000) の上限を超えている旨のエラーを回避する必要があります。 - Confluence を Oracle データベースでアップグレードする場合の既知の問題があります。Oracle ユーザーは Confluence のバージョンを 6.1 以降にアップグレードする前に、ドライバを 12.2.0.x にアップグレードする必要があります。詳細については、「バージョン 6.1.x へのアップグレードの際、「ORA-01000: maximum open cursors exceeded」というエラーが発生して失敗する」を参照してください。
アップグレード中に問題が発生し、解決できない場合、サポート チケットを作成してください。弊社のサポート エンジニアがお手伝いします。
アップグレード手順
注: まずテスト環境をアップグレードします。アップグレードを本番環境に適用する前に、テスト環境でアップグレードをテストしてください。
すでに Confluence のバージョンを実行している場合、以下の手順に従って最新バージョンにアップグレードしてください。
- > [サポート ツール] > [ヘルス チェック] の順に移動し、ライセンスの有効性、アプリケーション サーバー、データベースのセットアップなどを確認します。
- アップグレードする前に、インストール ディレクトリ、ホーム ディレクトリ、およびデータベースをバックアップすることを強くおすすめします。
- ご使用の Confluence のバージョンが 7.0 より前の場合、そのバージョンから最新バージョンまでのすべてのリリースのリリース ノートおよびアップグレード ガイドをお読みください。
- Confluence の最新バージョンをダウンロードします。
- 「アップグレード ガイド」の説明に従います。
- Confluence のアップグレード後のチェックを使用して、すべての機能が意図したように動作していることを確認します。
アップグレード後の設定ファイルの更新
server.xml, web.xml
、setenv.bat
/setenv.sh
、confluenceinit.properties
などの設定ファイルの内容は定期的に変更されます。
アップグレード時には、以前のインストールのファイルで単純に上書きするのではなく、これらのファイルへの追加 (プロキシ設定、データソース、JVM パラメーターなど) を手動で再適用することをおすすめします。これを行わない場合、これまでの改善が失われてしまいます。