Confluence のアップグレード
このガイドでは、インストーラーを使用して Confluence サイトを Windows または Linux の最新の Confluenceバージョンへアップグレードする手順について説明します。
現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。
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 を停止する必要があります。
インストール ディレクトリとホーム ディレクトリのバックアップを作成します。
インストール ウィザードは、Confluence ディレクトリのバックアップをインストールの一環で実施しますが、アップグレードの開始前に手動でバックアップを実施する必要があります。
5. Confluence をダウンロードする
オペレーティング システムにインストーラーをダウンロードします。
- 最新バージョン https://www.atlassian.com/software/confluence/download
- 過去のバージョン https://www.atlassian.com/software/confluence/download-archives
6. インストーラーを実行する
インストーラーを実行します。
- プロンプトに従って Confluence をアップグレードします。
- プロンプトが表示されたら、既存の Confluence インストールのアップグレードを選択します (Linux ユーザーの場合、オプション 3)。
- ウィザードが提示した既存の Confluence インストール ディレクトリが正しいことを確認します (同一マシンに複数の Confluence インストールがある場合は特に重要)。
- Confluence ホームをバックアップすることを強くお勧めします。Confluence ホーム ディレクトリとインストール ディレクトリのバックアップの .zip ファイルを作成します。
このインストール ウィザードは Confluence インストール ディレクトリへのカスタマイズを通知します。これらは後から再適用する必要があるため、記録しておきます。
- プロンプトが表示されたら、既存の Confluence インストールのアップグレードを選択します (Linux ユーザーの場合、オプション 3)。
- ウィザードは Confluence インスタンスをシャットダウンし、アップグレードを開始します。アップグレードが完了したら、Confluence が再起動されます。管理者はブラウザで Confluence を起動し、アップグレードが成功したかどうかを確認します。
インスタンスのサイズと実行するアップグレード タスクの数によって、このステップには数分または数時間かかる場合があります。
アップグレード後
7. データベース ドライバーをコピーする
confluence/WEB-INF/lib
に jdbc ドライバの jar ファイルをコピーする必要があります。Microsoft SQL および Postgres ユーザーはこの手順をスキップすることができます。
8. 変更の再適用
アップグレード中、ウィザードは既存の Confluence インストールから下記のファイルを移行します。
- TCP port values in your
server.xml
file. - Location of your Confluence home directory in
confluence-init.properties
.
All other customizations, including CATALINA_OPTS
parameters in your setenv.sh
/ setenv.bat
files, need to be reapplied manually.
9. リバース プロキシを更新し、Confluence にアクセスできることを確認する
アップグレードが完了したら、(直接ではなく) リバース プロキシ経由で Confluence にアクセスし、以下を実施する必要があります。
- Head to > General Configuration > Collaborative editing and check the Synchrony status is running.
- ブラウザが Synchrony に接続できることを確認するために任意のページを編集します。
リバース プロキシの設定が誤っている可能性があり、Synchrony が実行されないか、エディターでエラーが発生する場合、推奨される次の手順について、「共同編集のトラブルシューティング」を参照してください。
トラブルシューティング
問題が発生した場合
アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。