Add detail to 4.0 to 4.1 documentation
Created by: sbaney
I found that the 4.0 to 4.1 documentation left out a few key items. Most of them were identified and a solution proposed when running the check script ( sudo -u gitlab -H bundle exec rake gitlab:check RAILS_ENV=production
), but it may be helpful to include some of the more common items in the main instructions.
I completed my 4.0 installation about two weeks before 4.1 was released, so I can't imagine that my experience was that different from the majority of users. My server is Ubuntu 12.04.1 LTS 64-bit, which I imagine is a pretty common configuration as well.
The main item I think should be added is how to create the satellite repos. This wasn't explained in the check task, and I had to do some googling to find the solution. For some reason I was under the impression this was related to the Resque to Sidekiq change, but I think that's just because Sidekiq and Satellite both start with 'S'...
This can be achieved with the following command:
bundle exec rake gitlab:satellites:create RAILS_ENV=production
Which I found here:
http://dabutcher.vdosmedia.com/blog/2013/01/21/gitlab-4-dot-0-stable-to-4-dot-1-stable/
I'll list the other items I had to complete during the upgrade, if any of these look like they're not specific to my installation it may be good to add them to the upgrade documentation as well.
- Update Ruby to 1.9.3-p327 - same instructions as installing 4.1 from scratch
- Update Gitolite - same instructions as installing 4.1 from scratch
- Remove
-e
from/home/git/.profile
- Update keys and repos
- Update post-receive hooks
I have full step-by-step instructions for the entire process if any of these items need to be added to the official docs.