doc/update/6.0-to-6.2.md

   1 # From 6.0 to 6.2
   2
   3 ## Notice
   4 Security vulnerabilities CVE-2013-4490 and CVE-2013-4489 have been patched in the latest version of GitLab 6.2.
   5
   6 # In 6.1 we remove a lot of deprecated code.
   7 # You should update to 6.0 before installing 6.1 or higher so all the necessary conversions are run.
   8
   9 ### Deprecations
  10
  11 #### Global issue numbers
  12
  13 As of 6.1 issue numbers are project specific. This means all issues are renumbered and get a new number in their url. If you use an old issue number url and the issue number does not exist yet you are redirected to the new one. This conversion does not trigger if the old number already exists for this project, this is unlikely but will happen with old issues and large projects.
  14
  15 ### 0. Backup
  16
  17 It's useful to make a backup just in case things go south:
  18 (With MySQL, this may require granting "LOCK TABLES" privileges to the GitLab user on the database version)
  19
  20 ```bash
  21 cd /home/git/gitlab
  22 sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
  23 ```
  24
  25 ### 1. Stop server
  26
  27     sudo service gitlab stop
  28
  29 ### 2. Get latest code
  30
  31 ```bash
  32 cd /home/git/gitlab
  33 sudo -u git -H git fetch
  34 sudo -u git -H git checkout 6-2-stable # Latest version of 6-2-stable addresses CVE-2013-4489
  35 ```
  36
  37
  38 ### 3. Install additional packages
  39
  40 ```bash
  41 # Add support for lograte for better log file handling
  42 sudo apt-get install logrotate
  43 ```
  44
  45 ### 4. Update gitlab-shell
  46
  47 ```bash
  48 cd /home/git/gitlab-shell
  49 sudo -u git -H git fetch
  50 sudo -u git -H git checkout v1.7.9 # Addresses multiple critical security vulnerabilities
  51 ```
  52
  53 ### 5. Install libs, migrations, etc.
  54
  55 ```bash
  56 cd /home/git/gitlab
  57
  58 # MySQL
  59 sudo -u git -H bundle install --without development test postgres --deployment
  60
  61 #PostgreSQL
  62 sudo -u git -H bundle install --without development test mysql --deployment
  63
  64
  65 sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
  66 sudo -u git -H bundle exec rake migrate_iids RAILS_ENV=production
  67 sudo -u git -H bundle exec rake assets:clean RAILS_ENV=production
  68 sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production
  69 sudo -u git -H bundle exec rake cache:clear RAILS_ENV=production
  70 ```
  71
  72 ### 6. Update config files
  73
  74 TIP: to see what changed in gitlab.yml.example in this release use next command:
  75
  76 ```
  77 git diff 6-0-stable:config/gitlab.yml.example 6-2-stable:config/gitlab.yml.example
  78 ```
  79
  80 * Make `/home/git/gitlab/config/gitlab.yml` same as https://github.com/gitlabhq/gitlabhq/blob/6-2-stable/config/gitlab.yml.example but with your settings.
  81 * Make `/home/git/gitlab/config/unicorn.rb` same as https://github.com/gitlabhq/gitlabhq/blob/6-2-stable/config/unicorn.rb.example but with your settings.
  82 * Copy rack attack middleware config
  83
  84 ```bash
  85 sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb
  86 ```
  87 * Uncomment `config.middleware.use Rack::Attack` in `/home/git/gitlab/config/application.rb`
  88 * Set up logrotate
  89
  90 ```bash
  91 sudo cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab
  92 ```
  93
  94 ### 7. Update Init script
  95
  96 ```bash
  97 sudo rm /etc/init.d/gitlab
  98 sudo curl --output /etc/init.d/gitlab https://raw.github.com/gitlabhq/gitlabhq/6-2-stable/lib/support/init.d/gitlab
  99 sudo chmod +x /etc/init.d/gitlab
 100 ```
 101
 102 ### 8. Start application
 103
 104     sudo service gitlab start
 105     sudo service nginx restart
 106
 107 ### 9. Check application status
 108
 109 Check if GitLab and its environment are configured correctly:
 110
 111     cd /home/git/gitlab
 112     sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
 113
 114 To make sure you didn't miss anything run a more thorough check with:
 115
 116     sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
 117
 118 If all items are green, then congratulations upgrade complete!
 119
 120 ## Things went south? Revert to previous version (6.0)
 121
 122 ### 1. Revert the code to the previous version
 123 Follow the [`upgrade guide from 5.4 to 6.0`](5.4-to-6.0.md), except for the database migration
 124 (The backup is already migrated to the previous version)
 125
 126 ### 2. Restore from the backup:
 127
 128 ```bash
 129 cd /home/git/gitlab
 130 sudo -u git -H bundle exec rake gitlab:backup:restore RAILS_ENV=production
 131 ```