Confluence のアップグレード

はじめる前に

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

最適なアップグレード方法はどれですか?	詳細を読む... アップグレードの方法として、インストーラを使用する方法と、zip または tar.gz ファイルを使用して手動で実施する方法があります。ほとんどの場合、Confluence インスタンスのアップグレードの最も簡単な方法は、インストーラを使用する方法です。 以下の場合は手動でアップグレードする必要があります。 アップグレードの一環として、別のオペレーティング システムまたはファイルの場所への移動が行われる場合 Confluence 3.5 以前からアップグレードする場合 Confluence 5.6 以前からのアップグレード、および過去に EAR/WAR ディストリビューションを使用して既存のアプリケーション サーバーに Confluence をデプロイした場合。
アップグレードの資格がありますか?	詳細を読む... To check if software maintenance is current for your license, go to  > General Configuration > Troubleshooting and support tools and make sure the license support period has not expired. サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。
アトラシアンのサポート対象プラットフォームに変更はありますか?	詳細を読む... サポート対象プラットフォーム ページで、アップグレード先の Confluence のバージョンを確認します。このページでは、サポート対象のオペレーティングシステム、データベースおよびブラウザに関する情報を提供しています。 参考情報 Confluence インストーラーには Java (JRE) および Tomcat が含まれているため、これらを別途アップグレードする必要はありません。 データベースをアップグレードする必要がある場合、アップグレード先 (およびその中間) の Confluence バージョンのアップグレードに関する注意事項を読み、必要なデータベース構成の変更を確認します。
環境に変更を加える必要はありますか?	詳細を読む... 新しい Confluence バージョンでは、メモリの増強やリバース プロキシ設定の調整など、環境の変更が必要な場合があります。 参考情報 ユーザーに影響する変更についてはアップグレードの注意事項をご確認ください。次のようなものがあります。 環境に影響を与える、サポート対象データベース、メモリ要件またはその他の変更。 このリリースで大きく変更または削除された機能。 インスタンスまたは環境でアップグレード後すぐに実施する必要があるアクション。 アップグレード後のバージョンとその間のバージョンに関する注意事項をお読みください。たとえば、5.8 から 5.10 へアップグレードする場合は、5.9 と 5.10 のアップグレード ノートを読む必要があります。

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

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

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

1. アップグレード先のバージョン (およびその間のバージョン) のアップグレード ノートをお読みください。
     

2. Go to  > General Configuration > Troubleshooting and support tools to run the health check (available in Confluence 5.5 or later). 
   
   

   ライセンスが期限切れの場合

   お使いのライセンスに含まれるソフトウェア メンテナンスの期限が切れた場合も Confluence を引き続き使用できますが、アップグレード前に更新する必要があります。

   Go to  > General Configuration > License Details and follow the prompts to renew your license.

   組み込みのデータベースを引き続き使用している場合

   組み込み（トライアル用）データベース を使用している場合は、 別のデータベースへ移行する前にアップグレードする必要があります。

   このデータベースは評価用であるため、本番環境での利用は推奨されません。詳細は、「組み込み H2 データベース」を参照してください。

   データベースの文字エンコーディングが誤っている場合

   データベースの文字エンコーディングは、UTF+8 (Oracle データベースの場合は AL32UTF8) に設定する必要があります。文字エンコーディングが異なる場合、最新の Confluence バージョンにアップグレードすることができません。

     

3. Go to   > Add-ons and scroll down to the Confluence Update Check to check the compatibility of your add-ons.
     

4. アップグレード先のバージョンを選択し、[チェック] をクリックします。
   
   

   互換性のないアドオンがある場合...

   ユーザーが特定のアドオンに依存している場合、Confluence のアップグレード前に互換性がサポートされるまで待つことをお勧めします。アドオン ベンダーは一般的に、メジャー リリースの後、すぐにアドオンをアップグレードします。

   参考情報

   • まだ互換性がサポートされていない場合は、アップグレード中、一時的にアドオンを無効化することができます。
   • Compatibility information for Atlassian Labs and other free add-ons is often not available immediatley after a new release. In many cases the add-on will still work, so give it a try in a test site before upgrading your production site.

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

1. 現在の本番環境のステージング コピーを作成します。
   アップグレードをテストする環境の作成については、「Confluence アップグレードのためのステージング環境を作成する」を参照してください。
     

2. 以下の手順に従って、テスト環境をアップグレードします。  
     

