Commit e2bb34571b01071b50b314c036e6b32303ce5be8
1 parent
a3d4f93a
Exists in
master
and in
13 other branches
Add update instructions for 6.7
Showing
2 changed files
with
62 additions
and
0 deletions
Show diff stats
README.md
| @@ -29,6 +29,8 @@ sudo gitlab-ctl reconfigure | @@ -29,6 +29,8 @@ sudo gitlab-ctl reconfigure | ||
| 29 | sudo lokkit -s http -s ssh | 29 | sudo lokkit -s http -s ssh |
| 30 | ``` | 30 | ``` |
| 31 | 31 | ||
| 32 | +## Updating | ||
| 33 | + | ||
| 32 | For update instructions, see [the update guide](doc/update.md). | 34 | For update instructions, see [the update guide](doc/update.md). |
| 33 | 35 | ||
| 34 | ## How to manage an Omnibus-installed GitLab | 36 | ## How to manage an Omnibus-installed GitLab |
doc/update.md
| 1 | # Updating GitLab via omnibus-gitlab | 1 | # Updating GitLab via omnibus-gitlab |
| 2 | 2 | ||
| 3 | +## Updating from GitLab 6.6.x to 6.7.x | ||
| 4 | + | ||
| 5 | +First, download the latest package from https://www.gitlab.com/downloads/ to your GitLab server. | ||
| 6 | + | ||
| 7 | +```shell | ||
| 8 | +# Stop unicorn and sidekiq so we can do database migrations | ||
| 9 | +sudo gitlab-ctl stop unicorn | ||
| 10 | +sudo gitlab-ctl stop sidekiq | ||
| 11 | + | ||
| 12 | +# Create a database backup in case the upgrade fails | ||
| 13 | +# Note the backup timestamp in case you want to revert later | ||
| 14 | +sudo gitlab-rake gitlab:backup:create | ||
| 15 | + | ||
| 16 | +# Install the latest package | ||
| 17 | +# Ubuntu: | ||
| 18 | +sudo dpkg -i gitlab_6.7.y-omnibus.xxx.deb | ||
| 19 | +# CentOS: | ||
| 20 | +sudo rpm -Uvh gitlab-6.7.y_xxx.rpm | ||
| 21 | + | ||
| 22 | +# Reconfigure GitLab (includes database migrations) | ||
| 23 | +sudo gitlab-ctl reconfigure | ||
| 24 | + | ||
| 25 | +# Start unicorn and sidekiq | ||
| 26 | +sudo gitlab-ctl start | ||
| 27 | +``` | ||
| 28 | + | ||
| 29 | +Done! | ||
| 30 | + | ||
| 31 | +### Reverting to GitLab 6.6.x | ||
| 32 | + | ||
| 33 | +First download a GitLab 6.6.x package from https://www.gitlab.com/downloads/archives/ . | ||
| 34 | + | ||
| 35 | +``` | ||
| 36 | +# Stop GitLab | ||
| 37 | +sudo gitlab-ctl stop unicorn | ||
| 38 | +sudo gitlab-ctl stop sidekiq | ||
| 39 | + | ||
| 40 | +# Downgrade GitLab to 6.6 | ||
| 41 | +# Ubuntu | ||
| 42 | +sudo dpkg -r gitlab | ||
| 43 | +sudo dpkg -i gitlab-6.6.x-yyy.deb | ||
| 44 | + | ||
| 45 | +# CentOS: | ||
| 46 | +sudo rpm -e gitlab | ||
| 47 | +sudo rpm -ivh gitlab-6.6.x-yyy.rpm | ||
| 48 | + | ||
| 49 | +# Prepare GitLab for receiving the backup restore | ||
| 50 | + | ||
| 51 | +# Workaround for a backup restore bug in GitLab 6.6 | ||
| 52 | +sudo -u gitlab-psql /opt/gitlab/embedded/bin/dropdb gitlabhq_production | ||
| 53 | + | ||
| 54 | +sudo gitlab-ctl reconfigure | ||
| 55 | + | ||
| 56 | +# Restore your backup | ||
| 57 | +sudo gitlab-rake gitlab:backup:restore BACKUP=12345 # where 12345 is your backup timestamp | ||
| 58 | + | ||
| 59 | +# Start GitLab | ||
| 60 | +sudo gitlab-ctl start | ||
| 61 | +``` | ||
| 62 | + | ||
| 3 | ## Updating from GitLab 6.6.0.pre1 to 6.6.4 | 63 | ## Updating from GitLab 6.6.0.pre1 to 6.6.4 |
| 4 | 64 | ||
| 5 | First, download the latest package from https://www.gitlab.com/downloads/ to your GitLab server. | 65 | First, download the latest package from https://www.gitlab.com/downloads/ to your GitLab server. |