How to Migrate from MoinMoin

Migration Procedure

First things first, you will need a fresh installation of Sycamore. Follow the installation instructions before continuing with a MoinMoin migration. Don't forget, you'll also need data from a working MoinMoin installation.

During the course of the normal Sycamore install you will end up creating a database with your database software. Before beginning this procedure you need to ensure the database is empty. Using MySQL you can do this with DROP DATABASE nameofwiki; CREATE DATABASE nameofwiki;, and with PostgreSQL you can do this with DROP DATABASE nameofwiki; CREATE DATABASE nameofwiki WITH ENCODING='UTF8';

So far, this procedure has been tested with the following versions of MoinMoin

• MoinMoin 1.3.5

If you want to migrate and you have a version of MoinMoin prior to 1.3.5 you should follow the MoinMoin instructions for moving from your version to a version relatively close to 1.3.5, at least for now.

Absolute first step

Because this migration was designed to migrate from MoinMoin to Sycamore 0.1a, you'll need to have Sycamore 0.1a rather than the latest Sycamore. You can obtain version 0.1a by doing a checkout: svn co http://svn.devjavu.com/sycamore/tags/0.1a. This will be your basic Sycamore install, so set up 0.1a as you would normally before proceeding.

Process

First you need to grab the DBConversion tools from the Sycamore subversion repository. Change directory to your sycamore_base, and issue a svn co http://svn.devjavu.com/sycamore/DBConversion

Edit the sycamore_base/DBConversion/importMoinMoinDB.py and alter the sys.path.extend command to reflect the path to your share directory and to the directory containing the "Sycamore" directory. Example:

sys.path.extend(['/var/www/druidwiki.org/sycamore_base', '/var/www/druidwiki.org/sycamore_base/share/']) 

Next, you need to place your MoinMoin data into the expected places. You will require your data/pages and data/user directories, along with the main edit-log, copy them all to your sycamore_base/share/web/data directory.

Next, you need to prepare the apps directory, create the directory sycamore_base/share/web/apps¹. Then copy events.xml and userstats.xml from sycamore_base/DBConversion to that directory.

Now issue the command python DBConversion/importMoinMoinIntoDB.py.

If you didn't get any errors, your data should be imported.

---

Comments:

Note: You must be logged in to add comments

2006-06-22 23:31:01   is there an alpha,beta or so availible? —DetlevLengsfeld

• [[DateTime(2006-06-23T09:22:04Z)]] Hi, I've just completed writing some rough notes, I'm now going to send the final (current) version on to PhilipNeustrom for — hopeful — inclusion into the DBConversion repository. —NathanReynolds
  

• I've commited importMoinMoinIntoDB.py into the subversion repository. I altered these instructions a bit to simplify them a tad (they still need work!). Namely, sys.path just needs to point to share and the location of the Sycamore directory. There's no need to go to the web directory, as far as I know.. —PhilipNeustrom
  

• see the images! 1.5.3 —Detlev
  

• Did you try running importMoinMoinIntoDB.py? (Did it give an error? What error?) 1.5.3 is certainly later than the version tested with this; it's possible importMoinMoinIntoDB needs to be updated to allow newer versions to import properly. If this were the case then it would be good to test which version of MoinMoin the person is using and then act accordingly. importMoinMoinIntoDB wouldn't need to be modified too extensively, I'd imagine, but someone would have to play with it.