2013-07-29 17:11:55 +00:00
# From 5.4 to 6.0
### Deprecations
#### Global projects
2013-07-29 19:19:03 +00:00
We deprecated root(global) namespace for projects.
2013-07-29 17:11:55 +00:00
So you need to move all your global projects under group/users manually before update or it will be moved automatically to owner namespace during update.
#### Teams
2013-08-01 19:23:57 +00:00
We deprecate teams as separate entity in 6.0 in favor of group membership.
The old combination of groups and teams was confusing for a lot of people.
And when the members of a team where changed this wasn't reflected in the project permissions.
In GitLab 6.0 you will be able to add members to a group with a permission level for each member.
These group members will have access to the projects in that group.
Any changes to group members will immediately be reflected in the project permissions.
You can even have multiple owners for a group, greatly simplifying administration.
2013-07-29 17:11:55 +00:00
### 0. Backup
It's useful to make a backup just in case things go south:
(With MySQL, this may require granting "LOCK TABLES" privileges to the GitLab user on the database version)
```bash
cd /home/git/gitlab
sudo -u git -H RAILS_ENV=production bundle exec rake gitlab:backup:create
```
### 1. Stop server
sudo service gitlab stop
### 2. Get latest code
```bash
cd /home/git/gitlab
sudo -u git -H git fetch
sudo -u git -H git checkout 6-0-dev
```
2013-07-30 17:06:45 +00:00
### 3. Install additional packages
```bash
# For reStructuredText markup language support install required package:
sudo apt-get install python-docutils
```
### 4. Install libs, migrations, etc.
2013-07-29 17:11:55 +00:00
```bash
cd /home/git/gitlab
# MySQL
sudo -u git -H bundle install --without development test postgres --deployment
#PostgreSQL
sudo -u git -H bundle install --without development test mysql --deployment
sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
sudo -u git -H bundle exec rake migrate_groups RAILS_ENV=production
sudo -u git -H bundle exec rake migrate_global_projects RAILS_ENV=production
sudo -u git -H bundle exec rake migrate_keys RAILS_ENV=production
```
2013-07-30 17:06:45 +00:00
### 5. Update config files
2013-07-29 17:11:55 +00:00
* Make `/home/git/gitlab/config/gitlab.yml` same as https://github.com/gitlabhq/gitlabhq/blob/5-3-stable/config/gitlab.yml.example but with your settings.
* Make `/home/git/gitlab/config/puma.rb` same as https://github.com/gitlabhq/gitlabhq/blob/5-3-stable/config/puma.rb.example but with your settings.
2013-07-30 17:06:45 +00:00
### 6. Update Init script
2013-07-29 17:11:55 +00:00
```bash
sudo rm /etc/init.d/gitlab
sudo curl --output /etc/init.d/gitlab https://raw.github.com/gitlabhq/gitlabhq/5-3-stable/lib/support/init.d/gitlab
sudo chmod +x /etc/init.d/gitlab
```
2013-07-30 17:06:45 +00:00
### 7. Start application
2013-07-29 17:11:55 +00:00
sudo service gitlab start
sudo service nginx restart
2013-07-30 17:06:45 +00:00
### 8. Check application status
2013-07-29 17:11:55 +00:00
Check if GitLab and its environment are configured correctly:
sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
To make sure you didn't miss anything run a more thorough check with:
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
2013-08-01 19:23:57 +00:00
If all items are green, then congratulations upgrade complete!