From b48bba052bd01f60c83298d94dfaee40cfca486e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Oliver=20G=C3=BCnther?= Date: Tue, 4 Feb 2020 13:49:36 +0100 Subject: [PATCH] Add documentation for migrating old mysql versions --- .../README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 help/installation-and-operations/misc/upgrading-older-openproject-versions/README.md diff --git a/help/installation-and-operations/misc/upgrading-older-openproject-versions/README.md b/help/installation-and-operations/misc/upgrading-older-openproject-versions/README.md new file mode 100644 index 0000000000..3e17cd5395 --- /dev/null +++ b/help/installation-and-operations/misc/upgrading-older-openproject-versions/README.md @@ -0,0 +1,16 @@ +### Migrating from an old MySQL database + +The script described above reuqires at least OpenProject 8 to work properly. If you are still on an older OpenProject version you have to migrate to OpenProject 8 first. + +To make this easier there is a script which automates that too. It's included in the docker image itself but will want to run it directly on the docker host. To do that you can either copy it onto your system from `/app/script/migration/migrate-from-pre-8.sh` or simply download it [here](https://github.com/opf/openproject/tree/release/10.3/script/migration/migrate-from-pre-8.sh). + +All the script needs is a docker installation. It will start containers as required for the migration and clean them up afterwards. The result of the migration will be a SQL dump of OpenProject in the current version (10.3). This can then be imported into the actual OpenProject setup. + +## Usage + +With docker installed, use the following command to start the upgrade process on your MySQL dump. + +```bash +bash migrate-from-pre-8.sh " +``` +