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:

  1. take a backup of the CE instance
  2. transfer the backup to the new server
  3. 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.
  1. manipulate the version string in the backup_information.yml
  • Bug: The CE Backup file has the version string 7.14.1, the ee install expects 7.14.1-ee
  1. restore the backup
  2. run sudo gitlab-ctl reconfigure and sudo gitlab-rake db:migrate
  3. fix satellites with sudo gitlab-rake gitlab:satellites:create
  4. Update to 7.14.3 to fix the hooks
  1. 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.

/cc @JobV @sytses