Documentation for Confluence 2.5.4 - 2.5.8.
Documentation for [Confluence Cloud] and the latest Confluence Server is available too.

Currently Confluence does not support renaming or copying spaces through the user interface. You may wish to vote towards these feature requests:

Manually Clone Or Rename A Space

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

注意

  • May require manually updating external links to that space
  • The instructions have been confirmed for Confluence 2.2 onwards. Users running older versions are recommended to upgrade Confluence before continuing
  • Where examples are given, they involve changing oldkey:Old Space Name into newkey:New Space Name
  • When importing a space export for a space that already exists, the previous space content will be overwritten
  • Read the process in full before beginning

第 1 段階: スペースの名前変更

  1. Select a new, unique space key and name for the second space. Space keys may only consist of ASCII letters or numbers (A-Z, a-z, 0-9) and no empty spaces are allowed in the key

  2. Clone your production Confluence instance to a test server on another computer now. You should now have a production server and test server both containing the same data and can avoid the risk of corrupting your production Confluence instance

  3. On the test server, login as an administrator

  4. Go to Browse Space -> Advanced -> Export Space and export the target space as XML including attachments.

  5. Save the space backup

  6. Open the space backup file with a zip file editor and find the file entities.xml

  7. Edit entities.xml in a text editor

  8. Do a 'Search & Replace' on the old space name as shown below. Swap out Old Space Name and New Space Name for the actual names

    検索対象

    置換先

    [CDATA[Old Space Name]

    [CDATA[New Space Name]


  9. Do a 'Search' for any occurrences of the old space name that occur in user content. You may wish to replace some or all of these references with the new space name. Replace Old Space Name and New Space Name with the actual names

    検索対象

    Old Space Name


  10. Do four 'Search & Replaces' on each of the references to the old space key as shown below. Swap out oldkey and newkey for the actual keys

    検索対象

    置換先

    [oldkey]

    [newkey]

    spaceKey=oldkey

    spaceKey=newkey

    [oldkey:

    [newkey:

    key=oldkey]

    key=newkey]


    For instance:

    Space name : Test Space
    Space key : test
<property name="name"><![CDATA[Test Space]]></property>
<property name="key"><![CDATA[test]]></property>

Change the test oldkey to a newkey representing the new unique space key for the space name Test Space.

  1. Save the modified entities.xml

  2. Overwrite the original entities.xml in the space backup with the modified version

  3. Login to the test instance as a Confluence administrator

  4. Go to Administration -> Backup & Restore. Under 'Upload a zipped backup to Confluence', browse to select to the modified space backup. Check the 'Build index' option and select 'Upload & Restore'

  5. Once the restore process has completed, access the new space and test that you can access pages, embedded links and attachments. Any error in this step indicates that your search and replace was performed incorrectly and you should to retry from step 2

第 2 段階: 本番環境への復元

  1. Backup your production instance now

  2. Login to the production instance as a Confluence administrator

  3. Go to Administration -> Backup & Restore. Under 'Upload a zipped backup to Confluence', browse to select to the modified space backup. Check the 'Build index' option and select 'Upload & Restore' If any data loss occurs as a result of using this workaround, immediately revert to the backup

  4. Once the restore process has completed, access the new space and test that you can access pages, embedded links and attachments. If any error occurs during this step, revert to the site backup

  5. If renaming a space, you can delete the old space by going to Browse Space -> Space Admin -> Remove Space. Click OK to remove the old space

第 3 段階: スペース参照の名前変更

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

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

  1. Create a site XML backup including attachments from Administration -> Backup & Restore

  2. Save the site XML backup file

  3. Stop the production instance

  4. サイト バックアップのコピーを 2 つ作成します。1 つのコピーを、オリジナルの未変更のバックアップとして保持し、もう片方を変更します。変更対象を確認できるよう、バックアップの名前を変更します。

  5. Open the copy for modification and edit entities.xml

  6. Do four 'Search & Replaces' on each of the references to the old space key as shown below. Swap out oldkey and newkey for the actual keys

    検索対象

    置換先

    [oldkey]

    [newkey]

    spaceKey=oldkey

    spaceKey=newkey

    [oldkey:

    [newkey:

    key=oldkey]

    key=newkey]


  1. Save the updated entities.xml back into the modified site XML backup file

  2. 本番環境を開始します。

  3. Import the modified site XML backup from Administration -> Backup & Restore. If you have any problems, revert to the original unmodified backup and redo the links manually instead

これで完了です。

Copy Space Template

There is a feature request being tracked at CONF-4538.

Copy Space Plugin to be released





Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.