Confluence 手動アップグレード
このガイドでは、zip / tar.gz ファイルを使用して、Windows または Linux 上で Confluence サイトを最新の Confluence バージョンにアップグレードする方法について説明します。
現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。
Confluence をアップグレードするその他の方法:
- インストーラー – Confluence をアップグレードする最も簡単な方法です。
- Data Center – Data Center クラスタをアップグレードします。
- ローリング アップグレード - ダウンタイムなしで、Data Center クラスタを最新の使用可能なバグ修正バージョンにアップグレードします。
Confluence のアップグレードに XML バックアップを使用することは推奨されません。
On this page:
はじめる前に
Confluence をアップグレードする前に、いくつかの質問に答える必要があります。
| マニュアルは正しいアップグレード方法ですか? | |
アップグレードの資格がありますか? | |
アトラシアンのサポート対象プラットフォームに変更はありますか? | |
| 環境に変更を加える必要はありますか? |
アップグレードを計画する
1. アップグレード パスを決定する
Error rendering macro 'includeplus'
User 'anonymous' does not have permission to view the page with ID 1026043881.
2. アップグレード前のチェックを完了する
Error rendering macro 'includeplus'
User 'anonymous' does not have permission to view the page with ID 1047555044.
3. テスト環境で Confluence をアップグレードする
Error rendering macro 'includeplus'
User 'anonymous' does not have permission to view the page with ID 957145907.
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ファイルを編集し、 既存 のホーム ディレクトリを指すようにします。Oracle または MySQL データベースを利用している場合、既存の Confluence インストール ディレクトリから新しいインストール ディレクトリの
confluence/WEB-INF/libに jdbc ドライバの jar ファイルをコピーする必要があります。
- 以下のような場合は追加ステップを実施する必要があります：
Confluence をWindows サービスとして実行している場合
ここをクリックして展開...Confluence を Windows サービスとして実行している場合、コマンドプロンプトを開き、以下の通り入力します：
<Installation-Directory>\bin\service.bat remove ConfluenceConfluence の古いインスタンスをアンインストールする前に既存のサービスを停止して削除することが重要です。Confluence を Windows サービスとして実行する際の詳細情報については、Confluence を Windows でサービスとして自動的に起動するを参照してください。
Confluence インストーラーでインストールしたサービスを削除するには、<confluence auto installer installation folder>\UninstallService.batを実行する必要があります。
Confluence を異なるポート（デフォルトポート 8090 以外）で実行している場合
- 新しい Confluence を起動します。セットアップ ウィザードが表示されないはずです。
アップグレード後
7. サービスを再インストールする (Windows のみ)
Windows で Confluence をサービスとして実行している場合、<install-directory>/bin/service.bat を実行して、既存のサービスを削除してサービスを再インストールする必要があります。
これにより、サービスで最新の JVM オプションを使用できます。
8. 変更の再適用
Confluence をカスタマイズ済みの場合 (server.xml ファイルでの SSL 設定、confluence-init.properties ファイル内の CATALINA_OPTS または JAVA_OPTS パラメータなど)、アップグレードの完了後に次の手順を実行する必要があります。
- アップグレードされた Confluence インスタンスを停止します。
- 関連するファイルのカスタマイズを、新たにアップグレードされた Confluence インストール ディレクトリ に再適用します。
- アップグレードされた Confluence インスタンスを再起動します。
Confluence に変更があり、それによりカスタマイズが使用できない可能性もあるため、本番インスタスでアップグレードを実施する前に、テスト インスタンスでカスタマイズのテストを実施することを強く推奨します。
9. リバース プロキシを更新し、Confluence にアクセスできることを確認する
Error rendering macro 'includeplus'
User 'anonymous' does not have permission to view the page with ID 866093738.
トラブルシューティング
問題が発生した場合
アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。