Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
5be1ac79
Commit
5be1ac79
authored
Jul 21, 2021
by
Katrin Leinweber
Committed by
Kati Paizee
Jul 21, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Docs: Highlight importance of batched background migrations
parent
3b85ee3a
Changes
3
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
14 additions
and
17 deletions
+14
-17
doc/update/img/batched_background_migrations_queued_v14_0.png
...update/img/batched_background_migrations_queued_v14_0.png
+0
-0
doc/update/index.md
doc/update/index.md
+12
-10
doc/user/admin_area/monitoring/background_migrations.md
doc/user/admin_area/monitoring/background_migrations.md
+2
-7
No files found.
doc/u
ser/admin_area/monitoring
/img/batched_background_migrations_queued_v14_0.png
→
doc/u
pdate
/img/batched_background_migrations_queued_v14_0.png
View file @
5be1ac79
File moved
doc/update/index.md
View file @
5be1ac79
...
...
@@ -72,13 +72,21 @@ from the chart version to GitLab version to determine the [upgrade path](#upgrad
## Checking for background migrations before upgrading
Certain major/minor releases may require a set of background migrations to be
finished. The number of remaining migrations jobs can be found by running the
following command:
Certain major/minor releases may require different migrations to be
finished before you update to the newer version.
**For GitLab 14.0 and newer**
To check the status of
[
batched background migrations
](
../user/admin_area/monitoring/background_migrations.md
)
:
1.
On the top bar, select
**Menu >**
**{admin}**
**Admin**
.
1.
On the left sidebar, select
**Monitoring > Background Migrations**
.
!
[
queued batched background migrations table
](
img/batched_background_migrations_queued_v14_0.png
)
**For Omnibus installations**
If using GitLab 12.9 and newer, run:
If using GitLab 12.9 and newer,
also
run:
```
shell
sudo
gitlab-rails runner
-e
production
'puts Gitlab::BackgroundMigration.remaining'
...
...
@@ -107,12 +115,6 @@ Sidekiq::Queue.new("background_migration").size
Sidekiq
::
ScheduledSet
.
new
.
select
{
|
r
|
r
.
klass
==
'BackgroundMigrationWorker'
}.
size
```
### Batched background migrations
Batched background migrations need to finish before you update to a newer version.
Read more about
[
batched background migrations
](
../user/admin_area/monitoring/background_migrations.md
)
.
### What do I do if my background migrations are stuck?
WARNING:
...
...
doc/user/admin_area/monitoring/background_migrations.md
View file @
5be1ac79
...
...
@@ -23,13 +23,8 @@ prevent integer overflow for some tables.
## Check the status of background migrations **(FREE SELF)**
All migrations must have a
`Finished`
status before updating GitLab. To check the status of the existing
migrations:
1.
On the top bar, select
**Menu >**
**{admin}**
**Admin**
.
1.
On the left sidebar, select
**Monitoring > Background Migrations**
.
!
[
queued batched background migrations table
](
img/batched_background_migrations_queued_v14_0.png
)
All migrations must have a
`Finished`
status before you
[
upgrade GitLab
](
../../../update/index.md
)
.
You can
[
check the status of existing migrations
](
../../../update/index.md#checking-for-background-migrations-before-upgrading
)
.
## Enable or disable batched background migrations **(FREE SELF)**
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment