8.08 Kilen Woods Source Code Install and Upgrade Guide

Fresh Install:

deb http://ftp.debian.org/debian/ etch main 
deb-src http://ftp.debian.org/debian/ etch main 

deb http://ftp.debian.org/debian/ etch main non-free contrib deb-src http://ftp.debian.org/debian/ etch main non-free contrib

# apt-get install apache2 php5 php5-cli php5-mysql libapache2-mod-php5 php5-mcrypt \
php5-mhash php5-gd php5-curl imagemagick wv poppler-utils html2text html2ps htmldoc aspell \
links curl mysql-server-5.0 poppler-utils msttcorefonts cabextract 

# wget http://www.princexml.com/download/prince_6.0r6-1_i386.deb
# dpkg -i prince_6.0r6-1_i386.deb

# apt-get install mono-gmcs mono-mcs libmono-sqlite2.0-cil libmono-sqlite2.0-cil libmono-system-web2.0-cil

Download Bits

Download the Deki Wiki Itasca build from one of the following sources:

• RECOMMENDED: http://sourceforge.net/projects/dekiwiki (tarballs)
• http://wiki.opengarden.org/Source_Code (includes SVN enlistment info)

Extract the archive to your home directory (the name of the tar file may be different depending on your tarball download):

# cd ~/
# tar xfzv Deki_Wiki_8.08_Kilen_Woods_source.tar.gz
# cd Deki_Wiki_8.08_Kilen_Woods_source

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:

ServerName dekiwiki
DocumentRoot "/var/www/dekiwiki"

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

# cp 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 dekiwiki-init.debian /etc/init.d/dekiwiki

Install the init script into the default runlevels

# update-rc.d dekiwiki defaults

Install using the web-installer

Launch a browser and go to the installer:

http://dekiwiki/config/index.php

Fill in the required information and click "Install Deki Wiki"

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.

* if your database name has an underscore, you have get an "execute command denied" error. If so, create a new database user, grant them the right perms (CRUD), and set them as the database user in LocalSettings.php

* 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 Deki Wiki Hayes installation by launching a browser and going to the following URI:

http://dekiwiki