Setup a Project Wiki

Kingfisher is our wiki server. Check out the wiki index to see existing wikis.

Add a Separate Instance of MediaWiki

hostname ~ # ssh root@kingfisher
hostname ~ # cd /srv/www/htwiki
hostname ~ # tar -xzvf mediawiki-unconfiguredInstallation.tar.gz
hostname ~ # mv mediawiki $projectname

The go to the mediawiki setup website for your project: http://wiki.iat.sfu.ca/$projectname

Fill in the options appropriately with some special Configuration options to note:

Leave the Sysop account name as WikiSysop; apply our strong password to this account.

Make a separate database for each project:

• Database name: wiki_$projectname

Seperate username for each project:

• DB username: wiki_$projectname

Unique password:

hostname ~ # apg -m 9 -MNC

• more apg info here

And no table prefix.

DB root password is again our strong password.

Note: When you click Install! it may fail. For me it has always failed if the username was too long (it must be at 16 characters or less)

If it worked, this will create the LocalSettings.php file which you then move to the correct place:

hostname ~ # cd $projectname
hostname ~ # mv config/LocalSettings.php

Config should no longer be world writable:

hostname ~ # chmod a-w config

Your wiki should be completely setup at: http://wiki.iat.sfu.ca/$projectname

I then usually go login to the wiki and add to the main page: Wiki is configured correctly. for 100% assurance that everything is working :)

To customize access and viewing restrictions, look at this article on Preventing Access (this version of mediawiki is 1.4).

Record the database username & password, and who this wiki was created for in our 'MediaWiki on Kingfisher' file.

Add Sysop/Administrator User

Follow these steps to make a wiki account, a sysop account:

Create the account, if you haven't done so already. Logout. Login as the WikiSysop user.

Navigate to Special Pages -> Make a user into a sysop, or modify this link with your project name: http://wiki.iat.sfu.ca/$projectname/index.php/Special:Makesysop

Enter the username and set bureaucrat flag too.

Customizing

All changes should be made to /srv/www/htwiki/<project_name>/LocalSettings.php. In most cases the variable you want to adjust is already defined under includes/DefaultSettings.php, but this may be over-written during upgrades!! Typical examples are to enable or disable all file uploading:

hostname ~ # emacs -nw /srv/www/htwiki/<project_name>/LocalSettings.php
         $wgDisableUploads             = false;
         $wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'pdf', 'fls', 'swf', 'doc', 'jar', 'dmg' );

After this, check the user/permissions on the $projectname/images directory. Change:

hostname ~ # chown wwwrun:www images

Suitable permissions for images/ would be 755.

Filesize limits can be tricky - Mediawiki just follows general apache and php limitations, so that's where/what we must adjust (tirpitz used as an example):

hostname ~ # emacs -nw /etc/php/cgi-php5/php.ini
         memory_limit "128M"
         file_uploads "On"
         post_max_size "25M"
         upload_max_filesize "25M"