Take It Step By Step

After you upgrade Confluence, pages that contain Scaffolding Forms & Templates for Confluence Server and Data Center macros may render incorrectly.

If you are upgrading Confluence to v4.3 and above, there might be some problems with the wiki markup migration if you upgrade directly from Confluence v3.x to the latest version. It is recommended instead to upgrade Confluence version by version so that your data can be maintained.

Refer to the Confluence safety upgrade steps below to ensure all wiki markup data are migrated completely:

Step 1:

Upgrade Confluence v3.x to Confluence v3.5.x with Scaffolding Forms & Templates for Confluence Server and Data Center 3.4.2.

Step 2:

Upgrade Confluence v3.5.x to Confluence 4.2.x with Scaffolding Forms & Templates for Confluence Server and Data Center 4.6.5.

Step 3:

Upgrade Confluence v4.2.x to Confluence 4.3.x with Scaffolding Forms & Templates for Confluence Server and Data Center 4.6.5.

Step 4:

Upgrade Confluence v4.3.x to Confluence v5.8.x / v5.10.x with Scaffolding Forms & Templates for Confluence Server and Data Center latest version.

Step 5:

On Scaffolding Forms & Templates for Confluence Server and Data Center , uninstall all older dependencies which are not required by modern version of Scaffolding Forms & Templates for Confluence Server and Data Center. You can refer to this on the ServiceRocket Add-on Dependencies page.

Step 6:

On Scaffolding Forms & Templates for Confluence Server and Data Center , uninstall all older dependencies which are not required by modern version of Scaffolding Forms & Templates for Confluence Server and Data Center. You can refer to this on the ServiceRocket Add-on Dependencies page.

Step 7:

Upgrade Confluence v5.x to Confluence v6.x with the latest compatible version of Scaffolding Forms & Templates for Confluence Server and Data Center

A Note on Confluence 5.x

Confluence 5.0.x should not be required.

If you are at Confluence 4.3, you may upgrade to the latest version of Confluence 5.x.

Upgrade Instructions for Each Add-on

  1. Before upgrading Confluence, go to Administration > Plugins > Manage Existing.
  2. Disable the Scaffolding Forms & Templates for Confluence Server and Data Center add-on.
  3. Upgrade Confluence.
  4. Update Scaffolding Forms & Templates for Confluence Server and Data Center through Administration > Plugins > Upgrade.
  5. Enable the Scaffolding Forms & Templates for Confluence Server and Data Center add-on.

Unmigrated Wiki Markup

You may see that after the Scaffolding Forms & Templates for Confluence Server and Data Center add-on is enabled, the wiki markup does not convert or render correctly. If this happens, it is advisable to do the following:

  1. Rebuild the Confluence Index through Administration > Content Indexing > Rebuild both.
  2. Refer to the Wiki Markup to XHTML Migration article. Under the Re-attempt Migration section, run the unmigratedwikicontent.action command.

Related Knowledge Base