このページでは、Windows または Linux で Confluence を最新版にアップグレードする方法を説明します。

始める前に

• Check your Confluence licence is valid.
  To check go to  > Atlassian Support Tools > Health Check and make sure the license support period has not expired. If your support period has expired renew your licence and reapply it before proceeding with the upgrade.

• Read the Release Notes and Upgrade Notes for both the version you are upgrading to, and any versions you are skipping.

• Check that your Java version, application server, operating system, database and browsers are supported.
  See Supported Platforms and End of Support Announcements for Confluence to confirm latest requirements. You can also go to > Atlassian Support Tools > Health Check.

• Check the latest database setup guide for your database and ensure that the database is configured correctly. There may be new configuration requirements. See Database Configuration.

• Check the compatibility of any add-ons.
  Some add-ons may not yet be compatible with the latest version of Confluence. See Checking app compatibility with application updates to find out how to check this in the Universal Plugin Manager.

• Check for any known issues that might affect your instance.
  See the Confluence Knowledge Base for known issues for the version you are upgrading to and Database Troubleshooting for known issues related to supported external databases.

• Make a note of any modifications to your Confluence instance (for example layouts or a custom theme).
  Any customisation you wish to maintain will need to be reapplied after upgrading. See Additional steps where customisations are present.

Step 1 アップグレード パスと方法を決定する

Confluence の現行バージョンとアップグレード後のバージョンに有効なアップグレード パスを検索します。

次の表を参考にして、ご利用の現行バージョンから Confluence 最新バージョンへの最も有効なアップグレード パスを決定してください。現在インストールされているバージョンを表の左列で探し、推奨パスにしたがいます。
  

アップグレード方法を決定する要因は以下の通りです：

• Are upgrading from a version earlier than Confluence 3.5 you will need to upgrade manually. You can contact Support for help determining an appropriate upgrade path.
• Are moving to a different operating system or file location you should upgrade manually.
• Are moving to a different database you should upgrade using the installer first and then follow the procedure outlined in migrating to a different database.
• Have a clustered instance of Confluence you should follow the procedure outlined in Upgrading a Confluence Cluster.
• Are running the EAR-WAR edition you should check Installing the Confluence EAR-WAR Edition to see if any additional steps are required.
• Are using the embedded HSQLDB database you should migrate to a different database before upgrading. This database is supplied for evaluation purposes only and is not recommended for production environments. See embedded HSQLDB database for more information.

あるいは、下記の説明にしたがって Windows または Linux インストーラーを使用し、Confluence をアップグレードします。

Step 2 テスト環境で Confluence をアップグレードする

本番インスタンスを再作成し、クローン環境でアップグレードのテストを実施することを強く推奨します。

1. Create a snapshot of your current production Confluence environment on a test server - see Moving Confluence Between Servers for how to do this.
2. 手順にしたがって、クローン環境でアップグレードを実行します。
3. Test all your unsupported add-ons (plugins) and any customisation (for example custom themes and layouts) with the new version before proceeding with the upgrade in your production environment.

ステップ 3 バックアップ 

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

• 外部データベース
  外部データベースのバックアップを手動で実施し、そのバックアップが適切に作成されたか確認してください。データベースのバックアップや復元機能にあまり詳しくない場合は、次に進む前にそのバックアップを異なるデータベース システムで復元すれば、バックアップが正常に行われたたか確認できます。
• Confluence ホーム ディレクトリ
  Confluence ホーム ディレクトリとは、Confluence がその構成情報、検索用インデックス、およびページ添付ファイルを保存するフォルダーです。ホーム ディレクトリの場所の情報は、Confluence インストール ディレクトリ下の confluence/WEB-INF/classes ディレクトリにある confluence-init.properties という名称の設定ファイルに保存されています。
  添付ファイルを Confluence ホーム ディレクトリの外部で保存している場合は、添付ファイル ディレクトリのバックアップも実施する必要があります。 
• the Confluence installation directory or Confluence webapp (if you are using the EAR-WAR edition)
  This is where the Confluence application files and libraries were unpacked (unzipped) when Confluence was originally installed. Confluence does not modify or store any data in this directory.

インストールウィザードは、Confluence ディレクトリのバックアップをインストールの一環で実施しますが、アップグレードの開始前に手動でバックアップを実施する必要があります。 

Step 4 本番環境で Confluence をアップグレードする

1. Download the appropriate Windows or Linux installer from the Confluence Download Center.
2. インストーラーを起動します：
   • Windows ユーザー： .exe ファイルを実行します。
     アップグレードウィザードでコンピュータへの変更の許可を求められたら「はい」を選択します。「はい」を選択しないと、ご利用の OS に対するインストールウィザードのアクセスが制限され、その後のインスト―ルオプションも制限されます。
   • Linux users: open a Linux console and change directory (cd) to the '.bin' file directory and execute the '.bin' file. 
     If the '.bin' file is not executable after downloading it, make it executable, for example chmod a+x atlassian-confluence-5.4.1-x64.bin (specify the exact filename of the installer you downloaded).
