Confluence 手動アップグレード

このガイドでは、zip / tar.gz ファイルを使用して、Windows または Linux 上で Confluence サイトを最新の Confluence バージョンにアップグレードする方法について説明します。 

現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。

Confluence をアップグレードするその他の方法:

• インストーラー – Confluence をアップグレードする最も簡単な方法です。
• Data Center – Data Center クラスタをアップグレードします。
• ローリング アップグレード - ダウンタイムなしで、Data Center クラスタを最新の使用可能なバグ修正バージョンにアップグレードします。

Confluence のアップグレードに XML バックアップを使用することは推奨されません。

はじめる前に

Confluence をアップグレードする前に、いくつかの質問に答える必要があります。 

アップグレードを計画する

1. アップグレード パスを決定する

2. アップグレード前のチェックを完了する

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

Confluence のアップグレード

4. バックアップ 

1. データベースのバックアップを作成して、適切に作成されていることを確認します。
   データベースがオンライン バックアップをサポートしていない場合は、まず Confluence を停止する必要があります。
   
   データベースのバックアップが成功したことを確認したら、アップグレード リカバリ ファイルの自動生成を無効化できます。このプロセスは中大規模のサイトでは時間がかかる可能性があるためです。
     

2. インストール ディレクトリとホーム ディレクトリのバックアップを作成します。
     

   ホーム ディレクトリの場所が不明な場合

   ホーム ディレクトリの場所は <installation-directory>/confluence/WEB-INF/classes/confluence-init.properties ファイルに記載されています。

   ここには、検索インデックスと添付ファイルが格納されます。添付ファイルを Confluence ホーム ディレクトリの外部で保存している場合は、添付ファイル ディレクトリのバックアップも実施する必要があります。 

5. Confluence をダウンロードする

ご使用のオペレーティング システムに対応したファイルを https://www.atlassian.com/software/confluence/download からダウンロードします。

6. ファイルの抽出と Confluence のアップグレード

1. Confluence を停止します。無停止のアクセスを提供する必要がある場合は、「サイト メンテナンスで読み取り専用モードを使用する」を参照してください。  
2. ディレクトリ（新しいインストール ディレクトリ。既存のインストール ディレクトリとは異なる必要があります）にファイルを抽出（解凍）します。
   注意：Windows でのアーカイブ ファイル解凍について既知の問題が報告されています。7Zip または Winzip の使用を推奨します。  

3. <Installation-Directory>\confluence\WEB-INF\classes\confluence-init.properties  ファイルを編集し、 既存 のホーム ディレクトリを指すようにします。  

4. Oracle または MySQL データベースを利用している場合、既存の Confluence インストール ディレクトリから新しいインストール ディレクトリの confluence/WEB-INF/lib に jdbc ドライバの jar ファイルをコピーする必要があります。
     

5. 以下のような場合は追加ステップを実施する必要があります：
   

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

     ここをクリックして展開...

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

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

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

      Confluence インストーラーでインストールしたサービスを削除するには、<confluence auto installer installation folder>\UninstallService.bat を実行する必要があります。

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

     ここをクリックして展開...

     Confluence をポート 8090 で実行していない場合、<Installation-Directory>\conf\server.xml ファイルを更新して利用しているポートを含めます。

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

アップグレード後

7. サービスを再インストールする (Windows のみ)

Windows で Confluence をサービスとして実行している場合、<install-directory>/bin/service.bat を実行して、既存のサービスを削除してサービスを再インストールする必要があります。

これにより、サービスで最新の JVM オプションを使用できます。 

8. 変更の再適用

Confluence をカスタマイズ済みの場合 (server.xml ファイルでの SSL 設定、confluence-init.properties ファイル内の CATALINA_OPTS  または JAVA_OPTS パラメータなど)、アップグレードの完了後に次の手順を実行する必要があります。

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

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

9. リバース プロキシを更新し、Confluence にアクセスできることを確認する

トラブルシューティング