SQLServerException: Invalid object name after upgrade to Jira 8.16.1

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs 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

After upgrading to Jira 8.16.1, the logs are reporting the error:

1 Caused by: com.microsoft.sqlserver.jdbc.SQLServerException: Invalid object name 'null.AO_6FF49D_MIGRATION_ENTITY

Environment

  • Jira 8.16.1

  • MS SQL Server

Diagnosis

  • No schema is defined in the <jira-home>/dbconfig.xmlfile.

  • The full stack trace is found in the <jira-home>/log/atlassian-jira.log:

1 2 3 4 5 6 [c.a.j.m.tracking.utils.ThreadUtils] uncaught exception in periodic executor com.atlassian.cache.CacheException: com.querydsl.core.QueryException: Caught SQLServerException for select "MIGRATION"."MIGRATION_ID", "MIGRATION"."PLAN_ID", "MIGRATION"."START_MIGRATION_CONTEXT_JSON", "MIGRATION"."IN_PROGRESS_STATUS_JSON", "MIGRATION"."OUTCOME_JSON", "MIGRATION"."STARTED_BY", "MIGRATION"."CREATED_TIMESTAMP", "MIGRATION"."UPDATED_TIMESTAMP" from "null"."AO_6FF49D_MIGRATION_ENTITY" "MIGRATION" where "MIGRATION"."OUTCOME_JSON" is null and "MIGRATION"."UPDATED_TIMESTAMP" > ? ... Caused by: com.querydsl.core.QueryException: Caught SQLServerException for select "MIGRATION"."MIGRATION_ID", "MIGRATION"."PLAN_ID", "MIGRATION"."START_MIGRATION_CONTEXT_JSON", "MIGRATION"."IN_PROGRESS_STATUS_JSON", "MIGRATION"."OUTCOME_JSON", "MIGRATION"."STARTED_BY", "MIGRATION"."CREATED_TIMESTAMP", "MIGRATION"."UPDATED_TIMESTAMP" from "null"."AO_6FF49D_MIGRATION_ENTITY" "MIGRATION" where "MIGRATION"."OUTCOME_JSON" is null and "MIGRATION"."UPDATED_TIMESTAMP" > ? ... Caused by: com.microsoft.sqlserver.jdbc.SQLServerException: Invalid object name 'null.AO_6FF49D_MIGRATION_ENTITY'.

Cause

This table AO_6FF49D_MIGRATION_ENTITY is used by the Jira Cloud Migration Assistant for migrating between Server and Cloud instances. Jira 8.16.1 in particular may have some issues with the schema missing specifically for this AO table.

Atlassian recommends to create a new schema for the Jira tables, otherwise the instance may face further issues.

If the schema is missing altogether, it is absolutely critical that it is specified otherwise it will cause significant problems with the JIRA instance.

Solution

Follow the steps in the KB article Change the schema name for Jira database tables.

Updated on February 28, 2025

Still need help?

The Atlassian Community is here for you.