MediaWiki Conversion

Running the Converter on a VM

1. The MediaWiki converter is based on MediaWiki 1.11. It's recommended to upgrade the installation to that version before attempting the conversion.

2. Log into the Deki VM.

3.  cd /opt/deki/dist

4. Open mindtouch.deki.mwconverter.xml in a text editor and change it to match your installation:

• Change <startup-xml> element to point to the location of the mindtouch.deki.startup.xml file.  On a VM installation, use /var/www/deki-hayes/config/mindtouch.deki.startup.xml.
• Change <uri.converter> element to point to the IP address or FQDN of the MediaWiki-Bridge.  To leverage MindTouch's public MediaWiki-Bridge, use http://mwc.mindtouch.com.  If your wiki contains private data that should not be sent over the internet, you will need to install a local copy of the MediaWiki-Bridge.
• Change <db-server> to the IP address or FQDN of your MySQL server containing the MediaWiki database.
• Change <db-port> to the port of your MySQL server containing the MediaWiki database
• Change <db-catalog> to MySQL catalog name for the MediaWiki database.  
• Change <db-user> to an account in your MySQL Database that can read the MediaWiki database
• Change <db-password> to the password of a MySQL account that can read the MediaWiki database
• Change <mwrootpage> to the path of a MediaWiki page that should be treated as the Deki home page. 
• Change the <db-userprefix> to your MySQL database user prefix (if any), or blank if none
• Change the <image-dir> to the location of your MediaWiki file attachment directory. 
   

Below is a sample mindtouch.deki.mwconverter.xml configured for a VM:

<?xml version="1.0" encoding="utf-8" ?>
<config>
  <deki>
    <!-- Path to mindtouch.deki.startup.xml -->
    <startup-xml>/var/www/deki-hayes/config/mindtouch.deki.startup.xml</startup-xml>
  </deki>

  <!-- MediaWiki configuration settings -->
  <mediawiki>

    <!-- MediaWiki URL ex.  http://deki-hayes/config/mw/index.php -->
    <uri.converter>http://mwc.mindtouch.com</uri.converter>
    
    <!-- MediaWiki database connection information -->
    <db-server>localhost</db-server>
    <db-port>3306</db-port>
    <db-catalog>mediawikidb</db-catalog>
    <db-user>root</db-user>
    <db-password hidden="true">password</db-password>
    <db-options>pooling=true; Connection Timeout=5; Protocol=socket; Min Pool Size=2; Max Pool Size=50; Connection Reset=false;character set=latin1;ProcedureCacheSize=25;Use Procedure Bodies=true;</db-options>
    <sites> 
      <site>

        <!-- Path of the MediaWiki home page.  All other pages will be placed under this page -->
        <mwrootpage>Main_Page</mwrootpage> 

        <!-- Path to MediaWiki images folder -->
        <imagedir>/mediawiki/files</imagedir>

      </site>
    </sites>
  </mediawiki>
</config>

5. Set execute permissions:  chmod +x mindtouch.deki.mwconverter.exe

6. Launch the converter:  ./mindtouch.deki.mwconverter.exe. 

7. The VM's Deki Wiki database and attachments will be populated with the conversion results.