Run the wmt-wrapper.sh script

The wmt tool converts the CEE Moinmoin Wiki data to TeamForge JspWiki data. The wmt-wrapper.sh script is a wrapper script for the wmt.sh script that is used to invoke wmt.java by using wmt.jar. The wmt-wrapper.sh script is used to execute the wmt tool.

1. Edit the wmt-wrapper.sh mandatory input values:
   • Open wmt-wrapper.sh for editing using vi wmt-wrapper.sh.
   • TARGET_URL:https://(target_TeamForge_domain name)/sf/projects

     Example: http://cu068.cloud.maa.collab.net/sf/projects

   • CEE_URL or SOURCE_URL - CEE site URL.

     Example: http://cu050.cubit.maa.collab.net

   • SOURCE_DIR – Path to Moinmoin Wiki data: /shared/ctf/var/
   • URL_USER – TeamForge site administator's username.
   • URL_PASSWORD – TeamForge site administrator's password.
   • DB_URL – Database URL. Example : jdbc:postgresql://localhost:5432/cu068
   • DB_USER – TeamForge database username.
   • DB_PASSWORD – TeamForge database password.
2. Copy the CEE (moin-moin) Wiki data to your TeamForge server.
   • In CEE box, Wiki data are in '$SITE_DIR/data/moinmoin' directory.
   • In CTF production box, we usually copy to '$CTF_VAR_DIR/moinmoin' directory.
   • In CTF dev box, we usually copy to '/tmp/moinmoin' directory.
3. Download and extract the build.
   • Create a directory with name wmt in /tmp.
   • Download the latest (based on latest dated file) wmt from https://mgr.cloud.sp.collab.net/pbl/releng/pub/downloads/unqualified/CTF/6.2/CEE-CTF6-Wiki-Migration-Tool/
   • Untar wmt_yyyy-MM-dd_xxxx.tar.gz by running tar zxvf wmt_yyyy-MM-dd_xxxx.tar.gz.
4. Convert wmt-wrapper.sh to Unix format. i.e.$ dos2unix wmt-wrapper.sh
   Note: Ensure that dos2unix is installed in the box.
5. Ensure if the script has executable permission. i.e. $ chmod +x wmt.sh wmt-wrapper.sh
6. Set JAVA_HOME. Export PATH=$PATH:/usr/java/jdkx.x.x/bin export JAVA_HOME=/usr/java/jdkxx.x.x./bin/java
7. Run the following scripts to do the following:
   • $ <WMT_BUILD_DIR>/wmt-wrapper.sh -a to migrate all projects in the source directory.
   • $ <WMT_BUILD_DIR>/wmt-wrapper.sh -s to migrate a particular project in the source directory.
8. Check /shared/data/wmt-logs/ for the migration status.
   Note: The TeamForge Site Administrator also receives email notifications for each Wiki that is migrated for each project.