Import Planio Backup into Redmine » History » Sprint/Milestone 1
Jens Krämer, 04/22/2021 08:34 AM
1 | 1 | Jens Krämer | # Import Planio Backup into Redmine |
---|---|---|---|
2 | |||
3 | ## Set up Redmine |
||
4 | |||
5 | - Download the latest stable version of Redmine: http://www.redmine.org/projects/redmine/wiki/Download |
||
6 | - Set up Redmine according to http://www.redmine.org/projects/redmine/wiki/RedmineInstall and point it to a fresh, empty MySQL database |
||
7 | - Make sure this plain and empty Redmine installation works. |
||
8 | |||
9 | ## Use the working Redmine installation with your Planio data |
||
10 | |||
11 | - The Backup you can download from your Planio account contains a MySQL database dump, import that into another MySQL DB. |
||
12 | - Change the database connection settings of your Redmine to point to this database. |
||
13 | - The Planio backup also contains all the attachment data, move that to the *files* directory inside your Redmine installation. Uploads are segmented by year and month, the resulting folder structure should look like that: `redmine_directory/files/yyyy/mm/`. |
||
14 | - Upgrade the database scheme to account for the new Redmine version http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade#Step-4-Update-the-database |
||
15 | |||
16 | ## Set up open source plugins (optional) |
||
17 | |||
18 | - Planio comes with [Agile](https://www.redmine.org/plugins/redmine_agile) and [Checklist](https://www.redmine.org/plugins/redmine_checklists) plugins pre-installed. We provide the Pro versions, but the Free versions will work as well (minus the pro-only features). Simply install these into the `plugins` directory of your Redmine setup if you want to continue using them. |
||
19 | - Install required ruby libraries for the plugins (repeat the `bundle install` command from the initial setup) |
||
20 | - Upgrade the database scheme to account for updates in the plugins compared to the versions Planio runs (again, see http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade#Step-4-Update-the-database) |
||
21 | |||
22 | At this point you should have a working Redmine with your Planio data and optional Agile and Checklists plugins. |
||
23 | |||
24 | ## Things you will lose when moving away from Planio |
||
25 | |||
26 | The following modules are developed in-house by us and are only available to Planio customers: |
||
27 | |||
28 | - Help Desk |
||
29 | - Storage |
||
30 | - Chat |
||
31 | |||
32 | All corresponding data is included in the DB dump and files directory but lacking the plugins it will simply be ignored by your Redmine installation. |
||
33 | |||
34 | ## Troubleshooting |
||
35 | |||
36 | ### Delete custom field definitions for Planio data types |
||
37 | |||
38 | ~~~sql |
||
39 | DELETE |
||
40 | custom_fields, custom_field_enumerations, custom_fields_projects, custom_fields_roles, custom_fields_trackers, custom_values |
||
41 | FROM |
||
42 | custom_fields |
||
43 | LEFT JOIN custom_field_enumerations ON custom_field_enumerations.custom_field_id = custom_fields.id |
||
44 | LEFT JOIN custom_fields_projects ON custom_fields_projects.custom_field_id = custom_fields.id |
||
45 | LEFT JOIN custom_fields_roles ON custom_fields_roles.custom_field_id = custom_fields.id |
||
46 | LEFT JOIN custom_fields_trackers ON custom_fields_trackers.custom_field_id = custom_fields.id |
||
47 | LEFT JOIN custom_values ON custom_values.custom_field_id = custom_fields.id |
||
48 | WHERE |
||
49 | custom_fields.type IN ('CompanyCustomField', 'ContactCustomField', 'StorageFolderCustomField', 'StorageFileCustomField'); |
||
50 | ~~~ |