このページでは、Windows または Linux で Confluence を手動で最新版にアップグレードする方法を説明します（アップグレード ウィザードを使用しません）。インストーラーまたはアップグレード ウィザードを使用するアップグレード方法については、Confluence のアップグレードを参照してください。 

始める前に

  • Check your Confluence licence is valid.
    To check go to  > General Configuration > 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.
  • ご利用のデータベースにつき、最新のデータベース セットアップガイドで、データベースの設定が正しいか、確認してください。新しい設定要件が追加されている可能性があります。データベース設定を確認してください。
  • Confluence に施した修正は記録しておいてください（例えば、レイアウト、カスタムテーマ）。
    カスタマイズを維持するには、アップグレード後に再度適用する必要があります。 

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

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

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

ご利用のバージョン

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

2.7 以前2.7.4 へアップグレードした後、3.5.17 へアップグレードし、以降のパスに従います。
2.8 〜 3.43.5.17 にアップグレードし、以降のパスに従います。
3.5

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

4.0 〜 4.3 

Upgrade directly to the latest version of Confluence 5.

5.0 〜 5.7 

Upgrade directly to the latest version of Confluence 5.

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

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

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

ステップ 3 バックアップ

Confluence のアップグレードを実行する前に、バックアップ作業を行う必要があります:
  • 外部データベース
    外部データベースのバックアップを手動で実施し、そのバックアップが適切に作成されたか確認してください。データベースのバックアップや復元機能にあまり詳しくない場合は、次に進む前にそのバックアップを異なるデータベース システムで復元すれば、バックアップが正常に行われたたか確認できます。
  • Confluence ホーム ディレクトリ
    Confluence ホーム ディレクトリとは、Confluence がその構成情報、検索用インデックス、およびページ添付ファイルを保存するフォルダーです。ホーム ディレクトリの場所の情報は、Confluence インストール ディレクトリ下の confluence/WEB-INF/classes ディレクトリにある confluence-init.properties という名称の設定ファイルに保存されています。
    添付ファイルを Confluence ホーム ディレクトリの外部で保存している場合は、添付ファイル ディレクトリのバックアップも実施する必要があります。 
  • Confluence インストール ディレクトリ
    Confluence をインストールした時の、Confluence アプリケーション ファイルやライブラリの解凍（zip ファイル展開）先のディレクトリです。

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

  1. Download the appropriate archive file from the Confluence Download Center.
  2. Confluence をシャットダウンします。
  3. ディレクトリ（新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります）にファイルを抽出（解凍）します。
    注意：Windows でのアーカイブファイル解凍について既知の問題が報告されています。7Zip または Winzip の使用を推奨します。

  4. Update the following line in the <Installation-Directory>\confluence\WEB-INF\classes\confluence-init.properties file to point to your existing Confluence home directory.

    # confluence.home=c:/confluence/data

     For example if your existing Confluence home directory is c:\confluence\myhome the file will read:

    confluence.home=c:/confluence/myhome
  5. Copy the JDBC driver jar file from your existing Confluence installation directory to  confluence/WEB-INF/lib in your new installation directory. 
    The JDBC driver will be located in either the <Install-Directory>/common/lib or <Installation-Directory>/confluence/WEB-INF/lib directories. 
  6. 以下のような場合は追加ステップを実施する必要があります：

    • Confluence をWindows サービスとして実行している場合

      Confluence を Windows サービスとして実行している場合、コマンドプロンプトを開き、以下の通り入力します：  

      <Installation-Directory>\bin\service.bat remove Confluence

      Confluence の古いインスタンスをアンインストールする前に既存のサービスを停止して削除することが重要です。Confluence を Windows サービスとして実行する際の詳細情報については、Confluence を Windows でサービスとして自動的に起動するを参照してください。

      (warning) To remove the service installed by the Confluence installer, you'll need to run <confluence auto installer installation folder>\UninstallService.bat.

    • ユーザーの管理に JIRA または LDAPを使用している場合

      ユーザーの管理に JIRA または LDAP を使用している場合、下記のファイルを既存のインストール ディレクトリから新しいインストール ディレクトリにコピーする必要があります：

      • <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml

      • <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml

    • ユーザーの管理にCrowdを使用している場合

      ユーザーの管理に Crowd を使用している場合、下記のファイルを既存のインストール ディレクトリから新しいインストール ディレクトリにコピーする必要があります：

      • <Installation-Directory>/confluence/WEB-INF/classes/osuser.xml

      • <Installation-Directory>/confluence/WEB-INF/classes/atlassian-user.xml (Confluence 2.2 以降からアップグレードする場合)

      • <Installation-Directory>/confluence/WEB-INF/classes/crowd.properties

    • Confluence 2.5以前からアップグレードする場合

      If you are upgrading from Confluence 2.5.5 or earlier and are copying the existing atlassian-user.xml file from your previous instance, make sure the hibernate cache parameter in this file is enabled, to avoid performance issues. 

      <hibernate name="Hibernate Repository" key="hibernateRepository" description="Hibernate Repository" cache="true" />

      ユーザー管理に Crowd を使用している場合は、この作業は不要です。

    • Confluence を異なるポート（デフォルトポート 8090 以外）で実行している場合

      If you are not running Confluence on port 8090 update  <Installation-Directory>\conf\server.xml file to include your ports

  7. 新しい Confluence を起動します。セットアップ ウィザードが表示されないはずです。  

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

If you have customised Confluence (such as an SSL configuration in the server.xml file, or CATALINA_OPTS or JAVA_OPTS parameters in your confluence-init.properties file), you'll need to perform the following steps after the upgrade is complete:

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

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

トラブルシューティング

問題が発生した場合

アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。 

Confluence ナレッジベースのアップグレードのトラブルシューティングを参照するか、コミュニティのアトラシアン回答集を確認してください。

 

  • ラベルなし