Confluence のアップグレード
このガイドでは、インストーラーを使用して Confluence サイトを Windows または Linux の最新の Confluenceバージョンへアップグレードする手順について説明します。
現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。
Confluence をアップグレードするその他の方法:
- 手動 – インストーラーを使用せずにアップグレードします。
- Data Center – Data Center クラスタをアップグレードします。
Confluence のアップグレードに XML バックアップを使用することは推奨されません。
On this page:
はじめる前に
Confluence をアップグレードする前に、いくつかの質問に答える必要があります。
最適なアップグレード方法はどれですか? | |
アップグレードの資格がありますか? | |
アトラシアンのサポート対象プラットフォームに変更はありますか? | |
環境に変更を加える必要はありますか? |
アップグレードを計画する
カスタム アップグレード プランの作成
アップグレードを計画されている場合は、Confluence 内でお客様に最適なアップグレード プランを即座に生成できます。 > [全般設定] > [アップグレードを計画] に移動します。
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. アップグレード前のチェックを完了する
アップグレード先のバージョン (およびその間のバージョン) のアップグレード ノートをお読みください。
> [一般設定] > [トラブルシューティングとサポート ツール] へ移動して、ヘルス チェックを実行します (Confluence 5.5 以降で利用可能)。
> [アドオン] に移動して下にスクロールし、[Confluence の更新チェック] でお使いのアドオンの互換性を確認します。
アップグレード先のバージョンを選択し、[チェック] をクリックします。
3. テスト環境で Confluence をアップグレードする
- 現在の本番環境のステージング コピーを作成します。
アップグレードをテストする環境の作成については、「Confluence アップグレードのためのステージング環境を作成する」を参照してください。
以下の手順に従って、テスト環境をアップグレードします。
本番環境でアップグレードを進める前に、 非サポート対象のアドオン(カスタム テーマや低アウトなどやプロキシ構成 (可能な場合)をテストします。
Confluence のアップグレード
4. バックアップ
- データベースをバックアップし、バックアップが正しく作成されていることを確認します。
データベースがオンライン バックアップをサポートしていない場合は、まず Confluence を停止する必要があります。
- Back up your installation directory
The installer will completely replace this directory, so any files you've added (such as a keystore or SSL certificate) won't be retained. The installation wizard will back up this directory before starting the upgrade, but you should also back it up manually first.
ホーム ディレクトリをバックアップします。
インストール ウィザードでは、インストールの一環でホーム ディレクトリのバックアップを実施するよう選択できますが、アップグレードの開始前に手動でもこのディレクトリのバックアップを実施する必要があります。
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 your add-ons
Update apps that are compatible with the new version of Confluence.
- 移動
> [アドオン]
- アプリをサポート対象バージョンにアップグレードします。
この段階で、プラグインのキャッシュをクリアすることをおすすめします。方法を確認する
これは任意ですが、サードパーティ製のアプリやプラグインに関する問題を回避するのに役立ちます。
11. リバース プロキシを更新し、Confluence にアクセスできることを確認する
アップグレードが完了したら、(直接ではなく) リバース プロキシ経由で Confluence にアクセスし、以下を実施する必要があります。
- > [一般設定] > [共同編集] に移動し、Synchrony ステータスが実行中であることを確認します。
- ブラウザが Synchrony に接続できることを確認するために任意のページを編集します。
リバース プロキシの設定が誤っている可能性があり、Synchrony が実行されないか、エディターでエラーが発生する場合、推奨される次の手順について、「共同編集のトラブルシューティング」を参照してください。
トラブルシューティング
問題が発生した場合
アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。