Upgrading to Confluence 5.9.x or higher version fails with error 'failed during the SCHEMA_UPGRADE phase due to: null'

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

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

Problem

Upgrading to Confluence to 5.9.x and above fails with the following error message:

 INFO [localhost-startStop-1] [confluence.upgrade.upgradetask.DropSpaceGroupTablesUpgradeTask] doUpgrade Starting dropping unused column SPACES.SPACEGROUPID, table SPACEGROUPPERMISSIONS, and table SPACEGROUPS
 ERROR [localhost-startStop-1] [atlassian.confluence.plugin.PluginFrameworkContextListener] launchUpgrades Upgrade failed, application will not start: Upgrade task com.atlassian.confluence.upgrade.upgradetask.DropSpaceGroupTablesUpgradeTask@535b5afa failed during the SCHEMA_UPGRADE phase due to: null
com.atlassian.confluence.upgrade.UpgradeException: Upgrade task com.atlassian.confluence.upgrade.upgradetask.DropSpaceGroupTablesUpgradeTask@535b5afa failed during the SCHEMA_UPGRADE phase due to: null

This is also documented in this bug report:  CONFSERVER-43759 - Getting issue details... STATUS

Diagnosis

Take the following steps to confirm if you are being affected by this issue:

  1. While on Confluence 5.8.x or older, run this SQL query in MySQL to show the structure for the SPACES table:

    show create table spaces; 
  2. If FK9228242D16994414 is not present in the table constraints, you are affected by this issue.

Cause

There is a missing foreign key constraint in the table SPACES that refers to the SPACEGROUPS table. Confluence 5.9.x no longer includes the table SPACEGROUPS, which should be dropped, but when the upgrade task that performs this is run, it fails due to the missing foreign key constraint.

This upgrade task contains a specific list of activities to perform in sequence:

  1. drop the foreign key SPACEGROUPID from SPACES
  2. drop the index s_spacegroupid_idx from SPACES
  3. drop the column SPACES.SPACEGROUPID
  4. drop the table SPACEGROUPPERMISSIONS
  5. drop the table SPACEGROUPS
The task tries to drop the FK9228242D16994414 constraint, however as it doesn't exist, the returned message is the null pointer error thrown in the Confluence logs above.

Workaround

Run this SQL command to recreate the constraint on the table Spaces:

ALTER TABLE 'SPACES' ADD CONSTRAINT 'FK9228242D16994414' FOREIGN KEY ('SPACEGROUPID') REFERENCES 'SPACEGROUPS' ('SPACEGROUPID');



  1. Verify the SPACES table includes the new constraint

    show create table spaces; 

    For Oracle database you need to run this:

    1. add constraint to SPACES table:

      ALTER TABLE
        SPACES
      ADD
        CONSTRAINT FK9228242D16994414 FOREIGN KEY (SPACEGROUPID) REFERENCES SPACEGROUPS (SPACEGROUPID);
    2. check if the constraint was applied:
    select * from user_cons_columns where table_name='SPACES' and constraint_name='FK9228242D16994414';



Always back up your data before performing any modifications to the database. If possible, test any alter, insert, update, or delete SQL commands on a staging server first.

Last modified on Dec 3, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.