Install a wiki

From DSL Wiki

Contents

why that

When i started using DSL, i wanted to set up a small server for a website on an old TravelMate 510 Series Notebook. The main problem was to get a wikisoftware installed. Read the following instructions, if you also want to do so

preparing the notebook

Before installing the wiki software, the notebook itself had to be set up. To do this, yust follow the instructions at Installing_to_the_Hard_Disk and http://www.damnsmalllinux.org/dsl-hd-install.html.

getting the software

  • The wiki software i used was MediaWiki
  • to install this, you also need MySql
  • for the web interface, you need PHP5

to install those software, there's a need to install

  • gnu c compiler with libraries
  • libxml2
  • expat

I did the installation with the following packages (no warranty to get other versions running):

  • gcc1-with-lib.dsl, version 3.3.4
  • libxml2-2.6.30.tar.gz
  • expat-2.0.1.tar.gz
  • mysql-max-4.1.22-pc-linux-gnu-i686.tar
  • httpd-2.2.6.tar.gz (apache webserver)
  • php-5.2.4.tar.gz
  • mediawiki-1.6.10.tar.gz
  • (optinal) imagemagick.uci from the MyDsl Extension Tool

installing support software

Get all the software above.

Open the MyDsl Extension browser, navigate through "System" to gcc1-with-libs.dls. Select it, then press download. It will be installed.

cd into the directory, where you have all the sowftware packages

 tar xvzf expat-2.0.1.tar.gz
 tar xvzf libxml2-2.6.30.tar.gz
 tar xvzf mysql-max-4.1.22-pc-linux-gnu-i686.tar.gz
 tar xvzf httpd-2.2.6.tar.gz
 tar xvzf php-5.2.4.tar.gz
 tar xvzf mediawiki-1.6.10.tar.gz

install expat:

 cd expat-2.0.1
 ./configure --prefix=/usr/local/expat
 make
 make install
 cd ..

then install libxml:

 cd libxml2-2.6.30
 ./configure --prefix=/usr/local/libxml
 make
 make install
 cd ..

now, you're ready to begin installing the wiki software parts:

 mv mysql-max-4.1.22-pc-linux-gnu-i686 /usr/local/mysql
 adduser mysql
 

you can directly start mysql, because the mentioned version is a ready-to-run package:

 /usr/local/mysql/support-files/mysql.server start
 /usr/local/mysql/bin/mysqladmin -u root password <yourpasswordhere>

Now the sql server should be running. Next, install the apache web server:

 cd /httpd-2.2.6
 ./configure --prefix=/usr/local/apache --enable-module=all --enable-so
 make
 make install
 cd ..

After that, the PHP binaries can be built:

 cd php-5.2.4
 ./configure \
   --with-apxs2=/usr/local/apache/bin/apxs \
   --with-config-file-path=/usr/local/apache/conf \
   --with-mysql=/usr/local/mysql \
   --with-libxml-dir=/usr/local/libxml \
   --enable-ftp \
   --with-gd \
   --enable-bcmath \
   --disable-debug \
   --enable-track-vars
 make
 make install

Now, you've installed alle the prerequisites to install the wiki itself.

installing the wiki

 cd /usr/local/apache/htdocs
 mv /<pathToPackage>/mediawiki-1.6.10 wiki

This will move the files of the wiki to the directory /usr/local/apache/htdocs/wiki. Make sure, the wiki is allowd to operate in this directory:

 cd wiki
 chmod 755 config

if the mysql server is running, you may now begin to create the wiki database:

 /usr/local/mysql/bin/mysql -u root -p mysql

This will start the mysql command line. On the command line, enter:

 create database wikidb;
 grant create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'yourpasswordhere';
 flush privileges;
 \q

Now start the web server:

 /usr/local/apache/bin/apachectl start

After that, you should be able to install the wiki via the web interface. Therefore, open [1] in your web browser and follow the online guide, which should appear.

additional hints

if you would like to use thumbnail pictures within your wiki, you should download imagemagick.uci via the MyDsl Extension Tool (MyDSL Extensions > UCI > imagemagick.uci), load it via

 mydsl-load /<pathToPackage>/imagemagick.uci

and add the lines

 $wgUseImageResize = true;
 $wgUseImageMagick = true;

to the file /usr/local/apache/htdocs/wiki/LocalSetting.php

links to further information

tutorial how to install mysql with php for apache
tutorial how to install the media wiki