サーバー間の Confluence 移行

On this page:

はじめに

このページでは、Confluence を物理的に異なるサーバーに移動する方法について説明します。他の機能とは違う様々な特質がこの機能にはありますのでご注意ください。 ただし、データベースの移行、アプリケーションサーバーの移動、アップグレードについてはここでは説明しません。アトラシアンはこれらを別々の作業として 実施することを推奨しています。なお、以下の説明もご覧ください:

• Upgrading Confluence
• Migrating to Another Database
• 2017-11-01_06-00-05_Switching to Apache Tomcat

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. 開発ライセンスキーを入力します。
5. Some customers have experienced problems with Confluence's search functions after performing a migration, or that the content of their {recently-updated} macro is not being updated correctly. Errors in the atlassian-confluence.log file corroborate such problems. Hence, to avoid these issues, it is strongly recommended that you perform a rebuild of your content indices after performing a migration.

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

    <property name="attachments.dir">${confluenceHome}/attachments</property>
    <property name="lucene.index.dir">${confluenceHome}/index</property>
    <property name="webwork.multipart.saveDir">${confluenceHome}/temp</property>

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

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

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. 開発ライセンスキーを入力します。
19. Some customers have experienced problems with Confluence's search functions after performing a migration, or that the content of their {recently-updated} macro is not being updated correctly. Errors in the atlassian-confluence.log file corroborate such problems. Hence, to avoid these issues, it is strongly recommended that you perform a rebuild of your content indices after performing a migration.

XML 形式データバックアップを利用した移行 (中小規模システム向け)

本番バックアップ計画に基づくバックアップを行っていない場合は、通常の XML 形式データバックアップを作成し、それを移行先サーバー上の Confluence にインポートする方法によって Confluence を移行することが可能です。

1. 以下の手順で XML 形式データバックアップを作成します:

   1. Go to the Confluence 'Administration Console':

      • Choose Browse > 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. バックアップと復元を選択する。
   3. Check the Backup Attachments option and click Backup.
      
      
2. 利用中の Confluence のバージョンを確認します。これは Confluence の各ページ下部に表示されています。これは Confluence の各ページ下部に表示されています。
3. Download Confluence to the new server. Get the version of Confluence that you identified above, but for the operating system of the new server. You may be using either the latest Confluence version, or an older version.
4. 移行先サーバーに Confluence をインストールします。
5. Go to Administration > License Details and add your development license key. You can generate a license at http://my.atlassian.com. You can find more details in Getting a License for a Staging Environment.
6. 管理 > バックアップと復元に移動し、XML 形式データバックアップをリストアします。
7. 必要であれば、テストシステムに E メール連絡無しの設定がされていることを確認します。
8. Some customers have experienced problems with Confluence's search functions after performing a migration, or that the content of their {recently-updated} macro is not being updated correctly. Errors in the atlassian-confluence.log file corroborate such problems. Hence, to avoid these issues, it is strongly recommended that you rebuild your content indices after performing a migration.
   

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

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

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

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

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

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

Change 'SELECT' to 'DELETE' in the above queries once you are sure you want to remove the specified accounts.

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.). If these 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 each space one by one. The two instances of Confluence 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 instance from a production to a test site.

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