Upgrade XML space export of 3.x Confluence space to 4.x instance - how?

We have some content that resides in a 3.x instance of Confluence. We would like to take space exports from 3.x and import the content into our 4.x instance.

How do we up-migrate content from an older (wiki markup) instance to the current storage format at the space level?

2 answers

Quoting the documentation:
"Confluence prevents the import of space backups which aren't from the same major version. The reason for this is that any schema change between the export and imported version of Confluence will cause the import to fail, leaving you with an incomplete import. Even worse, the failure can be database-dependent, so it may work fine on one particular database but your backup will fail to import later."

So, prior to export the data, both instances must be on the same version. You must upgrade the 3.x Confluence to the version 3.5.17 first, then upgrade it to the same version 4.x that the other instance has. More infor can be found here: https://confluence.atlassian.com/display/CONF40/Upgrading+Confluence

Thanks for that information, but in this case, we want to keep the two instances on different versions for some time. However, we occasionally have the need to get one space from the 3.x instance to 4.x.

Is there any other path? Maybe using CLI? Or editing the entity XML file?

1 vote
Daniel Wester Community Champion May 09, 2013

You'll probably want to spin up a second 3.x instance as(using the "Developer" license key) and import the space export into it. Then upgrade that instance to the 4.x version and then export from there into the 4.x instance.

The storage method changed dramatically between Confluence 3 and 4 so I don't think that you can edit the entity XML file. I believe that you might be able to import wiki markup by using the https://bobswift.atlassian.net/wiki/display/CCLI/CLI+Plugin+for+Confluence - but I suspect that you'll have a lot of extra overhead with that approach.

Thanks for that idea. It would work if this was a one-time deal, but we do have the need to do this every so often - 4-7 times a year, maybe. I'm not sure how practical it is for us to maintain a separate instance for the purpose of upgrading the occasional space.

I have been working with the CLI plugin, particularly the convertToStorageFormat parameter, but am having trouble getting from the page level to the space level. Was hoping to write up some CLI commands, potentially, to do this for us.


Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

480 views 2 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you