Apache Tomcat への切り替え
Apache Tomcat は Confluence でサポートされる唯一のアプリケーション サーバーです。同じデータベースを使用するアプリケーション サーバー（WebSphere など）から Tomcat に Confluence を移動させるには、以下の手順を実行します。
次の手順に従ってください。
1. 作業を始める前に
- 以下の手順は、両方のアプリケーション サーバーで同じメジャー バージョンの Confluence を実行している場合のみ、動作します。異なるメジャー バージョンの Confluence を実行している場合は、Tomcat に切り替える前に、Confluence をアップグレードする必要があります。
- アプリケーション サーバーを変更するプロセスでは、Confluence をインストールする必要があるため、現在のソフトウェアのメンテナンスが必要なことに注意してください。
- Confluence を実行している環境（データベースシステム、オペレーティング システムなど）が変更したら、Confluence のシステム要件を満たしていることを確認してください。
- 外部データベースをご利用の場合は、そのデータベースの既知の問題点をすべて調べておく必要があります。さらに、Confluence のデータベース コネクター プリンシパル (データベース ユーザー ログイン) にデータベース スキーマを変更できる権限が付与されていることを確認してください。
- Confluence に加えた変更（有効化した/インストールしたプラグイン、変更したレイアウト、カスタム テーマなど）をメモします。Tomcat に切り替えた後、これらを再適用する必要があります。以下の「カスタマイズの再適用」セクションで、カスタマイズのリストを参照することができます。
- パフォーマンスの問題を防ぐため、Confluence を実行している Tomcat アプリケーション サーバーで他のアプリケーションを実行しないことをお勧めします。
2. バックアップ
Tomcat に切り替える前に、以下をバックアップする必要があります。
- Confluence ホーム ディレクトリのバックアップ:ホーム ディレクトリの場所の情報は、Confluence インストール ディレクトリ下の
confluence/WEB-INF/classesディレクトリにあるconfluence-init.propertiesという名称の設定ファイルに保存されています。 - データベースのバックアップ： アップグレード作業に進む前に外部データベースの手動バックアップを実行し、バックアップが正常に作成されたことをチェックしてください。データ ベースに関する十分な知識がない場合や、データベースのバックアップ・復元機能に慣れていない場合は、次に進む前にそのバックアップを異なるデータベース システムに復元してみて、バックアップが正常に行われたことを確認してください。この推奨事項は、Confluence の使用の固有のものではなく、データベース バックアップが壊れていないことを確認するための良い習慣です。
「組み込みデータベース」とは、Confluence が評価用に提供している HSQLDB のことであり、これはホーム ディレクトリに格納されているため、バックアップする必要はありません。ですが、このデータベースを本番環境システムに使用しないでください。誤って本番環境システ ムで HSQLDB を使用している場合は、適切なデータベースに移行してください（移行はアップグレードの前に実施してください）。 - Confluence インストール ディレクトリをバックアップします。
3. アプリケーション サーバーの切り替え
新しいアプリケーション サーバーに Confluence をインストールします。（インストーラを使用するのではなく）スタンド アローン アーカイブとして Confluence をダウンロードすることをお勧めします。
重要： この段階でスタンドアローン ファイルを解凍した場所が新しいインストール ディレクトリになります。以下の手順 3 で指示するまで、Confluence を起動しないでください。- 以下のファイルを古い 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(データソースを設定する場合など、以前に変更した場合は、これをコピーしてください)
- <
- Confluence を起動します（新しいサーバーを起動する前に、古いサーバーが停止していることを確認します）。
- 元のアプリケーションサーバーとは異なるマシン上で移行先アプリケーションサーバーを起動している場合、移行先サーバーを起動した時点で次の作業を実行してください。
- データのインデックスの再構築。
- 移行先サーバーで添付ファイルの場所が有効であることの確認。
- Confluence サーバーおよび/または Confluence のルック アンド フィールに特別な設定を適用した場合は、以下に記載されるように、これらのカスタマイズを再適用する必要があります。
4. カスタマイズの適用
Tomcat に切り替えたら、以前 Confluence インスタンスに使用したカスタマイズとその他の特別な設定を確認し、必要であれば再適用します。このセクションには、以前 Tomcat で Confluence を使用していなかった場合に適用を検討したほうがよい、いくつかの Tomcat 特有のカスタマイズを含んでいます。
カスタマイズの適用前に
以下のカスタマイズのいずれかを適用する前に、カスタマイズなしで、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 インスタンスに対する負荷が高い場合、データベースへの同時接続を増やす必要が生じることもあります。詳細については、「パフォーマンスのチューニング」を参照してください。
- 以前に
<Installation-Directory>\bin\setenv.shまたはsetenv.batファイルのいずれかでメモリ フラグ (XmsおよびXmx) を変更した場合は、新しいインストールで変更を加えることをお勧めします。パラメーターはCATALINA_OPTS変数で指定されています。詳細については、利用可能なメモリを増やして out of memory エラーを修正する方法を参照してください。
高度なカスタマイズ
- 以前に SSL で Confluence を実行していた場合、「SSL または SSL で Confluence を実行する」で説明されているように設定を再適用する必要があります。
- カスタム SSO 認証を使用していた場合、seraph-config.xml を正しい認証に変更します。
- Confluence のインターフェース テキストを変更した場合、ConfluenceActionSupport.properties にコピーする必要があります。
- 以前に Confluence ソース コードを変更した場合、新しいバージョンに変更を再適用する必要があります。
5. Confluence のテスト
本番環境にデプロイする前に、新しいサーバー上で Confluence をテストするようにしてください。
参照する必要があれば、「Confluence ログを使用する」ドキュメントにアプリケーション ログの場所が記載されています。
最終更新日 2019 年 5 月 31 日
Powered by Confluence and Scroll Viewport.