Confluence 手動アップグレード
This document describes the procedure for upgrading to the latest version of Confluence on Windows or Linux manually (not using the upgrade wizard). See Upgrading Confluence to upgrade using the installer and upgrade wizard.
始める前に
- Check your Confluence licence is valid.
To check go to
> General Configuration > Support Tools and make sure the license support period has not expired. If your support period has expired renew your licence and reapply it before proceeding with the upgrade.
- アップグレードするバージョンおよびスキップするバージョンについて、リリースノートとアップグレードノートを確認してください。
- Java のバージョン、アプリケーション サーバー、OS、データベース、ブラウザがサポート対象であるか確認してください。
サポート対象のプラットフォームおよびConfluence サポート期間終了のお知らせで、最新の要件を確認してください。
- ご利用のデータベースにつき、最新のデータベース セットアップガイドで、データベースの設定が正しいか、確認してください。新しい設定要件が追加されている可能性があります。データベース設定を確認してください。
- Check the compatibility of any add-ons.
Some add-ons may not yet be compatible with the latest version of Confluence. See Checking app compatibility with application updates to find out how to check this in the Universal Plugin Manager.
- インスタンスに影響するおそれのある既知の問題を確認してください。
アップグレードするバージョンについて、既知の問題をConfluence ナレッジベースで確認します。また、サポート対象の外部データベースに関連する既知の問題についても、データベースのトラブルシューティングで確認してください。
- Confluence に施した修正は記録しておいてください（例えば、レイアウト、カスタムテーマ）。
カスタマイズを維持するには、アップグレード後に再度適用する必要があります。
Step 1 アップグレード パスと方法を決定する
次の表を参考にして、ご利用の現行バージョンから Confluence 最新バージョンへの最も有効なアップグレード パスを決定してください。現在インストールされているバージョンを表の左列で探し、推奨パスにしたがいます。
ご利用のバージョン | Confluence 5 への推奨アップグレードパス |
|---|---|
| 2.7 以前 | 2.7.4 へアップグレードした後、3.5.17 へアップグレードし、以降のパスに従います。 |
| 2.8 〜 3.4 | 3.5.17 にアップグレードし、以降のパスに従います。 |
| 3.5 | 5.0.3 にアップグレードし、Confluence 5 の最新バージョンにアップグレードします。 |
4.0 〜 4.3 | Confluence 5 の最新バージョンに直接アップグレードします。 |
5.0 〜 5.9 | Confluence 5 の最新バージョンに直接アップグレードします。 |
アップグレード方法を決定する要因は以下の通りです：
- Are moving to a different database you should upgrade first and then follow the procedure outlined in Migrating to Another Database.
- Are running Confluence in a cluster you should follow the procedure outlined in Upgrading Confluence Data Center.
- Are using the embedded (trial) database you should migrate to a different database before upgrading. This database is supplied for evaluation purposes only and is not recommended for production environments. See Embedded H2 Database for more information.
Step 2 テスト環境で Confluence をアップグレードする
- 現在の Confluence の本番環境のスナップショットをテストサーバーに作成します。作成方法は、サーバー間での Confluence の移行を参照してください。
- 手順にしたがって、クローン環境でアップグレードを実行します。
- Test all your unsupported add-ons (plugins) and any customisation (for example custom themes and layouts) with the new version before proceeding with the upgrade in your production environment.
ステップ 3 バックアップ
- 外部データベース
外部データベースのバックアップを手動で実施し、そのバックアップが適切に作成されたか確認してください。データベースのバックアップや復元機能にあまり詳しくない場合は、次に進む前にそのバックアップを異なるデータベース システムで復元すれば、バックアップが正常に行われたたか確認できます。 - Confluence ホーム ディレクトリ
Confluence ホーム ディレクトリとは、Confluence がその構成情報、検索用インデックス、およびページ添付ファイルを保存するフォルダーです。ホーム ディレクトリの場所の情報は、Confluence インストール ディレクトリ下のconfluence/WEB-INF/classesディレクトリにあるconfluence-init.propertiesという名称の設定ファイルに保存されています。
添付ファイルを Confluence ホーム ディレクトリの外部で保存している場合は、添付ファイル ディレクトリのバックアップも実施する必要があります。 - Confluence インストール ディレクトリ
Confluence をインストールした時の、Confluence アプリケーション ファイルやライブラリの解凍（zip ファイル展開）先のディレクトリです。
Step 4 本番環境で Confluence をアップグレードする
- Download the appropriate archive file.
- Confluence をシャットダウンします。
- ディレクトリ（新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります）にファイルを抽出（解凍）します。
注意：Windows でのアーカイブファイル解凍について既知の問題が報告されています。7Zip または Winzip の使用を推奨します。 Update the following line in the
<Installation-Directory>\confluence\WEB-INF\classes\confluence-init.propertiesfile to point to your existing Confluence home directory.# confluence.home=c:/confluence/dataFor example if your existing Confluence home directory is
c:\confluence\myhomethe file will read:confluence.home=c:/confluence/myhome- Copy the JDBC driver jar file from your existing Confluence installation directory to
confluence/WEB-INF/libin your new installation directory.
The JDBC driver will be located in either the<Install-Directory>/common/libor<Installation-Directory>/confluence/WEB-INF/libdirectories. - 以下のような場合は追加ステップを実施する必要があります：
Confluence をWindows サービスとして実行している場合
ここをクリックして展開...Confluence を Windows サービスとして実行している場合、コマンドプロンプトを開き、以下の通り入力します：
<Installation-Directory>\bin\service.bat remove ConfluenceConfluence の古いインスタンスをアンインストールする前に既存のサービスを停止して削除することが重要です。Confluence を Windows サービスとして実行する際の詳細情報については、Confluence を Windows でサービスとして自動的に起動するを参照してください。
Confluence インストーラーでインストールしたサービスを削除するには、<confluence auto installer installation folder>\UninstallService.batを実行する必要があります。
ユーザー管理に JIRA アプリケーションまたは LDAP を使用している場合
ユーザーの管理にCrowdを使用している場合
Confluence 2.5以前からアップグレードする場合
Confluence を異なるポート（デフォルトポート 8090 以外）で実行している場合
- 新しい Confluence を起動します。セットアップ ウィザードが表示されないはずです。
さらにカスタマイズがある場合の追加ステップ
If you have customised Confluence (such as an SSL configuration in the server.xml file, or CATALINA_OPTS or JAVA_OPTS parameters in your confluence-init.properties file), you'll need to perform the following steps after the upgrade is complete:
- アップグレードされた Confluence インスタンスを停止します。
- 関連するファイルのカスタマイズを、新たにアップグレードされた Confluence インストール ディレクトリ に再適用します。
- アップグレードされた Confluence インスタンスを再起動します。
Confluence に変更があり、それによりカスタマイズが使用できない可能性もあるため、本番インスタスでアップグレードを実施する前に、テスト インスタンスでカスタマイズのテストを実施することを強く推奨します。
トラブルシューティング
問題が発生した場合
アップグレードを再試行する必要がある場合、最初にアップグレード前のバックアップを復元する必要があります。アップグレードに失敗した後に、アップグレードの再試行や Confluence の旧バージョンの起動を行わないでください。
You can also refer to the Upgrade Troubleshooting guide in the Confluence Knowledge Base, or check for answers from the community at Atlassian Answers.