Commit e3c47e19 authored by Georges Racinet's avatar Georges Racinet 🦑
Browse files

INSTALL_HEPTAPOD: migration instructions for this big version jump

--HG--
branch : heptapod
parent 085badc17441
# Heptapod installation guide
## Important: migrating from Heptapod 0.8
Because Heptapod 0.12 is a jump from GitLab CE 10.5 to 12.2, it is not
possible to upgrade directly, because major GitLab version bump must be done
[one at a time](https://docs.gitlab.com/ce/policy/maintenance.html#upgrade-recommendations).
Instead, the recommended way is to go through a series of Heptapod intermediate
versions that are meant to support the migration only:
- Heptapod 0.9 (GitLab CE 10.8)
- Heptapod 0.10 (GitLab CE 11.0)
- Heptapod 0.11 (Gitlab CE 11.8)
At each step, start the Rails application and wait for the background
migrations to be finished. See GitLab [documentation](https://docs.gitlab.com/ce/update/#checking-for-background-migrations-before-upgrading) for how to check
that.
For source installs, one only needs to update the Rails application for these
intermediate versions, and it's best not even to start the services that handle
connections from clients (Workhorse, SSH).
For Docker installs, we will provide a series of images tailored for the
migration needs.
**WARNING do not use Heptapod 0.9 to 0.11 for anything but data migration.**
## Installing from source
Heptapod installation is similar to GitLab's except that
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment