Hi everyone,

I’d like to migrate my manual install to a packaged installation in order to not have to go through the pain of manually updating my openproject installation everytime.

are there any migration paths available?

Best Regards
Qiong

Hi Qiong,

the main idea for the migration is:

• Backup all your data for manual installation or for packager installation.
• Do a clean install via packager as described here (OpenProject core only) or here (Community Edition). If you do not know which Edition you should install I suggest you try the Community Edition (more features via plugins already included in the Edition).
• During the packager installation you will be asked if packager should create a database for you or if you want to connect to an existing one. So you can use your old data with all your existing data or packager will set up a new one and you have to import your backup later on (which way to go is up to you but I suggest you run db:migrate after your migration to be sure all database migrations were executed. To do so just use openproject run rake db:migrate command).

Please note that packager already includes everything you need. So you do not have to install ruby or other libraries by yourself. If you want to run ruby or a rails console you have to use the openproject run command (or openproject-ce run if you installed the community edition). Also important is that packager stores information given during the installation process in /etc/openpoject/install.dat (or etc/openproject-ce/install.dat if you installed the community edition).

Hopefully these information are enough to get you started. If you get stuck please let me know and we will figure out the problem together.

Cheers,
Karsten

Hi Karsten,

the link for the backup instructions is unfortunately a 404 now, can you update that one?

Thanks!

Hi Qiong,

thanks for pointing this out.
We split the backup guide up into a separate documentation for the packager and manual installation:

• Backup - manual installation
• Backup - packager installation

Best regards,
Robin

thanks!