This page last changed on Nov 17, 2005 by jnolen.

This document will assist you in migrating data from other wikis such as JSPWiki to a Confluence installation. If you need something clarified in this document, please feel free to send us an email at confluence-support@atlassian.com

Migrating Data from JSPWiki

To import data from a JSPWiki site you should first run a standalone application called jspwiki-exporter to export the JSPWiki site to a Confluence zip file. Then you can import the exported zip file on any Confluence installation from Administration > Backup & Restore > Restore. You can choose to build the exporter yourself or simply download it.

If you would like to build the exporter from source, you will find instructions to do so here.

Download JSPWiki exporter

  1. Download the pre-built exporter here (jspwiki-exporter-1.4.4.zip or jspwiki-exporter-1.4.4.tar.gz)
  2. Extract the exporter into a new directory (we'll call this the working directory for this guide)
    Note to existing Confluence 1.3.x users

    If you would like to create an export for Confluence 1.3.x, the latest exporters for this version are jspwiki-exporter-1.3.6b.zip or jspwiki-exporter-1.3.6b.tar.gz. You can use these same set of instructions for these exporters (just remember to use the correct version number).

Download the confluence-1.4.4.jar

  1. Download this jar from here and copy over to the working directory.
    Note to existing Confluence 1.3.x users

    If you would like to create an export for Confluence 1.3.x, you will need to copy the confluence-1.3.6.jar instead. Available here

    Copy confluence jars into working directory

  2. This step assumes that you have already downloaded either the standalone or WAR version of Confluence. If you haven't done so already, you can do so from here.
  3. Extract the zip and copy all the jars from your confluence WEB-INF/lib directory into the working directory.

Running the jspwiki-exporter

  1. Now open up a command/console window and switch to the working directory. To Run the exporter enter:
java -jar jspwiki-exporter-1.4.4.jar <1st parameter> <2nd parameter> <3rd parameter>

where:

Parameter Explanation Example
1st parameter Points to the location of the jspwiki.properties file d:\java\tomcat\webapps\JSPWiki\WEB-INF\jspwiki.properties
2nd parameter name of the space (make sure this doesn't already exist and that it is a valid Confluence space name. If in doubt, try testing it by creating a space with that name first.) fromjspwiki
3rd parameter name of a user (make sure this user exists) john

IMPORTANT: If camel case linking was enabled and used in your JSPWiki instance, please ensure that you have camel case linking switched on in Confluence before you import. This setting can be found in the Adminstration > General Configuration section.

The export zip is called jspwikiexport_ddMMMyyyy_time.zip and can be found in working directory/exports/ folder. Now that you have created a confluence export file from you jspwiki data, you can begin to import this data into Confluence. To do so, go to the Confluence Backup and Restore page, and simply browse for this zip file and click restore.


jspwiki-exporter-0.4-source.zip (application/zip)
jspwiki-exporter-0.4-source.tar.gz (application/x-gzip)
jspwiki-exporter-0.4.zip (application/zip)
jspwiki-exporter-0.4.tar.gz (application/x-gzip)
jspwiki-exporter-0.5.tar.gz (application/x-gzip)
jspwiki-exporter-0.5.zip (application/x-zip-compressed)
jspwiki-exporter-0.5-source.zip (application/x-zip-compressed)
jspwiki-exporter-0.5-source.tar.gz (application/x-gzip)
jspwiki-exporter-0.5.2.zip (application/zip)
jspwiki-exporter-0.5.2.tar.gz (application/x-gzip)
jspwiki-exporter-0.6.tar.gz (application/x-gzip)
jspwiki-exporter-0.6.zip (application/x-zip-compressed)
jspwiki-exporter-0.7.zip (application/zip)
jspwiki-exporter-0.7.tar.gz (application/x-gzip)
jspwiki-exporter-0.8.zip (application/zip)
jspwiki-exporter-0.8.tar.gz (application/x-gzip)
jspwiki-exporter-1.3.zip (application/zip)
jspwiki-exporter-1.3.tar.gz (application/x-gzip)
jspwiki-exporter-1.3.1.tar.gz (application/x-gzip)
jspwiki-exporter-1.3.1.zip (application/x-zip-compressed)
jspwiki-exporter-1.3.1a.tar.gz (application/x-gzip)
jspwiki-exporter-1.3.1a.zip (application/x-zip-compressed)
jspwiki-exporter-1.4.1.tar.gz (application/gzip)
jspwiki-exporter-1.4.1.zip (application/zip)
jspwiki-exporter-1.3.6.tar.gz (application/x-gzip)
jspwiki-exporter-1.3.6.zip (application/x-zip-compressed)
jspwiki-exporter-1.3.6a.tar.gz (application/x-gzip)
jspwiki-exporter-1.3.6a.zip (application/x-zip-compressed)
jspwiki-exporter-1.4.1b.tar.gz (application/x-gzip)
jspwiki-exporter-1.4.1b.zip (application/x-zip-compressed)
jspwiki-exporter-1.3.6b.tar.gz (application/x-gzip)
jspwiki-exporter-1.3.6b.zip (application/zip)
jspwiki-exporter-1.4.4.tar.gz (application/x-gzip)
jspwiki-exporter-1.4.4.zip (application/zip)
Document generated by Confluence on Oct 10, 2007 18:47