本ドキュメントでは、Windows または Linux 上で Confluence の最新版にアップグレードする方法を解説します。

メモ:

  • Recommended upgrade paths

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

    ご利用のバージョン

    Confluence 5 への推奨アップグレードパス

    2.7 以前Manually upgrade to 2.7.4 then upgrade to 3.5.17, and follow paths below.
    2.8 〜 3.4Manually upgrade to 3.5.17, and follow paths below.
    3.5

    5.0.3 にアップグレードし、Confluence 5 の最新バージョンにアップグレードします。

    4.0 〜 4.3 

    Upgrade directly to the latest version of Confluence 5.

    5.x

    Upgrade directly to the latest version of Confluence 5.

  • Confluence の初期バージョンからのアップグレード。Confluence 3.5 以前のバージョンからアップグレードされる場合は、手動アップグレード手順に従う必要があります。Confluence 手動アップグレードをご参照下さい。
  • 異なる OS、データベースあるいはファイルロケーションへの移行。Confluence を実行するOS、Confluence が利用するデータベース、あるいは Confluence のファイルロケーションを変更される場合は、手動アップグレード手順に従う必要があります。Confluence 手動アップグレードをご参照下さい。
  • クラスタ化された Confluence。自動インストーラー/アップグレーダーは、Confluence の クラスタ化されたインストレーションのアップグレードに対応していません。Confluence クラスタのアップグレードをご参照下さい。

Upgrading to Confluence 5.0?

If so, please review the Confluence 5.0 Release Notes for important information about this version of Confluence.

また、これまでの Confluence の主要バージョンへのアップグレードを省略する場合は、バージョン間で Confluence インストールに影響を与えうる特定の変更があるかもしれませんので、各主要バージョンのアップグレードノートを確認することを強く推奨します。アップグレードノートの概要ページに、最近の Confluence 主要バージョンのアップグレードノートへのリンクがあります。

最後に、サポートするプラットフォームページで、お使いの Java バージョン、オペレーティング システム、アプリケーション サーバー、データベース、ブラウザーが本バージョンの Confluence によりサポートされていることを確認してください。Confluence のサポート終了のお知らせページで、サポートしているプラットフォームについての重要情報が見つかります。

On this page:

作業を開始する前に

Changing your Database?

アップグレードと同時に使用するデータベースを変更する場合は、アップグレードを先に実行することを推奨します。その後、異なるデータベースへの移行に従ってください。

  1. Note that you need current software maintenance to perform the upgrade.
  2. アップグレード開始前に、ライセンスサポートが有効期間内にあることを確認してください。
  3. If your current license has expired but you have a new license with you, please update your license in Confluence before performing the upgrade.
    (warning) 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.
  4. インストールする新しい Confluence のリリースノートと、インストールをスキップするバージョンの中にメジャーバージョンがあった場合はそのメジャーバージョンのアップグレードノートの内容を確認してください。ユーザーの Confluence システムに対して大きな影響のある変更が含まれている可能性もあるため、これらのノートを確認することは重要です。最近の Confluence メジャーバージョンのアップグレードノートは、アップグレードノート概要をご覧ください (各々のアップグレードノートは、対応するリリースノートが親になっています)。
  5. システム環境 (例えば、データベースシステム、オペレーティングシステム、アプリケーションサーバーなど) が引き続き Confluence のシステム要件を満たしていることを確認してください。新しいバージョンは過去のバージョンとはシステム要件が異なる可能性があります。
  6. Confluence EAR-WAR 版をご利用の場合は、Confluence の EAR-WAR 版をインストールで Confluence 実行に必要な追加作業の有無を確認してください。
  7. 外部データベースをご利用の場合は、そのデータベースの既知の問題点をすべて調べておく必要があります。さらに、Confluence のデータベースコネクタープリンシパル (データベースユーザーアカウント) にデータベーススキーマを変更できる権限が付与されていることを確認してください。
  8. Note which plugins are installed and enabled on your current Confluence instance. 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 'Plugins' menu in your Administration screens, and selecting Confluence Upgrade Check. This will tell you which plugins have an updated version which is compatible with your target upgrade version. 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.
  9. Confluence のカスタマイズを行っている場合は、それが最新バージョンにも対応しているか否かを確認してください。例えばレイアウトの変更や自分だけのカスタムテーマの適用を行っている場合は、先にテスト環境でこれらを Confluence 最新バージョンに適用するテストを行っておいてください。Confluence に設定したカスタマイゼーションの内容を確認してください。
  10. ウィルス対策ツールやインターネットセキュリティーツールの中には Confluence アップグレードの障害となるものがあり、アップグレードが成功しないことがあります。お使いのウィルス対策ツールやインターネットセキュリティーツールが過去にそのような問題を起こしたことがある場合やそのような懸念がある場合は、Confluence のアップグレードに進む前にこれらのツールを無効化してください。
  11. アップグレード後に 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.
    (tick) 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. (info) 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.
    (info) 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 directory or your Confluence webapp (if you are using Confluence EAR-WAR edition). (info) 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 環境の現在のスナップショットをテストサーバーに作成してください。

XML インポート

(warning) Importing an old XML backup file to a new major version (for example, Confluence 3.5 to Confluence 4.0) is not recommended. Please recreate your production instance in a test environment first.

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

      3. Test all your unsupported plugins and any customisations with the new version before proceeding on your production server. You can read more about supported and unsupported plugins.

関連トピック

Confluence のアップグレード

アップグレード概要

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

  1. アップグレードされる、既存の Confluence インストレーションの インストール および ホーム ディレクトリをバックアップ。
  2. Installs Confluence 5.1 whilst migrating the following from your existing Confluence installation to the new Confluence 5.1 installation:
    • TCP port values in your existing Confluence installation's server.xml file. (warning) 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.

(info) 注意:

  • アップグレード プロセスでは、あなたのデータベースのバックアップユーティリティを利用して、データベースのバックアップを行う事が要求されます。データベースがオンラインバックアップをサポートしない場合、アップグレード プロセスを停止し、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.
    (info) 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.
    (info) 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.
      (info)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. (info)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.
        (warning) 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 インストレーションをブラウザで起動するオプションを選択して、アップグレードを確認します。
  7. If you are upgrading to Confluence 5.0: If the global default language of your Confluence site is not English, you will need to install a patch in the form of a plugin. For more information, please refer to this article in our knowledge base: Nothing Happens when Users Click on The "Create" Button.

おめでとうございます。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.
    (warning) 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.
    (info) 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.
      (info) 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. (info)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.
        (warning) 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 インストールをブラウザーで起動するオプションを選択します。
  8. If you are upgrading to Confluence 5.0: If the global default language of your Confluence site is not English, you will need to install a patch in the form of a plugin. For more information, please refer to this article in our knowledge base: Nothing Happens when Users Click on The "Create" Button.

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

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

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

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

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

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

(warning) 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.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.