Updating an Omnibus installation

In this recipe, we will take a look at how you can update your GitLab installation when you install it via the Omnibus package. In this recipe, I'll make the assumption that you're using Ubuntu 12.04. You can use other Linux distributions; the steps for these can be found at about.gitlab.com.

How to do it…

Let's update the Omnibus installation with the following steps:

1. Log in to your server via SSH.

2. Stop the unicorn server:

   $ sudo gitlab-ctl stop unicorn
   

3. Stop the background job server:

   $ sudo gitlab-ctl stop sidekiq
   

4. Create a backup in case the upgrade fails:

   $ sudo gitlab-rake gitlab:backup:create
   

5. Download the package from the GitLab website (https://about.gitlab.com/downloads/):

   $ wget https://downloads-packages.s3.amazonaws.com/ubuntu-12.04/gitlab_7.1.1-omnibus.1-1_amd64.deb
   

6. Install the new package (change the x.x.x part to the correct version number from your download):

   sudo dpkg -i gitlab_x.x.x-omnibus.xxx.deb
   

7. Reconfigure GitLab:

   sudo gitlab-ctl reconfigure...