Upgrade of Confluence from 3.5 to 5.0 with Numbered Headings plugin

[Natalia Usmanova]

We have a Confluence 3.5 that uses Numbered Headings v 2.0.3 plugin. After we upgrade Confluence to 5.0 and then update the plugins using Universal Plugin Manager, a lot of pages that use Numbered Headings macro get messed up: TOC macro shows an exception, some pages get truncated, etc.

When such pages are open for edit, they show an unrecognized numbered_headings macro. The manual fix is to create a new Numbered Headings macro, and move content from the old numbered_headings macro to this new one.

Is there any way to have Confluence and Numbered Headings plugin upgraded without having to manually fix all the pages that use it? We have hundreds of these pages...

[Natalia Usmanova · Accepted solution]

The problem turned out to be caused by our own user macro {numbered_headings} and not by the {numberedheadings} macro that comes from the plugin. The solution was to programmatically modify affected pages and replace numbered_headings with numberedheadings using Confluence CLI.

[Tomas Theunissen]

You can update the content on the following page (don't forget to replace the first part of the link): <your_instance>/admin/unmigratedwikicontent.action

[Tomas Theunissen]

This is caused by the fact that the last version of Numbered Headings does not contain the macro for pre 4.0 versions. This pre 4.0 version is needed to migrate the macro to the 4.0 version. To solve this bug you should upgrade to version 2.3.1, run all macro upgrades and then upgrade to the latest version of Numbered Headings.

Let me know if it worked!

[Natalia Usmanova]

How do I run macro upgrades? Thank you!

[Tomas Theunissen]

You can update the content on the following page (don't forget to replace the first part of the link): <your_instance>/admin/unmigratedwikicontent.action

[Natalia Usmanova]

I ran this task with 2.3.1 installed on Confluence 5.0, and it looked as it completed without errors, however the pages with numbered_headings old-style macro didn't get changed. Next I will try redoing the whole Confluence upgrade from 3.5 to 5.0 with plugin's version 2.3.1 installed on Confluence 3.5 prior to upgrade. Will post the results here.

[Natalia Usmanova]

Tried starting from the beginning: got a new clone of production (Confluence 3.5, Numbered Headings 2.0.3), updated Numbered Headings to 2.3.1, then upgraded Confluence to 4.3.7, ran content update as suggested. It didn't return any errors, but didn't seem to update the old numbered_headings macro. Then upgraded Confluence to 5.0.3, leaving Numbered Headings at 2.3.1. Got exactly the same result as before, all the pages continue to have "numbered_headings" macro, and have TOC macro that sits right before numbered_headings macro showing an exception: Error rendering macro 'toc' : [com.ctc.wstx.exc.WstxLazyException] com.ctc.wstx.exc.WstxParsingException: Duplicate attribute 'id'. at [row,col {unknown-source}]: [65,134].

[Tomas Theunissen]

Are both Numbered Headings and the TOC macro broken, or only the TOC macro?

[Natalia Usmanova]

All pages that had {toc} followed by {numbered_headings} now show exception instead of the TOC.

In addition to that, some (not all) pages that use {numbered_headings} macro don't render content inside the macro correctly with different kinds of problems: one page is trancated only showing 1st section, but in Edit mode the whole content is shown. Another has a {warning} macro inside {numbered_headings}, and this Warning box is shown with the text partially written outside of the box.

In all cases the fix is to Edit the page, add a new Numbered Headings macro, and move the content of old {numbered_headings} macro in it, deleting the old {numbered_headings} macro at the end.

[Natalia Usmanova]

My apologies. Further investigation showed that the offiending macro {numbered_headings} belongs to a User Macro added to our instance of Confluence long time ago, before this plugin was even installed. The problem I was describing therefore has nothing to do with the Numbered Headings plugin. Thank you!

[Tomas Theunissen]

No problem, if you need any help with Numbered Headings or any of our other plugins, let us know!