1.7 Gooseberry Official Install and Upgrade Guide

Preparation

We've built DekiWiki to be the easiest to use and best wiki on the planet.  With this simplicity comes a little complexity.  First things first.  Let's install the prerequisites.

#DekiWiki Mono repo 
deb http://www.mindtouch.com/apt/ sarge main contrib non-free

cat << --END-- >> /etc/apt/sources.list
#DekiWiki Mono repo 
deb http://www.mindtouch.com/apt/ sarge main contrib non-free
--END--

apt-get update
apt-get install apache2 mysql-server php4 php4-cli php4-pear php4-mysql libapache2-mod-php4 php4-imagick php4-mcrypt php4-mhash php4-xslt imagemagick wv pdftohtml pwgen make pdftohtml html2text htmldoc aspell links mono mono-classlib-1.0 mono-classlib-2.0  libmono-sqlite1.0-cil libmono-sqlite2.0-cil mono-mcs

memory_limit = 32MB
post_max_size = 32MB
upload_max_filesize = 32MB

memory_limit = 128MB
post_max_size = 64MB
upload_max_filesize = 64MB

pear install Cache_Lite
pear install XML_RPC

a2enmod rewrite
/etc/init.d/apache2 force-reload

mysql -u root -e "set password = password('my_password');"

Download the DekiWiki bits

Get the latest DekiWiki bits from Open Garden

Direct Download: http://www.opengarden.org/download/d...current.tar.gz

Extract the files

tar xfvz dekiwiki-current.tar.gz

Install and Configure Search Indexing

DekiWik use DotLucene and mwsearch for search indexing.  To install and configure, do the following:

Build mwsearch (as root):

cd dekiwiki-current/mwsearch
make install
cp [[http://mwsearch.conf.mks/|mwsearch.conf.mks]] /etc/mwsearch.conf
mkdir /var/run/mwsearch
cp mwlucene /etc/init.d/mwlucene
chmod +x /etc/init.d/mwlucene
ln -s /etc/init.d/mwlucene /etc/rc2.d/S20mwlucene

Add MySQL root password to /etc/mwsearch.conf and change

password=

to

password=your_mysql_root_password

OPTIONAL: rebuild the search index each day at midnight

Add the following to /etc/crontab

echo "# Rebuild MWLucene Search Index" >> /etc/crontab
echo "0  2  * * *           root    /usr/local/bin/MWUpdater --rebuild > /var/log/MWUpdater.log" >> /etc/crontab
echo "30 2  * * *           root    /etc/init.d/mwlucene restart > /dev/null" >> /etc/crontab

Install DekiWiki

Whew!  The prerequisites are out of the way so let's install the DekiWiki bits.  To make this process easier, we've provided an install script.

In your deki-current directory run ./installWiki.sh

installWiki.sh

Usage: ./installWiki.sh --wikiName wiki_name --domainName domain_name --dbRootPwd db_root_password [--wikiInstallBaseDir base_install_directory] [--dbName databaseName]

Parameters:
--wikiName:  The name of your wiki.  This is also used as the hostname for you wiki.  Example: mywiki => mywiki.somedomain.com
--domainName: Your domain name
--dbRootPwd: MySQL password for root@localhost user.  This is required in order to create the DekiWiki database 
--wikiInstallBaseDir: installation directory.  Default is /var/www/
--dbName: The database name you want created.  Defaults to --wikiName if not specified

This script performs the following actions:

• copies the DekiWiki bits to to your installation directory /var/www/<wikiName>.<domain_name> by default
• installs and configures DekiWiki
• populates DekiWiki with a "base" set of content (pages)
• configures MWsearch to index DekiWiki for search

Example: (as root)

./installWiki.sh --wikiName mywiki --domainName example.com --dbRootPwd my_mysql_root_pass

This will create your DekiWik at /var/www/mywiki.example.com/

NOTE: this script will provide the Sysop password that you'll need to log in to the wiki once we're all done.

Enable your DekiWiki in Apache

Finally, it's time to configure Apache to serve up your DekiWiki installation.  We're using name-based virtual hosting in apache so we'll create a config as follows (don't forget to enter your configuration data):

/etc/apache2/sites-available/dekiWiki

<VirtualHost *>
        ServerName mywiki.example.com
        ServerAdmin webmaster@mywiki.example.com

        ErrorLog /var/log/apache2/mywiki.example.com-error_log
        CustomLog /var/log/apache2/mywiki.example.com-access_log common

        DocumentRoot /var/www/mywiki.example.com/

        RewriteEngine on
        RewriteCond %{REQUEST_URI} ^/$
        RewriteRule ^/$ /index.php?title=Home [L,NE]

        RewriteCond %{REQUEST_URI} !/(attachments|ControlPanel|editor|stylesheets|images|skins)/
        RewriteCond %{REQUEST_URI} !/(redirect|texvc|index).php
        RewriteCond %{REQUEST_URI} !/error/(40(1|3|4)|500).html
        RewriteCond %{REQUEST_URI} !/favicon.ico
        RewriteCond %{REQUEST_URI} !/robots.txt
        RewriteCond %{QUERY_STRING} ^$ [OR] %{REQUEST_URI} ^/Special:Search
        RewriteRule ^/(.*)$ /index.php?title=$1 [L,QSA,NE]
</VirtualHost>

Create a symlink in /etc/apache2/sites-available

ln -s /etc/apache2/sites-available/dekiWiki /etc/apache2/sites-enabled/001-dekiWiki

Now reload apache

/etc/init.d/apache2 force-reload

As soon as your DNS entry for mywiki.example.com is setup (or you've configured your /etc/hosts or c:\windows\system32\drivers\etc\hosts) you will be able to access your wiki by going to: http://mywiki.example.com. Log into your DekiWiki using the Sysop password provided by the installWiki.sh script (the passowrds are also available in a file named password-mywiki.example.com in your DekiWiki directory.

Post installation

Once DekiWiki is installed we recommend that you do the following:

1. Change your Sysop password by clicking Tools >> Control Panel and going to Site Settings
2. Add new users to your DekiWiki by clicking Tools >> Control Panel and going to User Management
   • NOTE: if you leave the password field blank, a password will be automatically generated and an email will be sent to the address specified.  To change who the email is sent from, change the $wgPasswordSender variable in /var/www/mywiki1.example.com/LocalSettings.php
3. Start contributing content!