Confluence のアップグレード

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

始める前に

• Check your Confluence licence  is valid.
  To check go to Confluence Admin > License Details 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.

• アップグレードするバージョンおよびスキップするバージョンについて、リリースノートとアップグレードノートを確認してください。

• Java のバージョン、アプリケーション サーバー、OS、データベース、ブラウザがサポート対象であるか確認してください。
  サポート対象のプラットフォームおよびConfluence サポート期間終了のお知らせで、最新の要件を確認してください。

• ご利用のデータベースにつき、最新のデータベース セットアップガイドで、データベースの設定が正しいか、確認してください。新しい設定要件が追加されている可能性があります。データベース設定を確認してください。

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

• インスタンスに影響するおそれのある既知の問題を確認してください。
  アップグレードするバージョンについて、既知の問題をConfluence ナレッジベースで確認します。また、サポート対象の外部データベースに関連する既知の問題についても、データベースのトラブルシューティングで確認してください。

• 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.
• 異なる OS または異なる場所のファイルに移行する場合は、手動でアップグレードする必要があります。
• 別のデータベースに移行する場合は、まずインストーラーを使用してアップグレードし、次に別のデータベースへの移行に記載のある手順通りに実施する必要があります。
• 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.
• 組み込みデータベースを使用している場合は、 別のデータベースへ移行する前にアップグレードする必要があります。このデータベースは評価用であるため、本番環境での利用は推奨できません。詳細は、組み込み HSQLDB データベースを参照してください。

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

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

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

1. 現在の Confluence の本番環境のスナップショットをテストサーバーに作成します。作成方法は、サーバー間での Confluence の移行を参照してください。
2. 手順にしたがって、クローン環境でアップグレードを実行します。
3. 本番環境でアップグレードを進める前に、非サポート対象のアドオン（プラグイン）およびカスタマイズ（テーマやレイアウト）をすべてテストします。

ステップ 3 バックアップ 

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

• your external database
  You must perform a manual backup of your external database and confirm that the backup was created properly. If you are unfamiliar with the backup-restore facilities of your database, you can simply restore the backup to a different system to ensure the backup worked before proceeding.
• your Confluence Home directory
  The Confluence Home directory is the folder where Confluence stores its configuration information, search indexes and page attachments.  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.
  if you store attachments outside the Confluence Home directory, you should also backup your attachments directory. 
• 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.
• Unable to proceed with upgrade because of a conflict with anti virus
  Some anti-virus or other Internet security tools may interfere with the Confluence upgrade process and prevent the process from completing successfully, particularly if you run Confluence as a Windows service. If you experience or anticipate experiencing such an issue with your anti-virus / Internet security tool, disable this tool first before proceeding with the Confluence upgrade.
• Database does not support online backups
  The upgrade wizard will prompt you to backup your database using your database's backup utilities. If your database does not support online backups, stop the upgrade process, shut down Confluence, perform your database backup and then run the installer again to continue with the upgrade.