Page tree
Skip to end of metadata
Go to start of metadata

Goal

Full migration of Magnolia modules together with partial migration of your own modules.

Before you start magnolia add magnolia.migration.persistReport=true to your magnolia.properties. This will ensure that all reports are persisted and readable. 

Now you should be ready to start Magnolia. On startup Magnolia will run all migration tasks triggered by Magnolia modules and of your own modules. These tasks will migrate the Magnolia modules completely and your modules partially.

The Migration module will also provide a report that tells you what was done and what is left to do. You should examine these proposed changes and use the script to finalize the transformation of your configuration. To finalize the transformation of your template scripts we provide a Groovy script that will update Freemarker scripts and adds more information to the report.

Please read run the migration tool before you begin to gain a better understanding of the required steps.

Start Magnolia and read the report

  1. Start Magnolia. It should start without errors (warnings may occur).
  2. Then look at the configuration. You will see that a lot of things have changed.
  3. Download the migration report in Tools > Migration Tool >Migration Report.

Configure and run the migration tool

  1. Go to Tools > Migration Tool
  2. In Select module, choose modules/update-training.
  3. In Side definitions, select /modules/extended-templating-kit/config/sites/update-training.
  4. Click Run migration to start the migration process.
  5. Check the results in your log files as well as in the migration report.

As an alternative you can use the migration script which is located in AdminCentral under Tools > Scripts > /scripts/migration/from4_4To4_5/templates/MigrateTemplateExecuteScriptsOpen the file and configure the maps as follows:

def generateScripts = true;

// Change the parameters in order to point to your configuration
//  define your module name , path to your templates
def modulesMap = ["update-training": "<systempath>/update-training/update-training-01/update-training-44-module/src/main/resources/"]
//  define your site definition path , path to your templates
def siteDefinitions = [
   "/modules/extended-templating-kit/config/sites/update-training": "<systempath>/update-training/update-training-01/update-training-44-module/src/main/resources/"
   ]

Example:

def generateScripts = true;

// Change the parameters in order to point to your configuration
//  define your module name , path to your templates
def modulesMap = ["update-training": "/Users/jsmith/DEV/GitRepo/update-training/update-training-01/update-training-44-module/src/main/resources/"]
//  define your site definition path , path to your templates
def siteDefinitions = [
      "/modules/extended-templating-kit/config/sites/update-training": "/Users/jsmith/DEV/GitRepo/update-training/update-training-01/update-training-44-module/src/main/resources/"
    ]

(warning) Make sure the script is enabled before running it!

Run the script.