1.8 Hayes Official 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 php-pear curl mysql-server-5.0

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

mysql -e "set password=PASSWORD('your_root_password')"

Download Hayes Bits

Download Hayes 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.8.1a_Hayes_source.tar.gz
cd Deki_Wiki_1.8.1a_Hayes_source

Copy web files to your apache directory

mkdir /var/www/deki-hayes 
cp -r web/*  /var/www/deki-hayes 
chown -R www-data /var/www/deki-hayes 

Configure Apache

cd ~/Deki_Wiki_1.8.1a_Hayes_source

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

Change the following values according to your setup:

# below are the default value
ServerName deki-hayes
DocumentRoot "/var/www/deki-hayes"
    
# I had to change to
ServerName <<<put your server name here>>>
ServerPath /deki-hayes/
DocumentRoot "/var/www/deki-hayes"

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_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 -k restart 

Configure deki-api

Create the deki-api logfile

touch /var/log/deki-api.log
chown www-data /var/log/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

Edit the config/dekihost init script. This script can be used to test the status of deki-api or start/stop the mindtouch.host.sh (deki-api) process.  Change the following values to match your configuration:

# path to your wiki
DEKI_PATH=/var/www/deki-hayes

# this should match your Apache ServerName directive
DEKI_SERVERNAME=deki-hayes

Copy the init script

cp config/dekihost /etc/init.d/

Create a symlink to the dekihost init script in the appropriate runlevel

update-rc.d dekihost defaults

Setup Lucene Index

mkdir /usr/local/var/
chown www-data /usr/local/var 

Install using the web-installer

Launch a browser and go to the installer:

http://deki-hayes/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/deki-hayes/bin/mindtouch.host.exe apikey 92669 script \ 
/etc/dekiwiki/mindtouch.deki.startup.xml \ 
server-name http://deki-hayes path-prefix @api http-port 8081 ip localhost notty

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

You can restart the deki-api process by:

/etc/init.d/dekihost restart

Verification

Verify your new Deki Wiki Hayes installation by launching a browser and going to the following URI:

http://deki-hayes/

Upgrade Guide from Gooseberry to Hayes:

Steps to update Deki Wiki Gooseberry to Hayes.  NOTE: many of the steps below have Debian-specific characteristics.

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

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

pear install XML_RPC Cache_Lite

mysqldump -u your_username -pyour_password your_wikidb  > wikidb-backup.sql

cd /var/www/mks-wiki
tar cvzf ~/attachments-backup.tar.gz attachments

cd ~/
tar xfvz Deki_Wiki_1.8.1a_Hayes_source.tar.gz 
cd ~/Deki_Wiki_1.8.1a_Hayes_source

mkdir /var/www/deki-hayes 
cp -r web/*  /var/www/deki-hayes 
chown -R www-data /var/www/deki-hayes 

mysql -u root -pyour_password -e "create database wikidb_hayes"

mysql -u root -pyour_password wikidb_hayes < wikidb-backup.sql

tar xfvz ~/attachments.tar.gz  -C /var/www/deki-hayes/
chown -R www-data /var/www/deki-hayes/attachments 

cd ~/Deki_Wiki_1.8.1a_Hayes_source

ServerName deki-hayes
DocumentRoot "/var/www/deki-hayes"

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

a2enmod rewrite 

a2enmod proxy_http

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

# 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 

/etc/init.d/apache2 restart 

touch /var/log/deki-api.log
chown www-data /var/log/deki-api.log

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

# path to your wiki
DEKI_PATH=/var/www/deki-hayes

# this should match your Apache ServerName directive
DEKI_SERVERNAME=deki-hayes

cp config/dekihost /etc/init.d/

ln -s /etc/init.d/dekihost /etc/rc2.d/S92dekihost 

mkdir /usr/local/var/
chown www-data /usr/local/var 

http://deki-hayes/

Update from Hayes 1.8.1x to 1.8.1.d:

Upgrading from the x to d release is simply a matter of updating the PHP and Dekihost bits, and then running the database update scripts:
 

cd /var/www/deki-hayes/maintenance/;
php update-db.php