目的

制限事項

ソリューション 1 - Atlassian Marketplace のアプリを使う

対象 クラウド サーバー DATA CENTER

もっとも推奨されるオプションは、スペースのコピー機能を提供しているいずれかのサードパーティ アプリを使用することです。例:

• Marketplace で「Copy Space」アプリを検索
• Bob Swift CLI tool などのコマンドライン ツールも、スペースのコピーなどの一括操作に便利です 

ソリューション 2 - ページ階層のコピー機能を使う

対象 クラウド サーバー DATA CENTER

Confluence 6.0 で、ページとそのすべての子ページをコピーする機能が追加されました。これは、スペース全体のコンテンツをコピーしたいときに便利です。 

次の手順は Confluence Server または Data Center 向けのものですが、Cloud でも同様のプロセスを利用できます。 

ページ階層のコピー機能を使ってスペースをコピーする方法は、次のとおりです。

1. 新しいスペースを作り、任意の権限、ルックアンドフィール、その他のカスタマイズを設定します。 

2. 元のスペースで、[スペース ツール] > [ページの並べ替え] に移動し、スペースの root に存在するページをホーム ページの子ページに一時的に移動させます。これは、リンクはマクロなどのページ間のつながりがコピー時に失われないようにするためです。root にページが存在しない場合はこの手順をスキップしてかまいません。 

3. スペースのホーム ページで、… > [コピー] を選択します。

4. 宛先として先ほどの新しいスペースを指定します。

5. [子ページを含める] を選択します。

6. ラベル、添付ファイル、制限が保持されるよう、すべてのチェックボックスが選択されているのを確認します。

7. [コピー] を選択します。スペースのサイズによっては少し時間がかかる可能性があります。ページはバッチ単位でコピーされるため、即座にすべてのデータが揃わない可能性があります。

8. 元のスペースに戻り、一時的に動かしたページをスペースの root に戻します。

9. 新しいスペースで、コピーしたページは新しいスペースの既存のホームページの子ページになります。[スペース ツール] > [ページの並べ替え] に移動し、コピーしたページをスペースの root に移動して、ホームページの子ページではなくなるようにします。

10. [スペース ツール] > [概要] に移動し、コピーしたホームページをスペースのホームページに設定します。

11. 不要なホームページを削除します。

12. ホームページの子ページにしたくないページ (ライブラリなど) をスペースの root に戻します。

このプロセス全体を短い動画でご確認いただけます。 

ソリューション 3 - スペースをエクスポートして XML を変更する

対象 クラウド サーバー DATA CENTER

ターゲット スペースの XML バックアップを変更して、スペースを手動でクローンしたり名前変更したりすることができます。 

<export_folder>/plugin-data/com.atlassian.activeobjects.confluence.spi/activeObjectsBackupRestoreProvider.pdata

ステージ 1: XML バックアップを生成してテスト インスタンスを作成する

1. 2 つ目のスペース用に、一意の新しいスペース キーと名前を用意します。スペース キーではASCII 文字と数字のみ (A-Z、a-z、0-9) を利用できます。キーでは空白文字、特殊文字、アンダースコアは利用できません。スペース キーに無効な文字が含まれている場合、再インポートは失敗し、スタック トレースが記録されます。
2. ご利用の本番 Confluence インスタンスを、別のコンピュータ上のテスト サーバーに一時的に複製します (手順については、「本番環境をテスト インスタンス に復元する」をご参照ください)。これで、本番サーバーとテスト サーバーに同じデータを用意し、本番 Confluence インスタンスのデータが破損した場合のリスクを軽減することができました。
3. テスト サーバーで、管理者としてログインします。

4. [スペース] > [スペース ツール] > [コンテンツ ツール] > [エクスポート] > [XML] > [次へ] > [完全なエクスポート] > [スペースのエクスポート] に移動し、対象のスペースを、添付ファイルを含む XML としてエクスポートします。

   
   

   
   

5. スペースのバックアップを保存します。

ステージ 2: entities.xml ファイルを編集する (Bash&PowerShell スクリプト経由、または手動)

スクリプト

