このドキュメントでは、Confluence のデータを既存のデータベースから別のデータベースに移行する方法について説明します。以下の手順は、主に評価データベースから本番データベースに移行することを目的としています。大規模なデータセットの移行には、サードパーティのデータベース移行ツールが必要になります。
本ページでは、次のシナリオを取り上げます。
組み込みのテスト用データベースからサポートされた外部データベースへの移行。
- 1 つの外部データベースから別の外部データベースへの移行、たとえば、Oracle から PostgreSQL （データセットが大きくない場合）
同じ外部データベースの新しいバージョンへのアップグレード。注意：同じ場所でデータベースをアップグレードする場合、データを移行する必要はありません。
Note: If you are moving your database from one server to another you can change the JDBC URL in <confluence.home>/confluence.cfg.xml (if you are using a direct JDBC connection) or in the definition of your datasource (if you are connecting via a datasource).
On this page: 関連ページ |
データベース移行の制限事項
データベースの移行
移行を実行する方法には 2 種類あり、どちらも本ページで説明しています。
方法 1 は標準的な手順です。
インストールの添付ファイルの合計サイズが 500 メガバイトを超える場合、方法 2 を使用します。
方法 1 - 標準的な手順
ステップ 1 ：アドオンをメモする
ステップ 2： データをバックアップする
- Create an XML backup of your existing data, via the Confluence administration console. See Manually Backing Up the Site. Make a note of the location where you put the XML file. You will need it later to import your Confluence data into your new database.
- Confluence をシャットダウンします。
- Make a copy of the Confluence Home directory. This is a precautionary measure, to ensure you can recover your data if it is mistakenly overwritten.
- 外部データベースを使用している場合、そのデータベースとともにインストールされたユーティリティを使用して、バックアップを別に作成します。これも予防措置です。
ステップ 3：新しいデータベースを設定する
ステップ 4.新しい場所に Confluence（同じバージョン番号）をインストールする
ステップ 5.必要に応じて、データベース ドライバをダウンロードし、インストールする
ステップ 6.Confluence のセットアップ ウィザードを実行し、新しいデータベースにデータをコピーする
ステップ 7.アドオンを再インストールする
ステップ 8.新しいマシンの設定を確認する
方法2 - 大容量の添付ファイルをインストールする場合
始める前に
These instructions only apply to attachments stored in the file system. If you store attachments in the database see Attachment Storage Configuration to find out how to migrate between different attachment storage methods.
ステップ 1 ：アドオンをメモする
ステップ 2： データをバックアップする
- Create an XML backup of your existing data, via the Confluence administration console. See Manually Backing Up the Site. Make a note of the location where you put the XML file. You will need it later to import your Confluence data into your new database.
- Confluence をシャットダウンします。
- Confluence ホーム ディレクトリ内の attachments ディレクトリ (
<CONFLUENCE-HOME-DIRECTORY>\attachments) のコピーを作成します。このデータは、以降で新しい Confluence インストールに Confluence の添付ファイル データをコピーする際に必要になります。 - 外部データベースを使用している場合、そのデータベースとともにインストールされたユーティリティを使用して、バックアップを別に作成します。これも予防措置です。
ステップ 3：新しいデータベースを設定する
ステップ 4.新しい場所に Confluence（同じバージョン番号）をインストールする
ステップ 5.必要に応じて、データベース ドライバをダウンロードし、インストールする
ステップ 6. Confluence のセットアップ ウィザードを実行し、新しいデータベースにデータをコピーする
ステップ 7 ：添付ファイルをコピーする
attachments ディレクトリ (<CONFLUENCE-HOME-DIRECTORY>\attachments) のコンテンツを、古い Confluence ホーム ディレクトリから新しい Confluence ホーム ディレクトリにコピーします。
ステップ 8.アドオンを再インストールする
ステップ 9.新しいマシンの設定を確認する
データベース内の大文字と小文字の区別に関する注意
「照合」はデータの並べ替えと比較の方法を決定する一連のルールを指します。大文字と小文字の区別は照合の観点の 1 つです。他の観点としては、仮名（日本語スクリプト）の区別や文字幅（1 バイト文字と 2 バイト文字）の区別があります。
照合時の大文字と小文字の区別の有無 - どのような設定で Confluence データベースを作成する必要があるでしょうか？既存の Confluence インスタンスを別のデータベースに移行するときはどうでしょうか？
新しい Confluence インスタンスの設定
新しい Confluence インスタンスの場合、Confluence データベースで大文字と小文字を区別する照合を使用することをお勧めします。これは多くのデータベースシステムで使用される既定の照合タイプです。
注意：データベースが大文字と小文字を区別して照合するように設定されている場合でも、Confluence はすべてのユーザー名を小文字に変換してからデータベースに保存します。たとえば、「joebloggs」と「joeBloggs」と「JoeBloggs」は同じユーザー名として扱われることになります。
別のデータベースへの既存の Confluence インスタンスの移行
既定の Confluence 設定では、データベースで大文字と小文字を区別する照合を使用します。これは、既定の条件で作成されたデータベースでは典型的な設定です。このタイプの設定から新しいデータベースに移行する場合、新しいデータベースで大文字と小文字を区別する照合を使用することをお勧めします。データを保存していた元の Confluence サイトでは大文字と小文字の区別が必要であり、移行先で大文字と小文字を区別しない照合を使用する場合、（たとえば、XML インポート経由で）移行した後のデータに整合性の問題が発生する可能性があります。
トラブルシューティング
See our troubleshooting guide if you're unable to restore your XML backup.