サーバー間の Confluence 移行

On this page:

How to Create a Test or Development Instance

Administrators may need to move a Confluence instance from one server to another for upgrades or downtime. This page tells you how to copy a Confluence instance from one server to another. For example, you may want to transfer your current production snapshot to a test server as permitted in the licence agreement.

同一のオペレーティングシステムを有するサーバーへの Confluence の移行

両方のサーバーのオペレーティングシステムが同一である場合、ホームフォルダーおよびインストールフォルダーを直接コピーすることにより、元と同じ外部データベースを利用し、同一のユーザー管理情報を設定することができます。

1. 元のサーバーにおいて Confluence のインストールディレクトリとホームディレクトリの ZIP 圧縮ファイルを作成します。
   
   
2. On the new server, unzip the install and home directories. Windows users should avoid unzipping with the Windows built-in extractor, instead use Winzip or the free 7Zip.
   

   ホームディレクトリの場所を変更する場合は、Confluence install\confluence\WEB-INF\classes ディレクトリを開き、confluence-init.properties を編集して、'confluence.home=' で始まる行を修正します。

   
   
3. 必要な場合、war ファイルの場所を変更します。このファイルは、Tomcat を使用しているときは多くの場合 /Conf/Catalina/localhost にあります。ここで、docbase 属性が正しい場所をポイントしていることを確認してください。
4. このステップはどのデータベースを使用しているかによって異なります:
   
   
   1. Database configuration:
      1. For users of the internal database, the database content is stored inside the home directory. You should switch to an external database after the transfer is successful.
      2. 別サーバー上の外部データベースを使用している場合: ユーザーアカウントまたはデータソース権限を変更して、移行先サーバーに元のサーバーと同一のネットワークアクセス権限を付与します。次に、ホスト名が解決されて指定したポートにおいてデータベース接続のリスニングが開始されることを移行先サーバーから確認します。
      3. 元のサーバー上でローカルにホストされた外部データベースを使用している場合: 元のサーバーにおいて、データベースのダンプ・バックアップ用ネイティブツールを使用してデータベースのバックアップを手動で作成します。そのデータベースバックアップを移行先サーバーにコピーします。
   2. 移行先サーバーにおいて、元のサーバーと同一バージョンになるようにデータベースのインストールまたはアップグレードを行います。
   3. データベースバックアップをインポートします。
   4. 元サーバーと同一のユーザー名とパスワードを有するデータベースユーザーアカウントを作成します。
   5. 作成したデータベースユーザーに、インポートされたデータベースに対するフルアクセス権限を付与します。
   6. データベース管理ツールを使用して、そのユーザーがローカルホストからログインできることを確認します。
   7. データベース接続情報を変更するときは Confluence のホームディレクトリに移動して confluence.cfg.xml を編集します。接続 URL は、hibernate.connection.url で指定します。この URL が本番環境用データベースサーバーを示していないことを確認してください。
   8. If you are using internal user management, skip this step. For users who have JIRA or LDAP integration, provide the new server with network or local access to the same hosts as the original. If this is a true test instance, set up a test of your JIRA instance or LDAP server so as not to disrupt production systems and change the server.xml or atlassian-user.xml files to point to the appropriate test servers. Note that it might be acceptable to use a production connection here, as users won't be logging on to the test system in high volume.
   9. 必要であれば、テストシステムにテスト環境より E メールは送信されない設定がされていることを確認します。
   10. Confluence を起動します。
   11. Go to Administration > License Details and add your development license key. You can generate one at http://my.atlassian.com. There are more details in Getting a License for a Staging Environment.
   12. Confluence を Windows のサービスとして実行する設定にしていた場合は、これらの操作を繰り返します。
   13. 開発ライセンスキーを入力します。

異なるオペレーティングシステムを有するサーバーへの Confluence の移行

データベースツールを利用した移行 (推奨)

本番バックアップ計画に基づくバックアップを行っている場合は、次の手順で作業を進めてください:

