Apache Tomcat への切り替え

Apache Tomcat は Confluence でサポートされる唯一のアプリケーション サーバーです。同じデータベースを使用するアプリケーション サーバー（WebSphere など）から Tomcat に Confluence を移動させるには、以下の手順を実行します。

次の手順に従ってください。

1. 作業を始める前に

1. 以下の手順は、両方のアプリケーション サーバーで同じメジャー バージョンの Confluence を実行している場合のみ、動作します。異なるメジャー バージョンの Confluence を実行している場合は、Tomcat に切り替える前に、Confluence をアップグレードする必要があります。
2. アプリケーション サーバーを変更するプロセスでは、Confluence をインストールする必要があるため、現在のソフトウェアのメンテナンスが必要なことに注意してください。
3. Confluence を実行している環境（データベースシステム、オペレーティング システムなど）が変更したら、Confluence のシステム要件を満たしていることを確認してください。
4. 外部データベースをご利用の場合は、そのデータベースの既知の問題点をすべて調べておく必要があります。さらに、Confluence のデータベース コネクター プリンシパル (データベース ユーザー ログイン) にデータベース スキーマを変更できる権限が付与されていることを確認してください。
5. Confluence に加えた変更（有効化した/インストールしたプラグイン、変更したレイアウト、カスタム テーマなど）をメモします。Tomcat に切り替えた後、これらを再適用する必要があります。以下の「カスタマイズの再適用」セクションで、カスタマイズのリストを参照することができます。
6. パフォーマンスの問題を防ぐため、Confluence を実行している Tomcat アプリケーション サーバーで他のアプリケーションを実行しないことをお勧めします。

2. バックアップ

Tomcat に切り替える前に、以下をバックアップする必要があります。

1. Confluence ホーム ディレクトリのバックアップ:ホーム ディレクトリの場所の情報は、Confluence インストール ディレクトリ下の confluence/WEB-INF/classes ディレクトリにある confluence-init.properties という名称の設定ファイルに保存されています。
2. Back up your database. Perform a manual backup of your external database before proceeding with the upgrade and check that the backup was created properly. If you are not a database expert or unfamiliar with the backup-restore facilities of your database, you should try to restore the backup to a different system to ensure that the backup worked before proceeding. This recommendation is not specific to Confluence usage, but it is good practice to ensure that your database backup is not broken.
   The 'embedded database' is the HSQLDB database supplied with Confluence for evaluation purposes, you don't need to back it up since it is stored in the home directory. But you should not use this database for production systems anyway, so if you happen to accidentally still use HSQLDB in a production system, please migrate to a proper database before the upgrade.
3. Confluence インストール ディレクトリをバックアップします。

3. アプリケーション サーバーの切り替え

1. Install Confluence on your new application server. We recommend that you download Confluence as a stand alone archive (rather than using the installer). 
    Important: At this stage, just unzip the standalone file to a location of your choice - this will be your new installation directory. You should not start Confluence until directed to in step 3 below. 

2. 以下のファイルを古い Confluence インストールから新しいインストールにコピーします。
   • <CONFLUENCE_INSTALL>\confluence\WEB-INF\classes\confluence-init.properties
   • <CONFLUENCE_INSTALL>\confluence\WEB-INF\classes\atlassian-user.xml
   • <CONFLUENCE_INSTALL>\confluence\WEB-INF\classes\osuser.xml (JIRA ユーザー管理を使用している場合は、これをコピーしてください)
   • <CONFLUENCE_INSTALL>\confluence\WEB-INF\classes\seraph-config.xml (カスタム SSO を使用している場合は、これをコピーしてください)
   • <CONFLUENCE_INSTALL>\confluence\WEB-INF\web.xml (データソースを設定する場合など、以前に変更した場合は、これをコピーしてください)
3. Confluence を起動します（新しいサーバーを起動する前に、古いサーバーが停止していることを確認します）。
4. 元のアプリケーションサーバーとは異なるマシン上で移行先アプリケーションサーバーを起動している場合、移行先サーバーを起動した時点で次の作業を実行してください。
   • データのインデックスの再構築。
   • 移行先サーバーで添付ファイルの場所が有効であることの確認。
5. Confluence サーバーおよび/または Confluence のルック アンド フィールに特別な設定を適用した場合は、以下に記載されるように、これらのカスタマイズを再適用する必要があります。

4. カスタマイズの適用

Tomcat に切り替えたら、以前 Confluence インスタンスに使用したカスタマイズとその他の特別な設定を確認し、必要であれば再適用します。このセクションには、以前 Tomcat で Confluence を使用していなかった場合に適用を検討したほうがよい、いくつかの Tomcat 特有のカスタマイズを含んでいます。

Confluence Server

• 長期間にわたるご使用に際しては、Confluence をオペレーティング システムが再起動するとき自動的に起動するように設定することをお勧めします。Windows サーバーに関しては、Confluence を Windows サービスとして実行するように設定してください。
• Confluence エディションを使用し、以前にCATALINA_HOME 環境変数を定義していた場合、新しい Confluence Tomcat サーバーが正しいパスを参照しているか確認してください。
• 以前に非標準ポートで Confluence を実行していた場合は、「Confluence のリッスン ポートの変更」の説明に従って、新しい <Installation-Directory>\conf\server.xml ファイルを編集します。

プラグイン

• 以前にプラグインを使用していた場合、最新の互換バージョンをインストールし、新しい Confluence のインストールとの互換性がないプラグインを無効化します。Confluence 管理コンソールのユニバーサル プラグイン マネージャーを使用すると簡単にこれを行うことができます。

ルック アンド フィール

• カスタマイズしたテーマを使用している場合、期待通りに表示されているか確認してください。新しいバージョンの Confluence と互換性を持たせるため、さらなるカスタマイズが必要な場合があります。
• 以前にデフォルト サイトまたはスペース レイアウトをカスタマイズした場合、ここで説明されているように、新しいデフォルトに変更を再適用する必要があります。VM （velocity）ファイルを単純にコピーしないでください。カスタム レイアウトなしでも Confluence が動作することを確認してから、Confluence 管理コンソールを使用してレイアウトを適用します。

パフォーマンス

• Confluence インスタンスに対する負荷が高い場合、データベースへの同時接続を増やす必要が生じることもあります。詳細については、「パフォーマンスのチューニング」を参照してください。
• If you had previously modified the memory flags (Xms and Xmx) in either the <Installation-Directory>\bin\setenv.sh or the setenv.bat file, you may want to make the modifications in your new installation. The parameters are specified in the CATALINA_OPTS variable. See Fix java.lang.OutOfMemoryError in Confluence for more information.

高度なカスタマイズ

• 以前に SSL で Confluence を実行していた場合、「SSL または SSL で Confluence を実行する」で説明されているように設定を再適用する必要があります。
• カスタム SSO 認証を使用していた場合、seraph-config.xml を正しい認証に変更します。
• Confluence のインターフェース テキストを変更した場合、ConfluenceActionSupport.properties にコピーする必要があります。
• 以前に Confluence ソース コードを変更した場合、新しいバージョンに変更を再適用する必要があります。

5. Confluence のテスト

本番環境にデプロイする前に、新しいサーバー上で Confluence をテストするようにしてください。

参照する必要があれば、「Confluence ログを使用する」ドキュメントにアプリケーション ログの場所が記載されています。