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

このページの内容

お困りですか?

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

コミュニティに質問

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

このページの内容

Latest Companion App required

We've made significant changes to how you edit files using Atlassian Companion. When you upgrade to Confluence 7.3, you'll need to make sure your users are also running the latest version of Companion App (1.0.0 or later).  

Earlier versions (0.6.2 and earlier) will not work with Confluence 7.3. 

PostgreSQL 10 のサポート

We've added support for PostgreSQL 10.  If you plan to upgrade, you should upgrade Confluence first, then upgrade your database.  

See pg-upgrade in the PostgreSQL 10 documentation for information on how to upgrade your database. Make sure you back up your database, Confluence installation directory and Confluence home directory before you begin. We strongly recommend you test your changes in a staging environment first. 

After upgrading, we recommend you run ANALYZE. Analyze collects statistics about contents of tables in the database, which the query planner can use to help determine the most efficient execution plans for queries.

There's also a known issue where Confluence won't start with PostgreSQL 10 in Amazon RDS. See  CONFSERVER-59243 - Getting issue details... STATUS  for more information and a workaround. 

Oracle 19c のサポート

We've added support for Oracle 19c.  If you plan to upgrade, you should upgrade Confluence first, then upgrade your database.  

See Database Upgrade Guide in the Oracle 19c documentation for information on how to upgrade your database. Make sure you back up your database, Confluence installation directory and Confluence home directory before you begin. We strongly recommend you test your changes in a staging environment first. 

We've tested Oracle 19c with both the ojdbc8.jar and ojdbc10.jar drivers. 

Emoji support for MySQL

We have added support for utf8mb4 collation for MySQL 5.7 and 8.0. This will allow people to use 4-byte UTF-8 characters in Confluence pages. 

If you're running MySQL 5.7 or 8.0, and you're ready to migrate your database to use utf8mb4 collation, see How to Fix the Collation and Character Set of a MySQL Database. There are some things you need to know before you start:

  • Back up your database first. We also strongly recommend testing the migration in a test site, as migrating the tables may take some time for large databases.
  • If you're running MySQL 5.7, you'll need version 5.7.9 or later. 
  • You'll need to check the character set specified in the my.cnf  or my.ini  file on your MySQL Server. If character_set_server  is not set to utf8mb4, and you can't change this (for example if it is required for a database used by another application) you may need to add the connectionCollation=utf8mb4_bin parameter to your connection URL.  See the Connector/J 8.0 or Connector/J 5.1 documentation for more information. 

    手順について

    1. Confluence を停止します

    2. <local-home>/confluence.cfg.xml ファイルを編集します

    3. 次の行を編集して、以下の例のようにデータベース接続 URL に connectionCollation=utf8mb4_bin パラメーターを追加します。 

    <property name="hibernate.connection.url">jdbc:mysql://yourhost:3306/confluence?connectionCollation=utf8mb4_bin</property>

    4. Confluence を再起動します。 

If you're running MySQL 5.6, you will need to upgrade to MySQL 5.7.9 or later, or to 8.0.x, and then migrate your database to utfmb4. If you're not able to upgrade MySQL at this time, you should continue to use utf8. If a 4-byte character is used we'll prompt the user to remove the character before they can save, preventing encoding problems. As Confluence 7.3 is the last version to support MySQL 5.6, it's a good time to start planning your upgrade. 

MySQL health check problem

There is also a known issue with Atlassian Troubleshooting and Support Tools, where some MySQL health checks always fail. We recommend updating the Atlassian Troubleshooting and Support tools plugin to version 1.23.2 or later to avoid this problem. 

Known issues with Inspect Permissions and People who can view

In Confluence 7.3.0 to 7.3.3, the Inspect permissions and People who can view features don't currently take into account some external directory and nested group scenarios. 

各シナリオの詳細については、「Confluence 7.3 の [権限を点検] で誤った情報が返される」をご参照ください。 

If your site is impacted by these problems, we suggest you temporarily disable the Inspect Permissions - Gatekeeper system plugin that provides these features until we can provide a fix, to prevent users relying on inaccurate information. See  CONFSERVER-59513 - Getting issue details... STATUS

tip/resting Created with Sketch.

Update  

We've improved how the People who can view and Inspect Permissions features work with complex external directory scenarios.

From Confluence 7.3.4 the following scenarios are fully supported:

  • Nested groups 
  • Non-aggregating group membership
  • Disabled directories
  • Disabled user accounts in one, but not all, directories

