Installing from source

Download Bits

Download the MindTouch build from one of the following sources:

• RECOMMENDED: http://sourceforge.net/projects/dekiwiki (tarballs)

Extract the archive to your home directory:

# cd ~/
# tar xfzv deki-09.02.1.tar.gz
# cd deki-09.02.1

Copy web files to your apache directory

# mkdir /var/www/dekiwiki
# cp -r web/*  /var/www/dekiwiki
# chown -R www-data /var/www/dekiwiki 

Configure Apache

Edit the ./config/deki-apache.conf file by changing the following values according to your setup (Note: make sure to change the VirtualHost line to *:80)

<VirtualHost *:80> 
ServerName mindtouch 
DocumentRoot "/var/www/dekiwiki"

Copy the apache config file (for example, in Debian do:)

# cp config/deki-apache.conf /etc/apache2/sites-available/dekiwiki
# a2ensite dekiwiki
# a2dissite default

Enable the mod_rewrite module

# a2enmod rewrite 

Configure Apache for deki-api

The deki-api is a .NET application which runs under the mono runtime.  deki-api runs as a standalone mono application which uses MindTouch Dream's built-in webserver.  mod_proxy proxy is used to proxy requests from apache to deki-api.

Enable mod_proxy_http module

# a2enmod proxy
# a2enmod proxy_http

Edit the mod_proxy config file (/etc/apache2/mods-available/proxy.conf on Debian) and make sure you have the following:

<Proxy *>
    AddDefaultCharset off
    Order deny,allow
    Deny from all
    Allow from all
</Proxy>

Edit your deki apache config file /etc/apache2/sites-available/dekiwiki and make sure the following lines are uncommented

# mod_proxy rules
ProxyPass /@api http://localhost:8081 retry=1
ProxyPassReverse /@api http://localhost:8081
SetEnv force-proxy-request-1.0 1
SetEnv proxy-nokeepalive 1 

Restart apache to enable the module and apply the new settings

# /etc/init.d/apache2 restart 

Configure deki-api

Create the deki-api logfile

# mkdir /var/log/dekiwiki
# touch /var/log/dekiwiki/deki-api.log
# chown www-data /var/log/dekiwiki/deki-api.log

Create the mono .wapi directory (Note: the mono .wapi directory needs to exist in the home directory for your apache user.  In debian the www-data user's home dir is: /var/www/  but this location may be different for different linux distros.)

# mkdir /var/www/.wapi
# chown www-data /var/www/.wapi

Copy the Deki Wiki init script

# cp config/dekiwiki-init.debian /etc/init.d/dekiwiki

Install the init script into the default runlevels

# update-rc.d dekiwiki defaults

Install Trusted Roots Certificates

Install the trusted roots certificates from the Mozilla LXR website into the Mono certificate store by entering the following:

# su www-data
$ mozroots --import --sync
$ exit

Note that Ubuntu may require the installation of mono-1.0-devel to obtain the mozroots executable. If you are running Ubuntu, please install mono-1.0-devel in order to be able to install the Mozilla trusted roots certificates.

Install using the web-installer

Launch a browser and go to the installer:

http://mindtouch/config/index.php

Fill in the required information and click "Install MindTouch"

Complete the installation by running the additional commands as instructed by the installer.

Troubleshooting

If deki-api failed to load try the following:

* if you get "no default auth service" make sure your proxy settings are correct and that your firewall isn't blocking port 8081.

* make sure the mono process is running

ps ax|grep mindtouch.host

You should see a process like:

www-data  3401  0.5 15.9  67292 40892 pts/0    Sl   19:25   0:03 mono \ 
/var/www/dekiwiki/bin/mindtouch.host.exe apikey 92669 script \ 
/etc/dekiwiki/mindtouch.deki.startup.xml \
 path-prefix @api http-port 8081 ip localhost notty

If you don't see the process above, check the dekiapi error logs (/var/log/dekiwiki/deki-api.log) for more details

You can restart the deki-api process by:

/etc/init.d/dekiwiki restart

Verification

Verify your new MindTouch installation by launching a browser and going to the following URI:

http://mindtouch