Improve Documentation for upgrade from CE to EE
I'm currently trying to update from CE to EE and found the docs a bit lacking as well as a bug.
I didn't find any docs that tell me how to update my specific setup. (CE source, mysql => EE omnibus, mysql).
All update docs I could find are for older source releases.
My Setup:
Old Server:
Gitlab CE 7.14.1 source install with mysql db
New Server:
Gitlab EE 7.14.1 omnibus install with external mysql db
Install Steps I took:
I had to do the following steps to upgrade:
- take a backup of the CE instance
- transfer the backup to the new server
- make sure the mysql db is empty
-
This is important because otherwise the migrations will not run!
My first attempt failed because I tested the EE install before and the db wasn't empty.
- manipulate the version string in the
backup_information.yml
-
Bug: The CE Backup file has the version string
7.14.1
, the ee install expects7.14.1-ee
- restore the backup
- run
sudo gitlab-ctl reconfigure
andsudo gitlab-rake db:migrate
- fix satellites with
sudo gitlab-rake gitlab:satellites:create
Update to 7.14.3 to fix the hooks
- See: gitlab-ce#2446
- Step 8 didn't fix the problems. run
find /var/opt/gitlab/git-data/repositories -name \*.git -type d -exec sh -c 'ln -s /opt/gitlab/embedded/service/gitlab-shell/hooks $0' {} \;
- Pitfall here: In my installation I moved the data dir to another location so I had to change the location.
I'm currently finishing step 8 and will test the install afterwards again and update my post accordingly.
I managed to upgrade sucessfully with the above steps. But we need to fix the bugs in the upgrade process.
I think we need some new docs so the average gitlab user doesn't run into the same problems.
Edited by Marcin Sedlak-Jakubowski