Confluence のアップグレード

On this page:

アップグレード概要

Linux と Windows インストーラーのアップグレード機能は、以下の課題を自動化してくれます:

1. アップグレードされる、既存の Confluence インストレーションの インストール および ホーム ディレクトリをバックアップ。
2. Installs Confluence 4.2 whilst migrating the following from your existing Confluence installation to the new Confluence 4.2 installation:
   
   • TCP port values in your existing Confluence installation's server.xml file. Be aware that other configurations or customisations in this file are not migrated during upgrade, and will need to be re-applied.
   • Custom values in your existing Confluence installation's confluence-init.properties (confluence.home property) and setenv.sh / setenv.bat files (JAVA_OPTS parameters) 

The upgrade feature detects and notifies you of any files in the confluence subdirectory of your existing Confluence Installation Directory which have been deleted, added or modified from a 'default' Confluence installation. This informs you of any customisations you will need to migrate manually over to your upgraded Confluence installation directory. Note that modifications to files in directories other than confluence will not be detected when you upgrade to Confluence 4.0, for example any modifications to start-up scripts under the bin directory will not be detected. The next time you upgrade (e.g. to version 4.0.1) the the upgrade feature will cover modifications across the whole Confluence Installation Directory.

注意:

• アップグレード プロセスでは、あなたのデータベースのバックアップユーティリティを利用して、データベースのバックアップを行う事が要求されます。データベースがオンラインバックアップをサポートしない場合、アップグレード プロセスを停止し、Confluence を終了させ、データベースバックアップを実行してから、引き続きアップグレード プロセスを再開して頂けます。
• If you have made customisations to your server.xml file or any other files in your Confluence installation directory which are not handled by the upgrade wizard, these must be re-applied manually.
• 添付ファイルおよびインデックスファイルが Confluence ホームディレクトリ外に存在する場合、これらディレクトリのバックアップは手動で行う必要があります。

アップグレードの実行

お使いの OS のアップグレード説明を参照してください:

Windows 上で Confluence をアップグレード

1. Download the Confluence 'Windows Installer' (.exe) file (for the new version of Confluence) from the Confluence Download Center.
2. Run the '.exe' file to start the upgrade wizard.
   If a Windows 7 (or Vista) 'User Account Control' dialog box requests if you want to allow the upgrade wizard to make changes to your computer, specify 'Yes'. If you do not, the installation wizard will have restricted access to your operating system and any subsequent installation options will be limited.
3. 「Confluence をアップグレードしますか?」のステップでは、「既存の Confluence インストレーションをアップグレードする」オプションを選択します。
4. In the 'Existing Confluence installation directory' field, specify the Confluence Installation Directory of your Confluence installation to be upgraded.
   The upgrade wizard will attempt to find an existing Confluence installation and use its location to pre-populate this field. However, always verify this location, particularly if you have multiple Confluence installations running on the same machine.
5. この後のアップグレード ウィザードのステップでのオプション指定や実行は次の通りです:
   1. At the 'Back up Confluence directories' step, ensure the 'Back up Confluence home' option is selected. This creates 'zip' archive file backups of your existing Confluence Installation and Confluence Home Directories in their respective parent directory locations.
      Please Note:
      • このオプションの選択を強く推奨します!
   2. At this point, the upgrade wizard notes any customisations in your existing Confluence Installation Directory which it cannot automatically migrate to your upgraded Confluence installation. If you are notified by the installer about any files containing such customisations, please make a note of the locations of these files as you will need to manually migrate their customisations (which are not mentioned in the overview above) to your upgraded Confluence installation. One relatively common customisation that the upgrade wizard cannot automatically migrate is an SSL configuration defined in the conf/server.xml file of the Confluence Installation Directory. Please Note: when upgrading from the version that was not installed by the installer the customisations can only be detected  in the confluence subdirectory of your existing Confluence Installation Directory. Modifications to files in directories other than confluence will not be detected when you upgrade, for example, modifications to conf/server.xml. However the next time you upgrade (e.g. to version 4.1.1) the upgrade feature will cover modifications across the whole Confluence Installation Directory.
   3. At the 'Upgrade Check List' step, back up your external database and check that any non-bundled plugins will be compatible with your upgraded Confluence version. You may have already conducted the latter (in step 5 of the Before You Start section above).
   4. Upon clicking 'Next', your existing Confluence installation will be shut down if it is still running. The upgrade wizard will then:
      1. 既存の Confluence インストレーションをバックアップ。
      2. 既存の Confluence インストール ディレクトリのコンテンツを削除。
      3. Confluence の新バージョンを、既存の Confluence インストール ディレクトリにインストール。
      4. Starts your new (upgraded) Confluence installation.
         If you noted any files that contain customisations which must be migrated manually to your upgraded Confluence installation (above), then:
         1. アップグレードされた Confluence インストレーションを停止します。
         2. これらファイルにおけるカスタマイズ内容を、アップグレードされたConfluence インストール ディレクトリに移行します。
         3. アップグレードされた Confluence インストレーションを再開します。
6. アップグレードウィザードの最終ステップでは、アップグレードされた Confluence インストレーションをブラウザで起動するオプションを選択して、アップグレードを確認します。

おめでとうございます。Windows における Confluence インストレーションのアップグレードが完了しました！

Linux 上での Confluence のアップグレード