3. 本番環境でアップグレードを進める前に、 非サポート対象のアドオン（カスタム テーマや低アウトなどやプロキシ構成 (可能な場合）をテストします。   

Confluence のアップグレード

4. バックアップ 

1. データベースをバックアップし、バックアップが正しく作成されていることを確認します。
   データベースがオンライン バックアップをサポートしていない場合は、まず Confluence を停止する必要があります。
    
2. インストール ディレクトリのバックアップを作成します。
   インストーラーはこのディレクトリを完全に置き換えます。そのため、追加したファイル (キーストアや SSL 証明書) は保持されません。インストール ウィザードは、アップグレードの前にこのディレクトリをバックアップしますが、最初に手動でもバックアップを実施する必要があります。
     

3. ホーム ディレクトリをバックアップします。 
   インストール ウィザードでは、インストールの一環でホーム ディレクトリのバックアップを実施するよう選択できますが、アップグレードの開始前に手動でもこのディレクトリのバックアップを実施する必要があります。
     

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

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

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

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

オペレーティング システムにインストーラーをダウンロードします。 

• 最新バージョン https://www.atlassian.com/software/confluence/download
• 過去のバージョン https://www.atlassian.com/software/confluence/download-archives 

6. インストーラーを実行する

1. インストーラーを実行します。 
     

   Windows で実行する場合...

   .exe ファイルを実行します。Windows 管理者アカウントを使用することをおすすめします。

   アップグレード ウィザードでコンピュータへの変更の許可を求められたら「はい」を選択します。これを指定しない場合、OS に対するインストール ウィザードのアクセスが制限され、以降のインスト―ル オプションも制限されます。

   Linux で実行する場合...

   Confluence をダウンロードしたディレクトリに移動し、次のコマンドを実行してインストーラを実行可能にします。

   $ chmod a+x atlassian-confluence-X.X.X-x64.bin

   ここで、X.X.X はダウンロードした Confluence のバージョンです。

   次にインストーラーを実行します。インストーラーの実行には sudo を使用することをお勧めします。

   $ sudo ./atlassian-confluence-X.X.X-x64.bin

   root ユーザー権限でインストーラーを実行することもできます。

     

2. プロンプトに従って Confluence をアップグレードします。
    
   
   1. プロンプトが表示されたら、既存の Confluence インストールのアップグレードを選択します (Linux ユーザーの場合、オプション 3)。
        
   2. ウィザードが提示した既存の Confluence インストール ディレクトリが正しいことを確認します (同一マシンに複数の Confluence インストールがある場合は特に重要)。
        
   3. Confluence ホームをバックアップすることを強くお勧めします。Confluence ホーム ディレクトリとインストール ディレクトリのバックアップの .zip ファイルを作成します。
        

   4. このインストール ウィザードは Confluence インストール ディレクトリへのカスタマイズを通知します。これらは後から再適用する必要があるため、記録しておきます。

      いくつかの制限について...

      インストール ウィザードによるカスタマイズの通知機能は、既存の Confluence インスタンスのインストール方法によって異なります:  

      • 現在の Confluence インスタンスがインストーラーを使用してインストールされていた場合、ウィザードは Confluence インストール ディレクトリ全体をチェックします。
      • 現在の Confluence インスタンスが手動でインストールされたものの場合、Confluence のインストール ディレクトリの confluence サブディレクトリのみが確認されます。インストール ウィザードは、他のディレクトリへの変更を通知しません (例: bin ディレクトリ下のスタートアップ スクリプトへの変更や server.xml ファイル (SSL 設定など) への変更)。 

      インストール ディレクトリに追加したファイルについての通知は行われません。そのため、必ず最初にバックアップするようにしてください。

3. ウィザードは Confluence インスタンスをシャットダウンし、アップグレードを開始します。アップグレードが完了したら、Confluence が再起動されます。管理者はブラウザで Confluence を起動し、アップグレードが成功したかどうかを確認します。
    
   インスタンスのサイズと実行するアップグレード タスクの数によって、このステップには数分または数時間かかる場合があります。

アップグレード後

7. データベース ドライバーをコピーする

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

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

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

9. 変更の再適用

アップグレード中、ウィザードは既存の Confluence インストールから下記のファイルを移行します。

• <install-directory>/conf/server.xml ファイルの TCP ポート値。 
• Location of your Confluence home directory in <install-directory>/confluence/WEB-INF/classes/confluence-init.properties.
    

All other customizations, including CATALINA_OPTS parameters in your <install-directory>/bin/setenv.sh / setenv.bat files, need to be reapplied manually.  

10. アプリ (アドオン) の更新

Update apps that are compatible with the new version of Confluence.

1. 移動 

   > [アドオン]

2. アプリをサポート対象バージョンにアップグレードします。

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

トラブルシューティング