3. インストールウィザードにしたがってアップグレードを実施します。注意事項：
   1. プロンプトが表示されたら、既存の Confluence インストールのアップグレードを選択します (Linux ユーザーの場合、オプション 3)。
      
   2. ウィザードが提示した既存の Confluence インストール ディレクトリが正しいか、確認してください。あなたが同一マシンで複数の Confluence インストールを実行中の場合は、特に重要です。
   3. 「Confluence ディレクトリをバックアップ」のステップでは、必ず「Confluence ホームをバックアップ」を選択します。Confluence ホームディレクトリとインストールディレクトリのバックアップを Zip ファイルで作成します。これを実施することを強く推奨します。
   4. このインストールウィザードは Confluence インストールウィザードのカスタマイズを通知します。アップグレードが完了すると、カスタマイズを手動で再適用する必要があるため、アップグレードを進める前に通知されたカスタマイズを記録してください。
   5. アップグレードが完了しない場合、外部データベースのバックアップを実施し、プラグインの互換性を確認するよう、ウィザードから求められます。データベースがオンラインバックアップをサポートしていない場合、この時点でインストールウィザードを停止する必要があります。
4. ウィザードは Confluence インスタンスをシャットダウンし、アップグレードを開始します。アップグレードが完了したら、Confluence を再起動し、ブラウザで立ち上げアップグレードが成功したか確認します。

アップグレードの実行中に、ウィザードは既存の Confluence インストールから下記のファイルを移行します。

• TCP port values in your server.xml file. 
• Custom values in your confluence-init.properties (confluence.home property) and setenv.sh / setenv.bat files (JAVA_OPTS parameters) 

 Other configurations or customisations (including any other modifications in the server.xml file) are not migrated during the upgrade and need to be reapplied manually. See below for more information.

カスタマイズがある場合の追加ステップ

インストールウィザードがカスタマイズを通知する機能は Confluence インストールインスタンスのインストール方法によって異なります：

• 現在の Confluence インスタンスがインストーラーを使用してインストールされていた場合、ウィザードは Confluence インストール ディレクトリ全体をチェックします。
• If your current Confluence instance was installed manually it will only check the confluence subdirectory of the Confluence Installation directory. The installation wizard will not notify you of modifications in any other directory, for example modifications to start-up scripts under the bin directory or modifications to the server.xml file (such as an SSL configuration). 

カスタマイズがある場合、アップグレードの完了後、以下のステップを実行する必要があります：

1. アップグレードされた Confluence インスタンスを停止します。
2. 関連するファイルのカスタマイズを、アップグレードされた Confluence インストール ディレクトリ に再適用します。
3. アップグレードされた Confluence インスタンスを再起動します。

Confluence に変更があり、それによりカスタマイズが使用できない可能性もあるため、本番インスタスでアップグレードを実施する前に、テスト インスタンスでカスタマイズのテストを実施することを強く推奨します。

トラブルシューティング

アップグレード中に発生しやすい問題：

• Cannot proceed with upgrade because license has expired
   If your licence has expired and was not renewed and reapplied before upgrading you will receive errors during the upgrade process. See upgrading beyond current license period for information on how to resolve this problem.
• ウィルス対策ソフトとの競合によりアップグレードを続行できない
  Windows で Confluence を実行している場合は特に、ウィルス対策ツールやインターネット セキュリティ ツールが障害となり Confluence アップグレードに成功しないことがあります。お使いのウィルス対策ツールやインターネット セキュリティ ツールで過去に同じような問題があった場合や、このような問題が懸念される場合は、Confluence のアップグレードを開始する前にこれらのツールを無効化してください。
• データベースがオンラインバックアップをサポートしない
  アップグレードウィザードに、データベース バックアップ ユーティリティを使用してデータベースのバックアップを取るよう指示されます。データベースがオンラインバックアップをサポートしない場合、アップグレード プロセスを停止し、Confluence をシャットダウンし、データベース バックアップを取ってからインストールを再実行して、アップグレード を継続します。
• Upgrade is taking a very long time
  If you have a very large database (i.e. database backups take a very long time to complete), setting the confluence.upgrade.recovery.file.enabled system property to false will speed up the upgrade process. It should be used only when there is a process to back up database and verify the backup before performing an upgrade.

You can also refer to the Upgrade Troubleshooting guide in the Confluence Knowledge Base, or check for answers from the community at Atlassian Answers.