作業を開始する前に

1. アップグレードと同時に使用するデータベースを変更する場合は、アップグレードを先に実行することを推奨します。その後、異なるデータベースへの移行に従ってください。
2. Note that you need current software maintenance to perform the upgrade.
3. アップグレード開始前に、ライセンスサポートが有効期間内にあることを確認してください。
4. If your current license has expired but you have a new license with you, please update your license in Confluence before performing the upgrade.
   If you forget to do this and your license has expired, you will receive errors during the upgrade process. Refer to the instructions on upgrading beyond current license period.
5. インストールする新しい Confluence のリリースノートと、インストールをスキップするバージョンの中にメジャーバージョンがあった場合はそのメジャーバージョンのアップグレードノートの内容を確認してください。ユーザーの Confluence システムに対して大きな影響のある変更が含まれている可能性もあるため、これらのノートを確認することは重要です。最近の Confluence メジャーバージョンのアップグレードノートは、アップグレードノート概要をご覧ください (各々のアップグレードノートは、対応するリリースノートが親になっています)。
6. システム環境 (例えば、データベースシステム、オペレーティングシステム、アプリケーションサーバーなど) が引き続き Confluence のシステム要件を満たしていることを確認してください。新しいバージョンは過去のバージョンとはシステム要件が異なる可能性があります。
7. Confluence EAR-WAR 版をご利用の場合は、Confluence の EAR-WAR 版をインストールで Confluence 実行に必要な追加作業の有無を確認してください。
8. 外部データベースをご利用の場合は、そのデータベースの既知の問題点をすべて調べておく必要があります。さらに、Confluence のデータベースコネクタープリンシパル (データベースユーザーアカウント) にデータベーススキーマを変更できる権限が付与されていることを確認してください。
9. Note which plugins (add-ons) are installed and enabled on your current Confluence site. Please verify whether a compatible version of the plugin is available in the version of Confluence you are upgrading to. This information is available via the Confluence Upgrade Check in the plugin administration section of Confluence. See the documentation: Checking app compatibility with application updates. You can also check the respective home pages for these plugins on the Atlassian Plugin Exchange. Once you have confirmed the availability of compatible versions, you should upgrade your plugins after successfully upgrading Confluence.  Please test these first by applying them to the latest Confluence version in a test environment.
10. Confluence のカスタマイズを行っている場合は、それが最新バージョンにも対応しているか否かを確認してください。例えばレイアウトの変更や自分だけのカスタムテーマの適用を行っている場合は、先にテスト環境でこれらを Confluence 最新バージョンに適用するテストを行っておいてください。Confluence に設定したカスタマイゼーションの内容を確認してください。
11. ウィルス対策ツールやインターネットセキュリティーツールの中には Confluence アップグレードの障害となるものがあり、アップグレードが成功しないことがあります。お使いのウィルス対策ツールやインターネットセキュリティーツールが過去にそのような問題を起こしたことがある場合やそのような懸念がある場合は、Confluence のアップグレードに進む前にこれらのツールを無効化してください。
12. アップグレード後に Confluence がインデックスの再構築を行う場合があります。これが起こった場合、アップグレード後のサーバー負荷が増加します。本番環境用途の Confluence をアップグレードする場合は、必ず他のユーザーの利用時間外に行ってください。

バックアップ

Confluence のアップグレードを実行する前に、以下に示すバックアップ作業を行う必要があります:

1. Back up your Confluence Home directory.The Confluence Home directory is the folder where Confluence stores its configuration information, search indexes and page attachments. If you are using the embedded HSQLDB database supplied for evaluation purposes, the database files are also stored in this directory.
   Tip: Another term for 'Home directory' would be 'data directory'. The location of the Home directory is stored in a configuration file called confluence-init.properties, which is located inside the confluence/WEB-INF/classes directory in your Confluence Installation directory. The Confluence installer will automatically prompt you to run a backup, storing the files in a .zip archive at the same level as your Confluence Home directory.
2. Back up your database. Perform a manual backup of your external database before proceeding with the upgrade, and double check that the backup was actually created properly. If you are not a database expert, or unfamiliar with the backup-restore facilities of your database, simply restore the backup to a different system to ensure the backup worked before proceeding. This recommendation is generally a good best practice. Surprisingly, many companies get in trouble for broken database backups because they skip this basic but vital "smoke test" of the operation.
   The 'embedded database' is the HSQLDB database supplied with Confluence for evaluation purposes. You don't need to back it up since it is stored in the Confluence home directory. You should not be using this database for production systems at all, so if you happen to be using HSQLDB in a production system, please migrate to a proper database before the upgrade. Read about the various shortcomings of HSQLDB.
3. Back up your Confluence Installation directoryor your Confluence webapp (if you are using Confluence EAR-WAR edition). The Confluence installer will automatically back up these files, storing the files in a .zip archive at the same level as your Confluence installation directory. The 'Confluence Installation directory' is the directory into which the Confluence application files and libraries have been unpacked (unzipped) when Confluence was installed. Confluence does not modify or store any data in this directory. This directory is also sometimes called the 'Confluence Install directory'.

テスト環境におけるアップグレードテスト

     1. サーバー間での Confluence の移行に従って、本番環境用 Confluence 環境の現在のスナップショットをテストサーバーに作成してください。

      そのクローン環境でアップグレードを実行してください。

      本番環境用サーバーをアップグレードする前に、サポート外のプラグイン (アドオン) やカスタマイゼーションがあればそれをすべて Confluence の新しいバージョンでテストしてください。サポート対象およびサポート外のプラグインもご覧ください。