# variables (all upper case)
zipfile="<path/myfile.zip>"
oldkey_uppercase="<OLD SPACE KEY>"
oldname_uppercase="<OLD SPACE NAME>"
newkey_uppercase="<NEW SPACE KEY>"
newname_uppercase="<NEW SPACE NAME>"

# from here on, no changes are needed
# the variables defined above will be used below

# the lower case variables will be defined here based on the above, and you do not need to change them
oldkey_lowercase=$(echo "${oldkey_uppercase}" | tr [:upper:] [:lower:])
oldname_lowercase=$(echo "${oldname_uppercase}" | tr [:upper:] [:lower:])
newkey_lowercase=$(echo "${newkey_uppercase}" | tr [:upper:] [:lower:])
newname_lowercase=$(echo "${newname_uppercase}" | tr [:upper:] [:lower:])

# unzipping only the entities.xml and the exportDescriptor.properties files
unzip ${zipfile} entities.xml exportDescriptor.properties;

# commands to actually edit the entities.xml and exportDescriptor.properties files
sed -i "s/\[CDATA\[${oldname_uppercase}\]/\[CDATA\[${newname_uppercase}\]/g" entities.xml;
sed -i "s/\[CDATA\[${oldname_lowercase}\]/\[CDATA\[${newname_lowercase}\]/g" entities.xml;
sed -i "s/\[CDATA\[${oldkey_uppercase}\]/\[CDATA\[${newkey_uppercase}\]/g" entities.xml;
sed -i "s/\[CDATA\[${oldkey_lowercase}\]/\[CDATA\[${newkey_lowercase}\]/g" entities.xml;
sed -i "s/\"spaceKey\":\"${oldkey_uppercase}\"/\"spaceKey\":\"${newkey_uppercase}\"/g" entities.xml;
sed -i "s/spaceKey=${oldkey_uppercase}/spaceKey=${newkey_uppercase}/g" entities.xml exportDescriptor.properties;
sed -i "s/spacekey=${oldkey_uppercase}/spacekey=${newkey_uppercase}/g" entities.xml;
sed -i "s/ri:space-key=\"${oldkey_uppercase}\"/ri:space-key=\"${newkey_uppercase}\"/g" entities.xml;
sed -i "s/ri:space-key=${oldkey_uppercase}/ri:space-key=${newkey_uppercase}/g" entities.xml;
sed -i "s/<ac:parameter ac:name=\"spaces\">${oldkey_uppercase}<\/ac:parameter>/<ac:parameter ac:name=\"spaces\">${newkey_uppercase}<\/ac:parameter>/g" entities.xml;
sed -i "s/<ac:parameter ac:name=\"spaceKey\">${oldkey_uppercase}<\/ac:parameter>/<ac:parameter ac:name=\"spaceKey\">${newkey_uppercase}<\/ac:parameter>/g" entities.xml;
sed -i "s/\"parentPageSpaceKey\":\"${oldkey_uppercase}\"/\"parentPageSpaceKey\":\"${newkey_uppercase}\"/g" entities.xml;
sed -i "s/spacekey=${oldkey_lowercase}/spacekey=${newkey_lowercase}/g" entities.xml;

# zipping the updated entities.xml and exportDescriptor.properties files back into the zip file
zip -u ${zipfile} entities.xml exportDescriptor.properties;

$inputOldKeyL = "oldname"
$inputNewKeyL = "newname"
$exportFolder = "path_to_export_folder"

$oldKeyL = $inputOldKeyL.ToLower()
$newKeyL = $inputNewKeyL.ToLower()
$oldKeyU = $oldKeyL.ToUpper()
$newKeyU = $newKeyL.ToUpper()

$fileIn = Join-Path $exportFolder "entities.xml"
$fileOut = Join-Path $exportFolder "entities2.xml"

