User:bjorntheart >

User:bjorntheart

 

VPSLink Install

This guide is based on the http://wiki.opengarden.org/Deki_Wiki/Installation_and_Upgrade/1.8_Hayes_Official_Install_and_Upgrade_Guide , but with a little bit extra for the newbies out there.

NOTE:

  • This is a Debian-specific install guide
  • The IP address: 111.11.111.11 refers to the IP address given to you at VPSLink after signup and OS install(this is just a reference)
  • localuser refers to the user in your /home directory (it could be /home/kevin, /home/jonathan etc)
  • yourpassword refers to your specific account password for localuser

Fresh Install:

Prerequisites

  • Apache 2.x
  • MySQL 5.0.X - NOTE: Deki Wiki Hayes uses stored procedures and is therefore incompatible with MySQL 4.x
  • PHP 5.X - NOTE: Deki Wiki Hayes uses the PHP5 object model and is therefore incompatible with PHP4
  • Mono 1.2.X

*) Login to your vpslink control panel here https://cp.vpslink.com/  with your Email address and password supplied to you by vpslink

*) Goto

Manage Server ->  Manage OS -> Install OS

from the "New Operating System" dropdown list select Debian 4.0 "Etch" 

*) Change your root password to something secure if not already 

 Manage Server -> Change Root Password

NOTE: 12345 is not a good strong password...neither is abcdef

Loggin on to your vpslink server

*) Open a terminal window on your local machine

*) Login as root to your vpslink server via ssh 

I know root terminal sessions is a BIG NOOoooo!!!! You can find some help here. http://wiki.vpslink.com/index.php?title=HOWTO:_Base_installation_and_configuration

ssh root@111.11.111.11

*) Enter your password at promt and you should be logged in

Update software repositories and system

*) Configure sources.list

nano /etc/apt/sources.list

*) Delete the following lines

deb http://ftp.freenet.de/debian stable main contrib non-free
deb http://security.debian.org stable/updates main contrib non-free 

 *) Add the following lines

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

*) Execute the following command

apt-get udpate 

*) Install locales, if not already installed

apt-get install locales

You'll notice the following warnings while installing locales, but don't worry we'll fix it soon

perl: warning: Setting locale failed.
perl: warning: Please check that your locale settings:
        LANGUAGE = (unset),
        LC_ALL = (unset),
        LANG = "en_US.UTF-8"
    are supported and installed on your system.
perl: warning: Falling back to the standard locale ("C").
locale: Cannot set LC_CTYPE to default locale: No such file or directory
locale: Cannot set LC_MESSAGES to default locale: No such file or directory
locale: Cannot set LC_ALL to default locale: No such file or directory

 *) Once that is finished, you need to configure your local time zone with tzconfig

tzconfig

My settings where for 'Africa/Johannesburg'. Yours will be different. If everything went smoothly, it should display something like this

Your default time zone is set to 'Africa/Johannesburg'.
Local time is now:      Fri Oct 26 16:26:57 SAST 2007.
Universal Time is now:  Fri Oct 26 14:26:57 UTC 2007.

*)  Execute the following commands to get rid of that nasty perl warnings

export LC_CTYPE=C
export LC_MESSAGES=C
export LC_ALL=C

*) Then you need to reconfigure locales with this command

dpkg-reconfigure locales 

*) Select the correct setting from the list. Mine was set for South Africa. Yours will be different

en_ZA.UTF-8 UTF-8 

*) Execute the following command to finalise the updates

apt-get upgrade
apt-get dist-upgrade

Hayes Deki-Wiki installation

*) Install the prerequisites

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

*) Install mono

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

*) set your mysql root password (if this is the first time you've installed mysql)

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

*) install pear libraries

pear install XML_RPC Cache_Lite

*) Create localuser

adduser localuser

*) Download the Hayes Bits to your home directory

cd /home/localuser
wget http://downloads.sourceforge.net/dekiwiki/Deki_Wiki_1.8.2b_Hayes_source.tar.gz

*) Extract the archive to your home directory:

tar xfvz Deki_Wiki_1.8.2b_Hayes_source.tar.gz
cd Deki_Wiki_1.8.2b_Hayes_source.tar.gz

*) 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 /home/localuser/Deki_Wiki_1.8.2b_Hayes_source

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

nano config/deki-apache.conf

*) Change the following values according to your setup:

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

*) Save and exit 

*) Copy the apache config file

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

*) Disable default apache site 

a2dissite default 
rm /etc/apache2/sites-enabled/000-default 

*) Make deki the default website

a2ensite 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 ) 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

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

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

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://yourdomain/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.

Tag page
You must login to post a comment.
Powered by MindTouch Deki v.8.08.1a