Note: when you inspect permissions for a specific group, we only report the permissions granted directly to that group. We'll warn you if the group is nested, but won't show permissions granted to any parent groups (you'll have to inspect these separately).  This limitation only applies when you inspect permissions for a group. When you inspect permissions for a user, we display permissions granted by all groups, including parent groups. 



Ultimate Permission Manager app

If you currently use the Meta-Inf Ultimate Permission Manager app, that was acquired by Atlassian, there's some things you need to know before you upgrade. 

  • If you have a Confluence Data Center license, when you upgrade to Confluence 7.3, the Ultimate Permission Manager app will be disabled automatically. This is intentional, so we can give you access to "Inspect permissions" and "People who can view", which are the equivalent features in Confluence Data Center. 
  • If you have a Confluence Server license, when you upgrade to Confluence 7.3, you'll be able to continue to use the Ultimate Permission Manager app until your app license expires. You won't see the new "People who can view" option, but will use the equivalent feature provided by the app. 
  • If you have a Confluence Server license, and your Ultimate Permission Manager app license has expired, we recommend you disable or uninstall the Ultimate Permission Manager app, in order to get access to the "People who can view" feature provided by Confluence Server. 

Disable People who can view

If you currently hide the People directory, or other places where users may be able to see a list of other users, you may not want the People who can view feature. To disable it for your whole site:

  1. <base-url>/admin/plugins/gatekeeper-plugin/global/configuration.action に移動します
  2. Deselect the Allow who can view option and save the change. 

Show all pages in the page tree

In the sidebar, we now load a maximum of 200 pages at each level of the page hierarchy. A Show all pages button will appear if there are pages that have not been loaded. This change was made to improve your site performance. 

Disable legacy Edit in Office dark feature

If you previously enabled the legacy Edit in Office functionality, you will need to remove the dark feature flag in order to try our improved Companion app experience. 

To remove the dark feature flag, go to <base-url>/admin/darkfeatures.action and click Remove next to enable.legacy.edit.in.office

Enable Edit in Office in the Confluence UI

If you're unable to use Companion app, you can now enable the legacy Edit in Office functionality from the Confluence UI (previously this was done using a dark feature flag).  Go to General Configuration > Office Connector. 

Java 11 now bundled

In this release we've bundled the AdoptOpenJDK 11 JRE. This JRE is used when you install or upgrade Confluence using the installer. If you've installed Confluence manually you can either continue to use Java 8 or switch to Java 11. See Change the Java vendor or version Confluence uses to find out how to switch your Java version.

Some of the Java arguments used in our setenv.sh  / setenv.bat  files are no longer recognised in Java 11. Make sure you apply any customizations manually when you upgrade, don't simply copy over your old setenv file (or existing Java options if you run Confluence as a service). 

変更内容...

Java 11 では、次の引数が置き換えられます。

-XX:-PrintGCDetails -XX:+PrintGCDateStamps -XX:-PrintTenuringDistribution -Xloggc:$LOGBASEABS/logs/gc-`date +%F_%H-%M-%S`.log -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=2M
-Djava.locale.providers=COMPAT,SPI 

置き換え後は次のようになります。

-Xlog:gc+age=debug:file="%atlassian_logsdir%\gc-%atlassian_timestamp%.log"::filecount=5,filesize=2M
-Djava.locale.providers=JRE,SPI,CLDR

We also recommend adding the following new arguments:

-XX:+IgnoreUnrecognizedVMOptions 
-Djdk.tls.server.protocols=TLSv1.1,TLSv1.2 
-Djdk.tls.client.protocols=TLSv1.1,TLSv1.2    

IgnoreUnrecognizedVMOptions  means that any unrecognised Java 8 arguments will be ignored. You won't need to remove these manually. 

There are known issues with TLS 1.3, so we recommend TLS 1.1 and 1.2 for now.

詳細な情報については、Java 11 ドキュメントの「Enable Logging with the JVM Unified Logging Framework」を参照してください。 

If you have added additional arguments, you may need to check that these are still available in Java 11, as they may cause errors when you start Confluence. 

Change to Universal Plugin Manager (UPM)

Updated  

From Confluence 7.3 you can no longer disable many system apps, or app modules. These system apps are required for Confluence to operate properly, and can cause problems when disabled. 

Waiting for the next Long Term Support release?

Confluence 7.4 will be the next Long Term Support release. See the announcement on Atlassian Community.

Upgrading from 6.x

If you set up your mail server using a JNDI location (in the server.xml ), there are now two additional jar files that you'll need to move from <confluence-install>\confluence\WEB-INF\lib to <confluence-install>\lib : 

  • 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:

  • PostgreSQL 10.
  • Oracle 19c.

Reminder about operating system support

Microsoft ended support for Windows 7 on January 14. You should only install and use Confluence on operating system versions that have active vendor support.

サポート終了のお知らせ

Advance Notice: End of support for Internet Explorer 11

アトラシアンでは、最新の Web 標準を引き続き活用して、すべての製品で改善された機能と最高のユーザー エクスペリエンスを提供できるようにするため、Internet Explorer 11 のサポートを終了することにしました。 

Confluence 7.4.x (Long Term Support 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 (Long Term Support release) will be the last release to support the following databases:

  • Microsoft SQL Server 2014
  • PostgreSQL 9.5

これらの告知の詳細については「Confluence のサポート終了のお知らせ」をご確認ください。 

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

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

Known issues

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

アップグレード手順

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

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

  1. > [サポート ツール] > [ヘルス チェック] の順に移動し、ライセンスの有効性、アプリケーション サーバー、データベースのセットアップなどを確認します。
  2. アップグレードする前に、インストール ディレクトリ、ホーム ディレクトリ、およびデータベースをバックアップすることを強くおすすめします。
  3. ご使用の Confluence のバージョンが 7.2 より前の場合、そのバージョンから最新バージョンまでのすべてのリリースリリース ノートおよびアップグレード ガイドお読みください。
  4. Confluence の最新バージョンをダウンロードします。
  5. アップグレード ガイド」の説明に従います。
  6. Confluence のアップグレード後のチェックを使用して、すべての機能が意図したように動作していることを確認します。

アップグレード後の設定ファイルの更新

server.xml, web.xmlsetenv.bat/setenv.shconfluenceinit.properties などの設定ファイルの内容は定期的に変更されます。 

アップグレード時には、以前のインストールのファイルで単純に上書きするのではなく、これらのファイルへの追加 (プロキシ設定、データソース、JVM パラメーターなど) を手動で再適用することをおすすめします。これを行わない場合、これまでの改善が失われてしまいます。

最終更新日 2020 年 8 月 31 日

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

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