Migration Import Filters

Version 5.2.7.2 of the Content Engine includes a set of import filters designed to convert syndication files exported by the version 4 Migrator plug-in. The system is pre-configured to automatically create import folders for all defined publications on start-up. In other words, to create an import folder for a publication, you can:

  1. Create an empty publication using the escenic-admin web application (see Create a New Publication for detailed instructions on how to do this).

  2. Restart the Content Engine.

If you don't want to restart the Content Engine, then you can achieve the same results as follows:

  1. Select the escenic-admin application's Component Browser option (see Component Browser).

  2. Use the Component Browser to navigate to the /com/escenic/syndication/xml/service/MigrationSetupService component.

  3. Click on doStopService to stop the service.

  4. Click on doStartService to restart it.

By default the import folders are created in /var/spool/escenic/migration. The folder tree for a publication called mypub will look like this:

var
 spool
  escenic
   migration
    mypub
     archive
     error

With this set-up, you would copy the files to be imported into /var/spool/escenic/migration/mypub. Files that were successfully imported would be copied to /var/spool/escenic/migration/mypub/archive and files that failed to import successfully would be copied to /var/spool/escenic/migration/mypub/error.

If you want to move the import folders to a different location, then you can do so by changing the MigrationSetupService's migrationDirectory property. To do this you need to edit configuration-root/com/escenic/syndication/xml/service/MigrationSetupService.properties in one of your configuration layers. For information about version 5 configuration layers and how to edit them, see Configuring The Content Engine. Remember that if you change this setting then you will need to restart the Content Engine or the MigrationSetupService in order for the change to take effect.

The MigrationSetupService creates a Reporter for each publication import task. This is a component that monitors the import and reports on its progress. You can, if you wish configure these reporters to send mails when particular events occur. For further information, see Configuring an Import Reporter.

Copyright © 2009-2011 Escenic