Best practice for migrating Confluence 3.4.8 to 5.X

[Dirk Brutscher]

Hi,

I'm currently evaluating the process of migrating our productive instance of Confluence 3.4.8 to a current 5.X version.

Is there a kind of "best practice" for migrating our content to the new version of Confluence?

Whats about attachments and ContentProperties written to pages by used plugins?

[Dirk Brutscher · Accepted solution]

I figured out something like this...

1. Provide a clone of the production environment for migration issues (with the current data).
   
   
2. Check licence to be able to upgrade.
   
   
3. Upgrade 3.4.8 -> 4.3.7.
   
   
4. Identify unmigrated / masked content by enabling logging for "com.atlassian.confluence.content.render.xhtml.migration".
   
   
5. Restart ./admin/unmigratedwikicontent.action (only available in Confluence 4.x) to see which macros have migration issues.
   (c.f. https://confluence.atlassian.com/x/N4s4Dw)
   
   
6. Fix all problems by removing macros or upgrading. Error example: com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'sql' is unknown.
   
   
7. Redo 5. until no errors will be logged.
   
8. Upgrade to 5.x ...

[Dirk Brutscher]

I think this should contain the informations: https://confluence.atlassian.com/display/CONF53/Upgrading+Confluence+Manually which was linked here https://confluence.atlassian.com/display/CONF53/Upgrading+Confluence

[RambanamP]

have you gone through this doc?

https://confluence.atlassian.com/display/DOC/Upgrading+Confluence

check this also will help you

https://answers.atlassian.com/questions/206061/best-upgrade-path-from-confluence-3-4-8-to-the-latest

[Dirk Brutscher]

Things found in the meantime...

https://confluence.atlassian.com/x/lAaBG

https://confluence.atlassian.com/x/ZgeBG