Commit b446c619e95032e126eb903c40ed605963e7b66f
Exists in
master
and in
13 other branches
Merge branch 'order-upgrade-guide' into 'master'
Order Upgrade Guide
Showing
1 changed file
with
40 additions
and
30 deletions
Show diff stats
doc/update.md
1 | # Updating GitLab via omnibus-gitlab | 1 | # Updating GitLab via omnibus-gitlab |
2 | 2 | ||
3 | +## Upgrading from a non-Omnibus installation to an Omnibus installation | ||
4 | + | ||
5 | +Please be advised that you lose your settings in files such as gitlab.yml, unicorn.rb and smtp_settings.rb. | ||
6 | +You will have to [configure those settings in /etc/gitlab/gitlab.rb](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md#configuration). | ||
7 | +SMTP is not supported in omnibus-gitlab at this time. | ||
8 | + | ||
9 | +Do this by [creating a backup from the non-Omnibus install](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/raketasks/backup_restore.md#create-a-backup-of-the-gitlab-system) and [restoring this in the Omnibus installation](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md#restoring-an-application-backup). | ||
10 | +Please ensure you are using exactly equal versions of GitLab (for example 6.7.3) when you do this. | ||
11 | +You might have to upgrade your non-Omnibus installation before creating the backup to archive this. | ||
12 | + | ||
3 | ## Updating from GitLab 6.6.x to 6.7.x | 13 | ## Updating from GitLab 6.6.x to 6.7.x |
4 | 14 | ||
5 | First, download the latest [CE](https://www.gitlab.com/downloads/) or | 15 | First, download the latest [CE](https://www.gitlab.com/downloads/) or |
@@ -29,7 +39,36 @@ sudo gitlab-ctl start | @@ -29,7 +39,36 @@ sudo gitlab-ctl start | ||
29 | 39 | ||
30 | Done! | 40 | Done! |
31 | 41 | ||
32 | -### Reverting to GitLab 6.6.x | 42 | +## Updating from GitLab 6.6.0.pre1 to 6.6.4 |
43 | + | ||
44 | +First, download the latest package from https://www.gitlab.com/downloads/ to your GitLab server. | ||
45 | + | ||
46 | +```shell | ||
47 | +# Stop unicorn and sidekiq so we can do database migrations | ||
48 | +sudo gitlab-ctl stop unicorn | ||
49 | +sudo gitlab-ctl stop sidekiq | ||
50 | + | ||
51 | +# One-time migration because we changed some directories since 6.6.0.pre1 | ||
52 | +sudo mkdir -p /var/opt/gitlab/git-data | ||
53 | +sudo mv /var/opt/gitlab/{repositories,gitlab-satellites} /var/opt/gitlab/git-data/ | ||
54 | +sudo mv /var/opt/gitlab/uploads /var/opt/gitlab/gitlab-rails/ | ||
55 | + | ||
56 | +# Install the latest package | ||
57 | +# Ubuntu: | ||
58 | +sudo dpkg -i gitlab_6.6.4-omnibus.xxx.deb | ||
59 | +# CentOS: | ||
60 | +sudo rpm -Uvh gitlab-6.6.4_xxx.rpm | ||
61 | + | ||
62 | +# Reconfigure GitLab (includes database migrations) | ||
63 | +sudo gitlab-ctl reconfigure | ||
64 | + | ||
65 | +# Start unicorn and sidekiq | ||
66 | +sudo gitlab-ctl start | ||
67 | +``` | ||
68 | + | ||
69 | +Done! | ||
70 | + | ||
71 | +## Reverting to GitLab 6.6.x | ||
33 | 72 | ||
34 | First download a GitLab 6.6.x [CE](https://www.gitlab.com/downloads/archives/) or | 73 | First download a GitLab 6.6.x [CE](https://www.gitlab.com/downloads/archives/) or |
35 | [EE (subscribers only)](https://gitlab.com/subscribers/gitlab-ee/blob/master/doc/install/packages.md) | 74 | [EE (subscribers only)](https://gitlab.com/subscribers/gitlab-ee/blob/master/doc/install/packages.md) |
@@ -63,32 +102,3 @@ sudo gitlab-rake gitlab:backup:restore BACKUP=12345 # where 12345 is your backup | @@ -63,32 +102,3 @@ sudo gitlab-rake gitlab:backup:restore BACKUP=12345 # where 12345 is your backup | ||
63 | # Start GitLab | 102 | # Start GitLab |
64 | sudo gitlab-ctl start | 103 | sudo gitlab-ctl start |
65 | ``` | 104 | ``` |
66 | - | ||
67 | -## Updating from GitLab 6.6.0.pre1 to 6.6.4 | ||
68 | - | ||
69 | -First, download the latest package from https://www.gitlab.com/downloads/ to your GitLab server. | ||
70 | - | ||
71 | -```shell | ||
72 | -# Stop unicorn and sidekiq so we can do database migrations | ||
73 | -sudo gitlab-ctl stop unicorn | ||
74 | -sudo gitlab-ctl stop sidekiq | ||
75 | - | ||
76 | -# One-time migration because we changed some directories since 6.6.0.pre1 | ||
77 | -sudo mkdir -p /var/opt/gitlab/git-data | ||
78 | -sudo mv /var/opt/gitlab/{repositories,gitlab-satellites} /var/opt/gitlab/git-data/ | ||
79 | -sudo mv /var/opt/gitlab/uploads /var/opt/gitlab/gitlab-rails/ | ||
80 | - | ||
81 | -# Install the latest package | ||
82 | -# Ubuntu: | ||
83 | -sudo dpkg -i gitlab_6.6.4-omnibus.xxx.deb | ||
84 | -# CentOS: | ||
85 | -sudo rpm -Uvh gitlab-6.6.4_xxx.rpm | ||
86 | - | ||
87 | -# Reconfigure GitLab (includes database migrations) | ||
88 | -sudo gitlab-ctl reconfigure | ||
89 | - | ||
90 | -# Start unicorn and sidekiq | ||
91 | -sudo gitlab-ctl start | ||
92 | -``` | ||
93 | - | ||
94 | -Done! |