Confluence のアップグレード

はじめる前に

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

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

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

エンタープライズ リリース

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

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

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 ポート値。 
• <install-directory>/confluence/WEB-INF/classes/confluence-init.properties の Confluence ホーム ディレクトリの場所。
    

ほかのすべてのカスタマイズを手動で再適用する必要があります。これには <install-directory>/bin/setenv.sh/setenv.bat ファイル内の CATALINA_OPTS パラメータも含まれます。  

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

Confluence の新しいバージョンとの互換性を持つ任意のアプリを更新できます。

1. 移動 

   Error rendering macro 'includeplus'

   User 'anonymous' does not have permission to view the page with ID 956705341.

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

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

トラブルシューティング