Confluence 手動アップグレード
このガイドでは、zip / tar.gz ファイルを使用して、Windows または Linux 上で Confluence サイトを最新の Confluence バージョンにアップグレードする方法について説明します。
現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。
Confluence をアップグレードするその他の方法:
- インストーラー – Confluence をアップグレードする最も簡単な方法です。
- Data Center – Data Center クラスタをアップグレードします。
Confluence のアップグレードに XML バックアップを使用することは推奨されません。
On this page:
はじめる前に
Confluence をアップグレードする前に、いくつかの質問に答える必要があります。
マニュアルは正しいアップグレード方法ですか? | |
アップグレードの資格がありますか? | |
アトラシアンのサポート対象プラットフォームに変更はありますか? | |
環境に変更を加える必要はありますか? |
アップグレードを計画する
1. アップグレード パスを決定する
以下の表を使用して、現在のバージョンから最新バージョンの Confluence への最も効率的なアップグレード パスを決定します。
ご利用のバージョン | Confluence 6 への推奨アップグレードパス |
---|---|
2.7 以前 | 2.7.4 へアップグレードした後、3.5.17 へアップグレードし、以降のパスに従います。 |
2.8 〜 3.4 | 3.5.17 にアップグレードし、以降のパスに従います。 |
3.5 | 5.0.3 にアップグレードし、Confluence 6 の最新バージョンにアップグレードします。 |
4.0 〜 4.3 | 5.10.x にアップグレードし、次に Confluence 6 の最新バージョンにアップグレードします。 |
5.0 〜 6.x | Confluence 6 の最新バージョンに直接アップグレードします。 |
Confluence 6 はメジャー アップグレードです
「Confluence 6.0 アップグレード ノート」を確認し、完全なバックアップを作成し、非本番環境でアップグレードをテストしてから、本番サイトのアップグレードを実行してください。
2. アップグレード前のチェックを完了する
アップグレード先のバージョン (およびその間のバージョン) のアップグレード ノートをお読みください。
Go to > General Configuration > Support Tools to run the health check (available in Confluence 5.5 or later).
Go to > Add-ons and scroll down to the Confluence Update Check to check the compatibility of your add-ons.
アップグレード先のバージョンを選択し、[チェック] をクリックします。
3. テスト環境で Confluence をアップグレードする
- 現在の本番環境のステージング コピーを作成します。
アップグレードをテストする環境の作成については、「Confluence アップグレードのためのステージング環境を作成する」を参照してください。
以下の手順に従って、テスト環境をアップグレードします。
本番環境でアップグレードを進める前に、 非サポート対象のアドオン(カスタム テーマや低アウトなどやプロキシ構成 (可能な場合)をテストします。
Confluence のアップグレード
4. バックアップ
- データベースのバックアップを作成し、適切に作成されていることを確認します。
データベースがオンライン バックアップをサポートしていない場合は、まず Confluence を停止する必要があります。
インストール ディレクトリとホーム ディレクトリのバックアップを作成します。
5. Confluence をダウンロードする
ご使用のオペレーティング システムに対応したファイルを https://www.atlassian.com/software/confluence/download からダウンロードします。
6. ファイルの抽出と Confluence のアップグレード
- Confluence を停止します。
- ディレクトリ(新しいインストール ディレクトリ。既存のインストール ディレクトリとは異なる必要があります)にファイルを抽出(解凍)します。
注意:Windows でのアーカイブ ファイル解凍について既知の問題が報告されています。7Zip または Winzip の使用を推奨します。 <Installation-Directory>\confluence\WEB-INF\classes\confluence-init.properties
ファイルを編集し、 既存 のホーム ディレクトリを指すようにします。- Copy your jdbc driver jar file from your existing Confluence installation directory to
confluence/WEB-INF/lib
in your new installation directory.
- 以下のような場合は追加ステップを実施する必要があります:
Confluence をWindows サービスとして実行している場合
ユーザー管理に JIRA アプリケーションまたは LDAP を使用している場合
ユーザーの管理にCrowdを使用している場合
Confluence を異なるポート(デフォルトポート 8090 以外)で実行している場合
- 新しい Confluence を起動します。セットアップ ウィザードが表示されないはずです。
アップグレード後
7. 変更の再適用
Confluence をカスタマイズ済みの場合 (server.xml
ファイルでの SSL 設定、confluence-init.properties
ファイル内の CATALINA_OPTS
または JAVA_OPTS
パラメータなど)、アップグレードの完了後に次の手順を実行する必要があります。
- アップグレードされた Confluence インスタンスを停止します。
- 関連するファイルのカスタマイズを、新たにアップグレードされた Confluence インストール ディレクトリ に再適用します。
- アップグレードされた Confluence インスタンスを再起動します。
Confluence に変更があり、それによりカスタマイズが使用できない可能性もあるため、本番インスタスでアップグレードを実施する前に、テスト インスタンスでカスタマイズのテストを実施することを強く推奨します。
8. リバース プロキシを更新し、Confluence にアクセスできることを確認する
アップグレードが完了したら、(直接ではなく) リバース プロキシ経由で Confluence にアクセスし、以下を実施する必要があります。
- Head to > General Configuration > Collaborative editing and check the Synchrony status is running.
- ブラウザが Synchrony に接続できることを確認するために任意のページを編集します。
リバース プロキシの設定が誤っている可能性があり、Synchrony が実行されないか、エディターでエラーが発生する場合、推奨される次の手順について、「共同編集のトラブルシューティング」を参照してください。
トラブルシューティング
問題が発生した場合
アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。