1. Download the proper distribution (the same one you have from your original instance) from the Download Archive.
2. Confluence のホームディレクトリを元のサーバーからコピーします (OS が異なりますがここで行う操作はコピーです。インストールしてはなりません)。
3. ホームディレクトリの場所を変更する場合は、Confluence install\confluence\WEB-INF\classes ディレクトリを開き、confluence-init.properties を編集して、'confluence.home=' で始まる行を修正します。
4. 元のサーバーにローカルに格納されている外部データベースの場合は、データベースのダンプ・バックアップ用ネイティブツールを使用してデータベースのバックアップを手動で作成します。
5. そのデータベースバックアップを移行先サーバーにコピーします。
6. 移行先サーバーにおいて、元のサーバーと同一バージョンになるようにデータベースのインストールまたはアップグレードを行います。
7. データベースバックアップをインポートします。
8. 元サーバーと同一のユーザー名とパスワードを有するデータベースユーザーアカウントを作成します。
9. 作成したデータベースユーザーに、インポートされたデータベースに対するフルアクセス権限を付与します。
10. データベース管理ツールを使用して、そのユーザーがローカルホストからログインできることを確認します。
11. データベース接続情報を変更するときは Confluence のホームディレクトリに移動して confluence.cfg.xml を編集します。接続 URL は、hibernate.connection.url で指定します。この URL が本番環境用データベースサーバーを示していないことを確認してください。
12. ユーザー管理対象が内部ユーザーのみの場合はこのステップは不要です。JIRA または LDAP を組み込んでいる場合、それらのホストへのネットワークアクセスまたはローカルアクセス権限を元のサーバーと同様に移行先サーバーに付与します。
13. Copy server.xml, atlassian-user.xml, osuser.xml, any patches, and any other customized files velocity or properties files. If you are using internal user management, skip this step. For users who have JIRA or LDAP integration, provide the new server with network or local access to the same hosts as the original. If this is a true test instance, set up a test of your JIRA instance or LDAP server so as not to disrupt production systems and change the server.xml or atlassian-user.xml files to point to the appropriate test servers. Note that it might be acceptable to use a production connection here, as users won't be logging on to the test system in high volume.
14. 必要であれば、テストシステムにテスト環境より E メールは送信されない設定がされていることを確認します。
15. Confluence を起動します。
16. Go to Administration > License Details and add your development license key. You can generate one at http://my.atlassian.com. There are more details in Getting a License for a Staging Environment.
17. Confluence を Windows のサービスとして実行する設定にしていた場合は、これらの操作を繰り返します。
18. 開発ライセンスキーを入力します。

For XML backups (only for small to medium sized installations)

If you're not yet using the Production backup strategy, you can do this with your regular XML backup. Create a backup and import into the new server.

1. Create a backup from Confluence:

   1. Go to the Confluence 'Administration Console'. To do this:

      • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administrator Access' login screen will be displayed.
      • Enter your password and click 'Confirm'. You will be temporarily logged into a secure session to access the 'Administration Console'.
   2. Select 'Backup & Restore'.
   3. Check the 'Backup Attachments' option and select 'Backup'.
      
      
2. Identify the current version of Confluence your are using, displayed at the bottom of each Confluence page.
3. Download the same version as you are currently using to the new server, which may be the current Confluence release, or an older version.
4. Go to Administration > License Details and add your development license key. You can generate one at http://my.atlassian.com. There are more details in Getting a License for a Staging Environment.
5. Using the same version, follow the Upgrading Confluence guide.
6. 開発ライセンスキーを入力します。
7. Restore your XML Backup From <<Administration > Backup and Restore>>.
8. 必要であれば、テストシステムにテスト環境より E メールは送信されない設定がされていることを確認します。

本番環境システムとの通信遮断設定

外部システムとの通信を遮断するため、インバウンドおよびアウトバウンド両方向のメールサービスを無効化します。

1. 次のデータベースクエリを実行してグローバルなアウトバウンドメールを無効化します:

   SELECT * FROM BANDANA WHERE BANDANAKEY = 'atlassian.confluence.smtp.mail.accounts';
   

2. 次のデータベースクエリを実行してスペースレベルでのメールアーカイブ機能を無効化します:

   SELECT * FROM BANDANA WHERE BANDANAKEY = 'atlassian.confluence.space.mailaccounts';
   

指定したアカウントを削除してもよければ、上記クエリの 「ELECT *」を「DELETE」に書き換えます。

Once this is done, you can start your test instance without any mails being sent or retrieved. Think carefully about other plugins which may access production systems (SQL macro, JIRA macro, etc.). I They write content, or create unwanted load on external systems, they should be disabled promptly after starting the test instance.

インスタンスのマージ

If you wish to merge two instances, you can consider using the remote import plugin. This plugin is currently unsupported. The supported method would be to export a space and then import spaces one by one. The two instances must be the same version.

HTTPS から HTTP への移行

You may want to migrate from a server secured by SSL to one which is not secured by SSL. For example, this may be useful if you are copying a Confluence from production to a test site.

HTTPS から HTTP に移行する場合、セキュアなログインとページセキュリティのための SSLの追加の説明に従って行われた SSL 特有の設定をすべて元に戻します。