Skip to content

Migrating from Documents to DMSF

Karel Pičman edited this page Jun 6, 2023 · 3 revisions

IMPORTANT: Please create a backup before you begin

The plugin provides a rake task to migrate from the default Redmine Documents module to DMSF.
Usage: rake redmine:dmsf_convert_documents RAILS_ENV="production"

This is the default invocation. It goes through all projects and all those having Documents module active and DMSF inactive are converted.

Conversion of each project

  • Activates DMSF for project
  • Creates folder for each document in Document module
  • Creates file for each document attachment in corresponding folder
  • All descriptions are transfered to DMSF
  • Redmine’s Documents module is deactivated

These options can be used in the rake task

  • project => id or identifier of project (defaults to all projects)
  • dry => true or false (default false) to perform just check without any conversion
  • invalid=replace => to perform document title invalid characters replacement for ‘-’

Test the conversion on a project called “test”

rake redmine:dmsf_convert_documents project=test dry=1 RAILS_ENV="production"

Again: Backup your current content before you try to migrate documents!