Confluence のアップグレード
このガイドでは、インストーラーを使用して Confluence サイトを Windows または Linux の最新の Confluenceバージョンへアップグレードする手順について説明します。
現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。
Confluence をアップグレードするその他の方法:
- 手動 – インストーラーを使用せずにアップグレードします。
- Data Center – Data Center クラスタをアップグレードします。
Confluence のアップグレードに XML バックアップを使用することは推奨されません。
On this page:
はじめる前に
Confluence をアップグレードする前に、いくつかの質問に答える必要があります。
最適なアップグレード方法はどれですか? | |
アップグレードの資格がありますか? | |
アトラシアンのサポート対象プラットフォームに変更はありますか? | |
環境に変更を加える必要はありますか? |
アップグレードを計画する
カスタム アップグレード プランの作成
Planning an upgrade? You can instantly generate a tailored upgrade plan from within Confluence. Head to
> General Configuration
> Plan your upgrade
Troubleshooting and Support tools アプリの互換性のあるバージョンがインストールされている必要があります。詳細情報
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 > Troubleshooting and 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 を停止する必要があります。
- インストール ディレクトリのバックアップを作成します。
インストーラーはこのディレクトリを完全に置き換えます。そのため、追加したファイル (キーストアや SSL 証明書) は保持されません。インストール ウィザードは、アップグレードの前にこのディレクトリをバックアップしますが、最初に手動でもバックアップを実施する必要があります。
ホーム ディレクトリをバックアップします。
インストール ウィザードでは、インストールの一環でホーム ディレクトリのバックアップを実施するよう選択できますが、アップグレードの開始前に手動でもこのディレクトリのバックアップを実施する必要があります。
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. サービスを再インストールする (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.
Confluence のバージョン間でこれらのファイルの既定設定が変更されている可能性があるため、古いファイルをコピーするのではなく、新しいファイルを手動で編集します。
10. アプリ (アドオン) の更新
Update apps that are compatible with the new version of Confluence.
- 移動
> [アドオン]
- アプリをサポート対象バージョンにアップグレードします。
この段階で、プラグインのキャッシュをクリアすることをおすすめします。方法を確認する
This step is optional, but can be useful to avoid any issues with third-party apps and plugins.
11. リバース プロキシを更新し、Confluence にアクセスできることを確認する
アップグレードが完了したら、(直接ではなく) リバース プロキシ経由で Confluence にアクセスし、以下を実施する必要があります。
- Head to > General Configuration > Collaborative editing and check the Synchrony status is running.
- ブラウザが Synchrony に接続できることを確認するために任意のページを編集します。
リバース プロキシの設定が誤っている可能性があり、Synchrony が実行されないか、エディターでエラーが発生する場合、推奨される次の手順について、「共同編集のトラブルシューティング」を参照してください。
トラブルシューティング
問題が発生した場合
アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。