1.9.0 Itasca Source Code Install and Upgrade Guide

Fresh Install:

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

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

Download Itasca 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:

cd ~/
tar xfvz Deki_Wiki_1.9.0_Itasca_source.tar.gz
cd Deki_Wiki_1.9.0_Itasca_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

cd ~/Deki_Wiki_1.9.0_Itasca_source

Edit the ./config/deki-apache.conf file

Change the following values according to your setup:

ServerName dekiwiki
DocumentRoot "/var/www/dekiwiki"

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

cp config/deki-apache.conf /etc/apache2/sites-available/deki
ln -s /etc/apache2/sites-available/deki /etc/apache2/sites-enabled/001-deki

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/deki 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 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

Update from Hayes 1.8x to Itasca 1.9x:

Upgrading from from previous version of Hayes to Itasca is a matter of updating the PHP and C# bits, and then running the database update scripts.

A step by step guide is available here.   This is the standard upgrade procedure - the complexity of upgrading from gooseberry to hayes upgrade was an anomaly.