Setup a Project Wiki: Difference between revisions
| Line 2: | Line 2: | ||
== Add a Separate Instance of MediaWiki == | == Add a Separate Instance of MediaWiki == | ||
# ssh root@kingfisher | <font color=red>hostname</font> <font color=blue>~ #</font> '''ssh root@kingfisher''' | ||
# cd /srv/www/htwiki | <font color=red>hostname</font> <font color=blue>~ #</font> '''cd /srv/www/htwiki''' | ||
# tar -xzvf mediawiki-unconfiguredInstallation.tar.gz | <font color=red>hostname</font> <font color=blue>~ #</font> '''tar -xzvf mediawiki-unconfiguredInstallation.tar.gz''' | ||
# mv mediawiki $projectname | <font color=red>hostname</font> <font color=blue>~ #</font> '''mv mediawiki $projectname''' | ||
The go to the mediawiki setup website for your project: | The go to the mediawiki setup website for your project: | ||
| Line 19: | Line 19: | ||
* '''DB username''': wiki_$projectname | * '''DB username''': wiki_$projectname | ||
Unique password: | Unique password: | ||
# apg -m 9 -MNC | <font color=red>hostname</font> <font color=blue>~ #</font> '''apg -m 9 -MNC''' | ||
*more '''apg''' info [[Linux Tips and Tools|here]] | |||
And no table prefix. | And no table prefix. | ||
| Line 28: | Line 29: | ||
If it worked, this will create the LocalSettings.php file which you then move to the correct place: | If it worked, this will create the LocalSettings.php file which you then move to the correct place: | ||
# cd $projectname | <font color=red>hostname</font> <font color=blue>~ #</font> '''cd $projectname''' | ||
# mv config/LocalSettings.php | <font color=red>hostname</font> <font color=blue>~ #</font> '''mv config/LocalSettings.php''' | ||
Config should no longer be world writable: | Config should no longer be world writable: | ||
# chmod a-w config | <font color=red>hostname</font> <font color=blue>~ #</font> '''chmod a-w config''' | ||
Your wiki should be completely setup at: <nowiki>http://wiki.iat.sfu.ca/$projectname</nowiki> | Your wiki should be completely setup at: <nowiki>http://wiki.iat.sfu.ca/$projectname</nowiki> | ||
Revision as of 15:17, 12 March 2007
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:
$wgDisableUploads = false;
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'pdf', 'fls', 'swf', 'doc', 'jar' );
After this, check the user/permissions on the $projectname/images directory. Change:
chown wwwrun:www images
Suitable permissions for images/ would be 755.