Class DbTrueFalseTypeFixUpgradeTask

  • All Implemented Interfaces:
    BackupSupport, DatabaseUpgradeTask, UpgradeTask, UpgradeTaskInfo, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware

    public class DbTrueFalseTypeFixUpgradeTask
    extends AbstractUpgradeTask
    implements DatabaseUpgradeTask
    This upgrade task is necessary for any customer who upgraded to Confluence 8.3.0 and then performed a site restore. There was an issue which was causing Health Checks because of newly imported entries which use TrueFalseType. This type should be stored in the database as a single upper case character. Instead, it was stored as a lowercase character. (see issue for details). The task will replace all lower case values of true_false type into upper case.
    Since:
    8.3.2
    • Constructor Detail

      • DbTrueFalseTypeFixUpgradeTask

        public DbTrueFalseTypeFixUpgradeTask​(DdlExecutor ddlExecutor,
                                             org.hibernate.SessionFactory sessionFactory)
    • Method Detail

      • runOnSpaceImport

        public boolean runOnSpaceImport()
        Description copied from interface: BackupSupport
        Returns true if an older Space can't be imported in a new instance without running this task. For example:
        • A task updating macro names in the BodyContent table would be blocking.
        • Tasks which updates data related to the space would be blocking.
        • A task upgrading the user table wouldn't be blocking.
        • Adding a mandatory column on space-related content breaks space import

        Note that tasks don't run on space import yet, so we just reject the import in this case.

        Specified by:
        runOnSpaceImport in interface BackupSupport
      • breaksBackwardCompatibility

        public boolean breaksBackwardCompatibility()
        Description copied from interface: BackupSupport
        Returns true if a new export can't be imported in an older instance.

        Breaking compatibility means a snapshot of the new version will not work at all with the previous version. For example:

        • A destructive operation (Some data is replaced by another) breaks backwards compatibility
        • Adding a optional column does NOT break backwards compatibility
        • Data is copied to another column doesn't breaks backwards compatibility
        • A build number incrementation doesn't breaks backwards compatibility
        The best way to test is whether a newer export can be imported (with fully working features) in an older instance.
        Specified by:
        breaksBackwardCompatibility in interface BackupSupport