1. Download the appropriate Confluence 'Linux 64-bit / 32-bit Installer' (.bin) file that suits your operating system (for the new version of Confluence) from the Confluence Download Center.
2. Open a Linux console and change directory (cd) to the '.bin' file's directory.
   If the '.bin' file is not executable after downloading it, make it executable, for example:
   chmod a+x atlassian-confluence-X.Y.bin
   (where X.Y represents your version of Confluence)
3. “.bin” ファイルを実行し、アップグレード ウィザードを起動します。
4. 新しい Confluence のインストールを作成するか、既存のインストレーションをアップグレードするかの選択を促された場合、「既存の Confluence インストレーションのアップグレード」オプションを選択します。
5. Specify the Confluence Installation Directory of your Confluence installation to be upgraded.
   The upgrade wizard will attempt to find an existing Confluence installation and will provide its location as a choice. However, always verify this location, particularly if you have multiple Confluence  installations running on the same machine.
6. この後のアップグレード ウィザードのステップでのオプション指定や実行は次の通りです:
   1. Choose the option to back up Confluence's directories. This creates 'zip' archive file backups of your existing Confluence Installation and Confluence Home directories in their respective parent directory locations.
      Please Note:
      • このオプションの選択を強く推奨します!
      • At this point, the upgrade wizard notes any customisations in your existing Confluence Installation Directory which it cannot automatically migrate to your upgraded Confluence installation. If you are notified of any files containing such customisations, please make a note of the locations of these files as you will need to manually migrate their customisations (which are not mentioned in the overview above) to your upgraded Confluence installation. One relatively common customisation that the upgrade wizard cannot automatically migrate is an SSL configuration defined in the conf/server.xml file of the Confluence Installation Directory. Please Note: when upgrading from the version that was not installed by the installer the customisations can only be detected  in the confluence subdirectory of your existing Confluence Installation Directory. Modifications to files in directories other than confluence will not be detected when you upgrade, for example, modifications to conf/server.xml. However the next time you upgrade (e.g. to version 4.1.1) the upgrade feature will cover modifications across the whole Confluence Installation Directory.
   2. At the 'Upgrade Check List' step, back up your external database and check that any non-bundled plugins will be compatible with your upgraded Confluence version. You may have already conducted the latter (in step 5 of the Before You Start section above).
   3. 続行すると、既存の Confluence インストレーションがまだ実行中の場合は終了されます。次に、アップグレードウィザードは:
      1. 既存の Confluence インストレーションをバックアップ。
      2. 既存の Confluence インストール ディレクトリのコンテンツを削除。
      3. Confluence の新バージョンを、既存の Confluence インストール ディレクトリにインストール。
      4. Starts your new (upgraded) Confluence installation.
         If you noted any files that contain customisations which must be migrated manually to your upgraded Confluence installation (above), then:
         1. アップグレードされた Confluence インストレーションを停止します。
         2. これらファイルにおけるカスタマイズ内容を、アップグレードされたConfluence インストール ディレクトリに移行します。
         3. アップグレードされた Confluence インストレーションを再開します。
7. アップグレード ウィザードの最終ステップで、アップグレードを確認するために、アップグレードした Confluence インストールをブラウザーで起動するオプションを選択します。

おめでとうございます。Linux における Confluence インストレーションのアップグレードが完了しました！

アップグレードチェックリスト

アップグレードウィザードは、実際に既存の Confluence インストレーションのアップグレードを開始する前に、以下の課題の実行を要求します。

外部データベースのバックアップ

外部データベースのバックアップを実行し(データベースのネイティブなバックアップツールを利用)、バックアップが正常に実行された事を検証します。

• データベースのネイティブなバックアップツールが「オンラインバックアップ」をサポートする場合(すなわち、一般的にはデータベースがまだ利用中の間に、あなたの Confluence の「スナップショット」を作成します)は、 データベースバックアップを実行中もアップグレードウィザードを実行したままにでき、データベースバックアップが正常に行われた事を確認した後に、ウィザードを引き続き実行する事が可能です。
• データベースのネイティブなバックアップツールが、Confluence データベースの「オンラインバックアップ」の実行を許可しない場合、次の事を行います:
  1. すぐにアップグレードウィザードを終了します。
  2. データベースのネイティブなバックアップツールを利用して Confluence データベースの「オフラインバックアップ」を実行し、バックアップが正常に行われた事を確認します。
  3. Linux/Windows インストーラーを再実行してアップグレードウィザードを再開し、一度停止した時点から再開します。
• HSQLDB を Confluence 内部データベースとして利用されている場合、これは Confluence のみに利用されるべきである点にご注意下さい。誤って HSQLDB データベースを本番環境のシステムに利用した場合は、すぐにアップグレードウィザードを終了し、サーバー間の Confluence 移行手順を利用して Confluence をアップグレードします。

Inconsistent database backups may not restore correctly! If you are unfamiliar with your database's native backup/restore facilities, then test your database backup's integrity by doing the following:

1. データベースバックアップを異なる (テスト) システムにリストアする、
2. 現在の Confluence バージョンのテストインスタンスを、リストアされたデータベースに接続する。

これ以外では、https://confluence.atlassian.co.jp/pages/viewpage.action?pageId=50398579手順を利用して、Confluence をアップグレードします。

プラグインの互換性を確認

If you have installed any 3rd-party Confluence plugins (i.e. not included in Confluence), please verify that they will be compatible with the version of Confluence you are upgrading to. You can find a plugin's compatibility information from the the plugin's home page on the Atlassian Plugin Exchange. Once you have confirmed the availability of compatible versions, you should upgrade your plugins after successfully upgrading Confluence. This can be done by navigating to Browse > Confluence Admin > Configuration > Plugins.