Apache Tomcat への切り替え

1. 以下の手順は、両方のアプリケーション サーバーで同じメジャー バージョンの Confluence を実行している場合のみ、動作します。異なるメジャー バージョンの Confluence を実行している場合は、Tomcat に切り替える前に、Confluence をアップグレードする必要があります。
2. Note that you need current software maintenance, as the process for changing application servers involves installing Confluence or Confluence EAR-WAR.
3. Confluence を実行している環境（データベースシステム、オペレーティング システムなど）が変更したら、Confluence のシステム要件を満たしていることを確認してください。
4. If you are using an external database, familiarise yourself with all known issues for your specific database. Also make sure the Confluence database connector principal (the database user login) has sufficient permissions to modify the database schema.
5. Note any customisations that you have made to Confluence, e.g. enabled/installed plugins, modified layouts, custom themes, etc. You will need to reapply these after you have switched to Tomcat. You can view the list of customisations in the Reapplying Customisations section below.
6. パフォーマンスの問題を防ぐため、Confluence を実行している Tomcat アプリケーション サーバーで他のアプリケーションを実行しないことをお勧めします。

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

1. Back up your Confluence Home directory. The Confluence Home directory is the folder where Confluence stores its configuration information, search indexes and page attachments. If you are using the embedded HSQLDB database supplied for evaluation purposes, the database files are also stored in this directory.
   Tip: Another term for 'Home directory' would be 'data directory'. The location of the Home directory is stored in a configuration file called confluence-init.properties, which is located inside the confluence/WEB-INF/classes directory in your Confluence Installation directory.
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. Back up your Confluence Installation directory (if you are using Confluence) or your Confluence webapp (if you are using Confluence EAR-WAR edition). The 'Confluence Installation directory' is the directory into which the Confluence application files and libraries have been unpacked (unzipped) when Confluence was installed. Confluence does not modify or store any data in this directory. This directory is also sometimes called the 'Confluence Install directory'.

1. Install Confluence on your new application server. We recommend that you install Confluence (from the zip file) as it is preconfigured with Tomcat. If you want more control over the installation process, you can install Confluence EAR-WAR on Tomcat however this requires more manual configuration.
   Regardless of which method you choose, as part of the installation process:
   • If you are connecting to your database via a standard JDBC connection, enter the URL, username and password for your existing database.
   • If you are connecting to your database via datasource, use the settings for your existing database when you configure the JDBC datasource in your new server. Refer to the appropriate guide below:
     • Apache Tomcat で MySQL データソースを設定する
     • Apache Tomcat で SQL Server データソースを設定する
     • Apache Tomcat で PostgreSQL データソースを設定する
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 (copy this over if you are using JIRA user management)
   • {CONFLUENCE_INSTALL}\confluence\WEB-INF\classes\seraph-config.xml (copy this over if you using custom SSO)
   • {CONFLUENCE_INSTALL}\confluence\WEB-INF\web.xml (copy this over if you have previously modified it, e.g. to configure a datasource)
3. Make sure you shutdown the old server before you startup the new one.
4. 元のアプリケーションサーバーとは異なるマシン上で移行先アプリケーションサーバーを起動している場合、移行先サーバーを起動した時点で次の作業を実行してください。
   • データのインデックスの再構築。
   • 移行先サーバーで添付ファイルの場所が有効であることの確認。
5. If you have applied special settings to their Confluence server and/or Confluence look and feel, you will need to reapply these customisations as described in below.

After switching to Tomcat, you need to review any customisations and other special configurations you previously used for your Confluence instance, and re-apply if necessary. This section also contains some Tomcat-specific customisations that you may wish to considering applying, if you haven't used Confluence with Tomcat before.

Confluence Server

• 長期間にわたるご使用に際しては、Confluence をオペレーティング システムが再起動するとき自動的に起動するように設定することをお勧めします。Windows サーバーに関しては、Confluence を Windows サービスとして実行するように設定してください。
• Confluence エディションを使用し、以前にCATALINA_HOME 環境変数を定義していた場合、新しい Confluence Tomcat サーバーが正しいパスを参照しているか確認してください。
• If you were previously running Confluence on a non-standard port, edit your new <Installation-Directory>\conf\server.xml file as described in Change listen port for Confluence.

プラグイン

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

ルック アンド フィール

• If you are using any customised themes, please check that they are displaying as expected. Some further customisation may be required to ensure compatibility with your new version of Confluence.
• If you had previously customised the default site or space layouts, you will need to reapply your changes to the new defaults as described here. Please do not just copy your VM (velocity) files across. Ensure that Confluence works without your custom layouts then apply the layout via the Confluence Administration console.

パフォーマンス

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

Advanced Customisations

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

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

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