$fileContent = [System.IO.File]::ReadAllText($fileIn)
$afterReplace = $fileContent.
Replace("<property name=`"lowerDestinationSpaceKey`"><![CDATA[$oldKeyL]]></property>", "<property name=`"lowerDestinationSpaceKey`"><![CDATA[$newKeyL]]></property>").
Replace("<property name=`"lowerKey`">![CDATA[$oldKeyL]]></property>", "<property name=`"lowerKey`">![CDATA[$newKeyL]]></property>").
Replace("[$oldKeyU]", "[$newKeyU]").
Replace("[$oldKeyL]", "[$newKeyL]").
Replace("spaceKey=$oldKeyU", "spaceKey=$newKeyU").
Replace("spaceKey=$oldKeyL", "spaceKey=$newKeyL").
Replace("[$oldKeyU`:", "[$newKeyU`:").
Replace("key=$oldKeyU]", "key=$newKeyU]").
Replace("<spaceKey>$oldKeyU</spaceKey>", "<spaceKey>$newKeyU</spaceKey> ").
Replace("ri:space-key=`"$oldKeyU`"", "ri:space-key=`"$newKeyU`"").
Replace("ri:space-key=$oldKeyU", " ri:space-key=$newKeyU").
Replace("<ac:parameter ac:name=`"spaces`">$oldKeyU</ac:parameter>", "<ac:parameter ac:name=`"spaces`">$newKeyU</ac:parameter>").
Replace("<ac:parameter ac:name=`"spaceKey`">$oldKeyU</ac:parameter>", "<ac:parameter ac:name=`"spaceKey`">$newKeyU</ac:parameter>")
[System.IO.File]::WriteAllText($fileOut, $afterReplace)
Rename-Item -Path $fileIn -NewName "entities_old.xml"
Rename-Item -Path $fileOut -NewName "entities.xml"

手動

1. zip ファイル エディタを使用してスペース バックアップ ファイルを開き、 entities.xml ファイルを見つけます。
2. テキスト エディタで entities.xml を編集します。

3. 次のように、古いスペース名の検索および置換を行います。Old Space Name と New Space Name を実際のキーで置き換えます。

   検索対象	置換先
   [CDATA[Old Space Name]	[CDATA[New Space Name]

4. ユーザー コンテンツで古いスペース名が存在するすべての箇所を検索します。必要に応じて、これらの一部またはすべてを新しいスペース名で置き換えます。Old Space Name と New Space Name を実際の名前で置き換えます。

   検索対象
   Old Space Name

5. 次のように、スペース キーのパターンの検索および置換を行います。

    大文字と小文字が区別されることにご注意ください。プレースホルダーのOLDKEY /NEWKEY は、大文字または大文字と小文字が混在するキーを表し、oldkey/newkey は、すべてが小文字のキーを表します。

   検索対象	置換先
   OLDKEY	NEWKEY
   spaceKey=OLDKEY	spaceKey=NEWKEY
   [OLDKEY:	[NEWKEY:
   key=OLDKEY]	key=NEWKEY]
   <spaceKey>OLDKEY</spaceKey>	<spaceKey>NEWKEY</spaceKey>
   ri:space-key="OLDKEY"	ri:space-key="NEWKEY"  この手順は、名前を変更するスペース内のリンクが元のスペース キーではなく新しいスペース キーを参照する必要がある場合に実行します。それ以外の場合はスキップします。
   ri:space-key=OLDKEY	ri:space-key=NEWKEY  この手順は、名前を変更するスペース内のリンクが元のスペース キーではなく新しいスペース キーを参照する必要がある場合に実行します。それ以外の場合はスキップします。
   <ac:parameter ac:name="spaces">OLDKEY</ac:parameter>	<ac:parameter ac:name="spaces">NEWKEY</ac:parameter>
   <ac:parameter ac:name="spaceKey">OLDKEY</ac:parameter>	<ac:parameter ac:name="spaceKey">NEWKEY</ac:parameter>
   <property name="lowerDestinationSpaceKey"><![CDATA[NEWKEY]]></property>	<property name="lowerDestinationSpaceKey"><![CDATA[newkey]]></property> 検索元と置換先の両方で新しいキーが使用されることにご注意ください。
   <property name="lowerKey"><![CDATA[NEWKEY]]></property>	<property name="lowerKey"><![CDATA[newkey]]></property> 検索元と置換先の両方で新しいキーが使用されることにご注意ください。
   <property name= "lowerKey"><![CDATA[oldkey]]></property>	<property name= "lowerKey"><![CDATA[newkey]]></property>
   spaceKey=OLDKEY	spaceKey=NEWKEY
   spacekey=oldkey	spacekey=newkey

   
   

   
   

6. 変更した entities.xml を保存します。
7. スペース バックアップ内の元の entities.xml を、変更済みのバージョンで置き換えます。

ステージ 3: exportDescriptor.properties ファイルの編集

1. exportDescriptor.properties ファイルを任意のテキスト エディタで編集します。
2. exportDescriptor.properties ファイルの spaceKey の値を 新しいスペース キーに変更します。

ステージ 4: 検証のために下位の (テスト/開発/ステージング) 環境に復元する

1. Confluence 管理者としてテスト インスタンスにログインします。
2. > [一般設定] > [バックアップとリストア] に進みます。[バックアップの zip ファイルを Confluence にアップロード] で、変更済みのスペース バックアップを参照して選択します。[インデックスの作成] オプションを選択して、[アップロードおよびリストア] を選択します。
3. 復元プロセスが完了したら、新しいスペースにアクセスし、ページ、内部リンク、および添付ファイルにアクセスできることを確認します。この段階でエラーが発生する場合、検索および置換が適切に行われていないため、ステップ 2 から再度やり直す必要があります。

ステージ 5: スペースを本番環境にインポート

1. 本番環境インスタンスのバックアップを作成します。
2. Confluence 管理者として本番環境インスタンスにログインします。
3. > [一般設定] > [バックアップとリストア] に進みます。[バックアップの zip ファイルを Confluence にアップロード] で、変更済みのスペース バックアップを参照して選択します。[インデックスの作成] オプションと [アップロードおよびリストア] を選択します。この回避策を利用したことでデータが失われた場合、バックアップに戻す必要があります。
4. 復元プロセスが完了したら、新しいスペースにアクセスし、ページ、内部リンク、および添付ファイルにアクセスできることを確認します。この段階でエラーが発生した場合、サイト バックアップに戻す必要があります。
5. スペースの名前変更を行う場合、[スペース] > [スペース ツール] > [概要] > [スペースの削除] で、古いスペースを削除できます。[OK] をクリックして古いスペースを削除します。

ステージ 6: スペース参照の名前変更

ほかのスペース内にある、古いスペースへのリンクは変更されずに残ります。スペースの名前変更を行う場合、これらのリンクが新しいスペースを参照するように変更する必要があります。スペースをコピーする場合、この段階をスキップして、リンクが元のスペースを参照するようにすることもできます。

これらのリンクの変更は、すべてのリンクを変更するか、一部のみを変更するかに応じて異なります。すべてのリンクを変更する必要がない場合や、本番環境インスタンスを停止したくない場合は、各ページを手動で変更する必要があります。すべてのリンクを変更する必要がある場合、次の手順をご利用ください。

1. > [全般設定] > [バックアップとリストア] で、添付ファイルを含む XML 形式のサイト バックアップを作成します。
2. サイトの XML バックアップ ファイルを保存します。
3. 本番環境インスタンスを停止します。
4. サイト バックアップのコピーを 2 つ作成します。1 つのコピーを、オリジナルの未変更のバックアップとして保持し、もう片方を変更します。変更対象を確認できるよう、バックアップの名前を変更します。
5. 変更用のコピーを開いて entities.xml を編集します。

6. 次のように、古いスペース キーを参照する検索および置換を 4 回行います。oldkey と newkey を実際のキーで置き換えます。

   検索対象	置換先
   [oldkey]	[newkey]
   spaceKey=oldkey	spaceKey=newkey
   [oldkey:	[newkey:
   key=oldkey]	key=newkey]

7. 更新した entities.xml を、変更した XML サイト バックアップ ファイルに保存します。
8. 本番環境を開始します。
9.  >[全般設定] > [バックアップとリストア] で、変更した XML サイト バックアップ ファイルをインポートします。問題が発生した場合、未変更のバックアップに戻り、リンクは手動で変更してください。