cogApplication to migrate XWiki documents from XWiki 1.0 syntax to XWiki 2.0 syntax
Developed by

Valdis Vitolins, Antons Cornijs,  Vladislavs Sukelaits,  Marija Isupova,  Eduards Sidorovics,  Kirils Belajevs

0 Votes
LicenseGNU Lesser General Public License 2.1

XWiki 5.4 or higher


Set up

(Note that all links here refer to the localhost:8080 and will not work if there is no XWiki application working on your computer))

  1. Import WikiMigration.xar file
  2. Go to http://localhost:8080/xwiki/bin/view/WikiMigration/WebHome
  3. Click on link migration code and adjust Groovy script for your needs.

Start migration

  1. Then go back to WikiMigration page.
  2. If there are any pages with XWiki 1.0 content then you will see number of old pages.
  3. You can migrate them by pressing Start migration button.

Check migration

  1. After migration you will see message which will inform you about successful migration and you will be able to check migrated pages by pressing Check pages button.
  2. If there are no pages with old XWiki 1.0 syntax then you will be able to check results of previous migration by pressing Check pages button.
  3. Open page CheckMigration
    1. All migrated pages will be displayed in frame. You can mark migrated page as good or bad.
    2. If there are some issues with page you can add comments.
  4. All pages will be located in special pages: AllPages, GoodPages and BadPages

Enjoy migrated content

Or, look at list of BadPages and fix these pages manually.


(Click on pictures to see in full size)

  1. Initial page:


  2. Groovy sript for pre- and post- fixes of built in wiki migration (using different search patterns):


  3. Actual migration page:


  4. Migration finish page:


  5. Migration checking page:



Get Connected