Versions
- 9.5
- 9.4
- 9.3
- 9.2
- 9.1
- 9.0
- 8.19
- 8.18
- 8.17
- 8.16
- 8.15
- 8.14
- 8.13
- 8.12
- 8.11
- 8.10
- 8.9
- 8.8
- 8.7
- 8.6
- 8.5
- 8.4
- 8.3
- 8.2
- 8.1
- 8.0
- 7.21
- 7.20
- 7.18
- 7.19
- 7.17
- 7.16
- 7.15
- 7.14
- 7.13
- 7.12
- 7.11
- 7.10
- 7.9
- 7.8
- 7.7
- 7.6
- 7.5
- 7.4
- 7.3
- 7.2
- 7.1
- 7.0
- 6.10
- 6.9
- 6.8
- 6.7
- 6.6
- 6.5
- 6.4
- 6.3
- 6.2
- 6.1
- 6.0
- 5.16
- 5.15
- 5.14
- 5.13
- 5.12
- 5.11
- 5.10
- 5.9
- 5.8
- 5.7
- 5.6
- 5.5
- 5.4
- 5.3
- 5.2
- 5.1
- 5.0
- See all
Upgrade tasks
Diagnostics for third-party apps
On this page
Related content
- Exporting
- Data Center Migration
- Unable to import exported Bitbucket Server projects and repositories due to SSL issue
- Unable to import exported Bitbucket Server projects and repositories due to SSL issue
- Bitbucket Server REST API for merging Pull Request fails
- Bitbucket Data Center Migration feature fails unexpectedly
- How to migrate to Docker and upgrade Bitbucket Server
- How to optimize migration (export and import) of large number of projects from one Bitbucket Server and Data Center instance to another
- Importing code from an existing project
- How to upgrade Mirror H2 database inside Bitbucket Kubernetes pod
UPGRADETASK-2001 Invalid content in pull request commit backfill upgrade marker file WARNING
Problem
With the introduction of pull request links on commit pages in 5.11, Bitbucket Server must run an upgrade task to index existing pull request commit relationships. The upgrade task processes a single repository at a time, and persists progress by writing an upgrade marker file with the ID of the latest repository processed. Once all repositories have been processed, the upgrade task writes -1 to the file.
The UPGRADETASK-2001 issue indicates that the contents of this marker file are not valid. This means progress of the upgrade task cannot be confirmed, and as a result, some pull request commit relationships may not have been indexed. The contents of the file are invalid if the file is empty or the file contents cannot be converted to an integer. A missing upgrade marker file will not trigger this issue.
Alert Details
When UPGRADETASK-2001 is raised, the following data is collected to help diagnose the problem:
content: the content of the marker file, truncated to 10 characters.
Cause
The upgrade marker file at <PATH_TO_SHARED_HOME>/config/upgrade/core-backfill-pull-request-commits is corrupted. The contents of the file are considered invalid if the file is empty or the file contents cannot be converted to an integer.
Mitigation
If this issue is encountered, the marker file can be deleted in order to run the upgrade task again next time Bitbucket Server is started.
Alternatively, the contents of the file can be set to -1 in order to mark the upgrade task as completed.
However, this may result in some or all pull request links missing from commits. If the issue occurs repeatedly after manual intervention, contact support at https://support.atlassian.com.
Related content
- Exporting
- Data Center Migration
- Unable to import exported Bitbucket Server projects and repositories due to SSL issue
- Unable to import exported Bitbucket Server projects and repositories due to SSL issue
- Bitbucket Server REST API for merging Pull Request fails
- Bitbucket Data Center Migration feature fails unexpectedly
- How to migrate to Docker and upgrade Bitbucket Server
- How to optimize migration (export and import) of large number of projects from one Bitbucket Server and Data Center instance to another
- Importing code from an existing project
- How to upgrade Mirror H2 database inside Bitbucket Kubernetes pod