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 10 への推奨アップグレードパス |
|---|---|
| 2.7 以前 | 2.7.4 へアップグレードした後、3.5.17 へアップグレードし、以降のパスに従います。 |
| 2.8 〜 3.4 | 3.5.17 にアップグレードし、以降のパスに従います。 |
| 3.5 | 5.0.3 にアップグレードし、以降のパスに従います。 |
4.0 〜 4.3 | 5.10.x にアップグレードし、以降のパスに従います。 |
| 5.0 〜 7.11 | 7.19.x にアップグレードし、以降のパスに従います。 |
| 7.12.x 〜 10.x | Confluence 10 の最新バージョンに直接アップグレードします。 |
Confluence 10 はメジャー アップグレードです
「Confluence アップグレード マトリクス」を確認し、完全なバックアップを作成し、非本番環境でアップグレードをテストしてから、本番サイトのアップグレードを実行してください。
長期サポート リリース
2. アップグレード前のチェックを完了する
アップグレード先のバージョン (およびその間のバージョン) のアップグレード ノートをお読みください。
[管理] メニュー
に移動して、[一般設定] > [アップグレードを計画] の順に選択し、アップグレードしたいバージョンを選択します。アップグレード前のチェックがいくつか実行されます。
[管理] メニュー
に移動して、[一般設定] > [トラブルシューティングとサポート ツール] の順に選択し、ヘルス チェックを行います。ライセンスが期限切れの場合ご利用のライセンスに含まれるソフトウェア メンテナンスの期限が切れている場合、引き続き Confluence を使用できますが、アップグレードするには更新が必要です。
ライセンスを更新するには、[管理] メニュー
から [一般設定] > [ライセンスの詳細] に移動し、プロンプトに従います。[管理] メニュー
から [アプリの管理] に移動し、[Confluence Update Check] まで下にスクロールして、使用している Marketplace アプリの互換性を確認します。
アップグレードする予定のバージョンを選択して [チェック] を選択します。
3. テスト環境で Confluence をアップグレードする
- 現在の本番環境のステージング コピーを作成します。
アップグレードをテストする環境の作成については、「Confluence アップグレードのためのステージング環境を作成する」を参照してください。
以下の手順に従って、テスト環境をアップグレードします。
本番環境でアップグレードを行う前に、サポート対象外のユーザー インストール アプリ、カスタマイズ (カスタム テーマやレイアウト)、プロキシ構成 (可能な場合) をテストします。
Confluence のアップグレード
4. バックアップ
- データベースをバックアップして、バックアップが正しく作成されていることを確認します。
データベースがオンライン バックアップをサポートしていない場合は、まず Confluence を停止する必要があります。
MySQL データベースがある場合は、バックアップにストアド プロシージャ/関数を必ず含めてください。データベースのバックアップが成功したことを確認したら、アップグレード リカバリ ファイルの自動生成を無効化できます。このプロセスは中大規模のサイトでは時間がかかる可能性があるためです。
- インストール ディレクトリのバックアップを作成します。
インストーラーはこのディレクトリを完全に置き換えます。そのため、追加したファイル (キーストアや 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 ポート値。<install-directory>/confluence/WEB-INF/classes/confluence-init.propertiesの Confluence ホーム ディレクトリの場所。
ほかのすべてのカスタマイズを手動で再適用する必要があります。これには <install-directory>/bin/setenv.sh / setenv.bat ファイル内の CATALINA_OPTS パラメータも含まれます。
Confluence のバージョン間でこれらのファイルの既定設定が変更されている可能性があるため、古いファイルをコピーするのではなく、新しいファイルを手動で編集します。
システム プロパティは随時変更されることがあります。適切な認識済みのシステム プロパティを使用しているか、必ずご確認ください。
10. アプリ (アドオン) の更新
Confluence の新しいバージョンとの互換性を持つ任意のアプリを更新できます。
- 移動
[管理] メニュー
から [アプリの管理] に移動 - アプリをサポート対象バージョンにアップグレードします。
この段階で、アプリのキャッシュをクリアすることをおすすめします。方法を確認する
これは任意ですが、サードパーティ製のアプリに関する問題を回避するのに役立ちます。
Configure UPM app signature check
Before proceeding with your Confluence 10 upgrade or installation, configure the Universal Plugin Manager (UPM) app signature check.
If no certificate is installed for signature verification, app installation will fail with the 'Signature check failed!' error on the Manage Apps screen.
11. リバース プロキシを更新し、Confluence にアクセスできることを確認する
アップグレードが完了したら、(直接ではなく) リバース プロキシ経由で Confluence にアクセスし、以下を実施する必要があります。
- [管理] メニュー に移動して、[一般設定] > [共同編集] の順に選択し、Synchrony のステータスが [実行中] であることを確認します。
- ブラウザが Synchrony に接続できることを確認するために任意のページを編集します。
リバース プロキシの設定が誤っている可能性があり、Synchrony が実行されないか、エディターでエラーが発生する場合、推奨される次の手順について、「共同編集のトラブルシューティング」を参照してください。
トラブルシューティング
問題が発生した場合
アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。