Confluence server migration to Datacenter presents an error page at confluence/bootstrap/selectsetupstep.action
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
During the migration process from Confluence server to Datacenter triggers an error page with the following error:
Your confluence instance is already completely setup.
Environment
Confluence Data Center
Diagnosis
Confluence migration is complete, however, upon usage or an eventual restart, the aforementioned error is displayed. Notice that the error mentions a problem in the selectsetupstep part of the installation process that was already completed – Your confluence instance is already completely setup.
Analyzing the confluence.cfg.xml file, look for the parameter setupType, notice that it's displaying the following value – standalone.to.cluster:
<setupType>standalone.to.cluster</setupType>This setup is set during the migration, after completing the migration, it should display as – cluster:
<setupType>cluster</setupType>Cause
The root cause can change but it's possible that it happened because:
- Confluence installation was interrupted but resumed later on
- Hitting the back/forward buttons in the browser during the installation process
- A proxy timeout happened, we reloaded the page and continued the installation
Solution
The solution proposed here works for the migration that has completed. To fix it, we need to change the setupType to the finished type – cluster:
- Shutdown Confluence
- Navigate to <confluence-home-folder>
- Find and edit the confluence.cfg.xml file
- Not to be confused with the confluence.cfg.xml file that exists in the shared-home. The file we're going to edit is from the home folder of a node, each node has its own home folder and a unique shared-home folder exists for the cluster.
Change the following value from standalone.to.cluster to cluster:
<setupType>cluster</setupType>Save the change
Restart Confluence