Manual:Installing MediaWiki on SourceForge.net

&lt; Running MediaWiki

This page will give you information about installing MediaWiki on a SourceForge.net webserver.

For the sake of simplicity, we will assume that :
 * your SF.net username is johndoe
 * your project is called apollo

Hence, the paths will be :
 * your personnal folder on SF.net is /home/users/j/jo/johndoe,
 * your project web root is /home/groups/a/ap/apollo/htdocs,
 * the web site is at http://apollo.sourceforge.net/.

Security and privacy
'''SourceForge's project web servers use an insecure configuration which allows any other registered developer of any registered project to read your configuration files (including database password) and session data, and to write data into any file or directory you've made writable by the web server. Consider the security and privacy implications before installing a web application such as MediaWiki into your project space.'''

Prerequisites

 * 1) You must be an administrator of your project,
 * 2) You must have had the MySQL database created on SF.net,
 * 3) You must have a working Shell access to the SF.net server.

The MySQL is not created by default, you must ask for it be be created on the 'Admin' section your project. It takes about 4 hours for SF to process this creation request.

Installation - The obvious part

 * 1) Uploading the sources
 * 2) Get the latest tarball of mediawiki,
 * 3) upload its contents to /home/groups/a/ap/apollo/htdocs (you may them want to put them in a subfolder ).
 * 4) Getting ready to configure MediaWiki
 * 5) go to http://apollo.sourceforge.net/config/index.php
 * 6) A message asking you to chmod the config</tt> folder is displayed. Open a shell session and do as told
 * 7) SourceForge specifics
 * 8) the database setup : see the Guide to MySQL Database Services on SF.net support pages
 * Database host: mysql.sourceforge.net
 * Database name: apollo
 * Database user: apollo
 * Database password: specified when the database creation was requested
 * 1) Committing the changes
 * 2) copy the LocalSettings.php</tt> to the web root folder,
 * 3) delete the config</tt>.

PHP Paths
For some reasons, you should put $IP = "/home/groups/a/ap/apollo/htdocs/";</tt> at the beginning of LocalSettings.php</tt>.

Sessions
PHP sessions needs special cares on SF.net servers as SF.net hosts a server farm and not a single server. the required actions are the following :
 * 1) create a folder to store the sessions. for instance, /home/groups/a/ap/apollo/sessions</tt>
 * 2) *DO NOT STORE THIS FOLDER UNDER THE htdocs</tt> FOLDER OR SESSION DATA MAY BE ACCESSIBLE FROM THE WEB
 * 3) make sure this folder is writable (by typing chmod a+w sessions</tt> from a shell)
 * 4) tell MediaWiki to use this folder to store the sessions, by adding session_save_path("/home/groups/a/ap/apollo/sessions");</tt> at the beginning of LocalSettings.php</tt>.