How to Create a Test or Development Instance

Adminstrators 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. On the original server, create zips of the Confleunce install and home directories. Copy the zips to the new server.
   
   
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. このステップはどのデータベースを使用しているかによって異なります:
   
   
   1. For users of the internal database, the content is stored inside the home directory. You should switch to an external database after the transfer is successful.
      1. For databases stored on another server: change the user account or datasource permissions so that the new server has the same network access permissions as the original. Then confirm from the new server that the hostname can be resolved and is listening for database connections on the expected port.
      2. For external databases stored locally: on the original server, create a manual database backup using a native db dump backup tool. Copy the database backup to the new server.
   2. 移行先サーバーにおいて、元のサーバーと同一バージョンになるようにデータベースのインストールまたはアップグレードを行います。
   3. データベースバックアップをインポートします。
   4. 元サーバーと同一のユーザー名とパスワードを有するデータベースユーザーアカウントを作成します。
   5. 作成したデータベースユーザーに、インポートされたデータベースに対するフルアクセス権限を付与します。
   6. データベース管理ツールを使用して、そのユーザーがローカルホストからログインできることを確認します。
   7. データベース接続情報を変更するときは Confluence のホームディレクトリに移動して confluence.cfg.xml を編集します。接続 URL は、hibernate.connection.url で指定します。この URL が本番環境用データベースサーバーを示していないことを確認してください。
   8. ユーザー管理対象が内部ユーザーのみの場合はこのステップは不要です。JIRA または LDAP を組み込んでいる場合、それらのホストへのネットワークアクセスまたはローカルアクセス権限を元のサーバーと同様に移行先サーバーに付与します。
   9. If appropriate, make sure no emails are sent out from the test system.
   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. If you configured Confluence as a Windows service, repeat those instructions.
   13. Add your development license key.

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

For XML backups

If you're not yet using the Alternate 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. 
   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. Add your development license key.
7. Restore your XML Backup From <<Administration > Backup and Restore>>.
8. If appropriate, make sure no emails are sent out from the test system.

For SQL dumps

If you are using the Alternate backup strategy, follow these steps:

1. Download the proper distribution 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.
14. If appropriate, make sure no emails are sent out from the test system.
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. If you configured Confluence as a Windows service, repeat those instructions.
18. Add your development license key.

h2. Ensuring no contact with production systems

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

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

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

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

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

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

以上の設定が完了すると、テストインスタンスを起動しても、メールの送受信は行われなくなります。なお、この他にプラグイン（SQL マクロなど）が本番環境システムにアクセスする可能性があることに留意してください。テスト インスタンスの起動後、これらのプラグインを速やかに無効にする必要があります。