You are here: Home Plone products collective.migrator

collective.migrator (1.6)

by Olha Pelishok last modified 2011-03-01
Released on 2011-02-26 by Suresh V for Plone 2.1, Plone 2.5, Plone 3.0, Plone 4.0 under GPL - GNU General Public License available for All platforms.
Software development stage: stable
Tool and buildout recipes for zope/plone content migration

collective.migrator is a buildout based tool to help migrate content between Plone/Zope instances. It can be installed as follows:

$easy_install  collective.migrator

Once installed you can run the tool to set up the migration environment


This creates a folder called migrator and installs a buildout environment there. All further actions are run from this folder.

The first thing that you want to do at this point is customize the instance.cfg file.

By default it looks like this:

host =
user = ssh_user
port = 8080
extensions = /usr/Plone-2.5.5/zeocluster/client1/Extensions
zmi_user = admin
zmi_pwd = admin
root = Plone
export = /usr/Plone-2.5.5/zeocluster/client1/var

host = localhost
port = 8080
extensions = /home/suresh/plone4/parts/instance/Extensions
zmi_user = admin
zmi_pwd = admin
root = Plone
import = /home/suresh/plone4/var/instance/import

This defines the settings for all the Plone instances involved in the migration.

The buildout.cfg defines the steps that will be executed as part of the migration.

Here is the default content:

extends = instance.cfg
parts =
tbd =

As you can see, parts has been intentionally left blank. Also instance.cfg described previously is being used here. The other migrate_.cfg* files contain some sample steps to move various objects between the instances.

As a simple test, you can change parts in buildout.cfg to look like this:

parts = export_frontpage

This step is defined in migrate_frontpage.cfg.

Now after you run buildout as follows:


you should notice that the front-page object has been exported in the remote Plone instance. Once you gain more confidence in the tool, you can even try to run the other steps found in the migrate_.cfg* files.

PS: This may not be the "coolest" way to manipulate your Plone and some of these actions may be better done with GenericSetup profiles, but this worked for me!

Document Actions
Powered by Plone