MediaWiki is Copyright (C) 2001-2005 by Magnus Manske, Brion Vibber, Lee Daniel Crocker, Tim Starling, Erik Möller, Gabriel Wicke and others.

• Readme
• Release notes
• doc/
• User's Guide

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. or read it online

MediaWiki installation

Already configured... return to the wiki.

(You should probably remove this directory for added security.)

Can't write config file, aborting

In order to configure the wiki you have to make the config subdirectory writable by the web server. Once configuration is done you'll move the created LocalSettings.php to the parent directory, and for added safety you can then remove the config subdirectory entirely.

To make the directory writable on a Unix/Linux system:

	cd /path/to/wiki
	chmod a+w config
	

Please include all of the lines below when reporting installation problems.

Checking environment...

PHP " . phpversion() . ": ok\n"; if( ini_get( "register_globals" ) ) { ?>
• Warning: PHP's register_globals option is enabled. MediaWiki will work correctly, but this setting increases your exposure to potential security vulnerabilities in PHP-based software running on your server. You should disable it if you are able.
• Fatal: magic_quotes_runtime is active! This option corrupts data input unpredictably; you cannot install or use MediaWiki unless this option is disabled.
• Fatal: magic_quotes_sybase is active! This option corrupts data input unpredictably; you cannot install or use MediaWiki unless this option is disabled.
• Fatal: mbstring.func_overload is active! This option causes errors and may corrupt data unpredictably; you cannot install or use MediaWiki unless this option is disabled.

  Cannot install wiki.

  " ); } if( ini_get( "safe_mode" ) ) { $conf->safeMode = true; ?>
• Warning: PHP's safe mode is active. You may have problems caused by this, particularly if using image uploads.
safeMode = false; } $sapi = php_sapi_name(); $conf->prettyURLs = true; print "
• PHP server API is $sapi; "; switch( $sapi ) { case "apache": case "apache2handler": print "ok, using pretty URLs (index.php/Page_Title)"; break; case "cgi": case "cgi-fcgi": case "apache2filter": print "using ugly URLs (index.php?title=Page_Title)"; $conf->prettyURLs = false; break; default: print "unknown; using pretty URLs (index.php/Page_Title), if you have trouble change this in LocalSettings.php"; } print "
\n"; $conf->xml = function_exists( "utf8_encode" ); if( $conf->xml ) { print "
• Have XML / Latin1-UTF-8 conversion support.
\n"; } else { dieout( "PHP's XML module is missing; the wiki requires functions in this module and won't work in this configuration. If you're running Mandrake, install the php-xml package." ); } $memlimit = ini_get( "memory_limit" ); $conf->raiseMemory = false; if( empty( $memlimit ) || $memlimit == -1 ) { print "
• PHP is configured with no memory_limit.
\n"; } else { print "
• PHP's memory_limit is " . htmlspecialchars( $memlimit ) . ". If this is too low, installation may fail! "; $n = IntVal( $memlimit ); if( preg_match( '/^([0-9]+)[Mm]$/', trim( $memlimit ), $m ) ) { $n = IntVal( $m[1] * (1024*1024) ); } if( $n < 20*1024*1024 ) { print "Attempting to raise limit to 20M... "; if( false === ini_set( "memory_limit", "20M" ) ) { print "failed."; } else { $conf->raiseMemory = true; print "ok."; } } print "
\n"; } $conf->zlib = function_exists( "gzencode" ); if( $conf->zlib ) { print "
• Have zlib support; enabling output compression.
\n"; } else { print "
• No zlib support.
\n"; } $conf->turck = function_exists( 'mmcache_get' ); if ( $conf->turck ) { print "
• Turck MMCache installed
\n"; } $conf->eaccel = function_exists( 'eaccelerator_get' ); if ( $conf->eaccel ) { $conf->turck = 'eaccelerator'; print "
• eAccelerator installed
\n"; } if (!$conf->turck && !$conf->eaccel) { print "
• Neither Turck MMCache nor eAccelerator are installed, " . "can't use object caching functions
\n"; } $conf->diff3 = false; $diff3locations = array("/usr/bin", "/opt/csw/bin", "/usr/gnu/bin", "/usr/sfw/bin") + explode(":", getenv("PATH")); $diff3names = array("gdiff3", "diff3"); $diff3versioninfo = array('$1 --version 2>&1', 'diff3 (GNU diffutils)'); foreach ($diff3locations as $loc) { $exe = locate_executable($loc, $diff3names, $diff3versioninfo); if ($exe !== false) { $conf->diff3 = $exe; break; } } if ($conf->diff3) print "
• Found GNU diff3: $conf->diff3.
"; else print "
• GNU diff3 not found.
"; $conf->ImageMagick = false; $imcheck = array( "/usr/bin", "/usr/local/bin", "/sw/bin", "/opt/local/bin" ); foreach( $imcheck as $dir ) { $im = "$dir/convert"; if( file_exists( $im ) ) { print "
• Found ImageMagick: $im; image thumbnailing will be enabled if you enable uploads.
\n"; $conf->ImageMagick = $im; break; } } $conf->HaveGD = function_exists( "imagejpeg" ); if( $conf->HaveGD ) { print "
• Found GD graphics library built-in"; if( !$conf->ImageMagick ) { print ", image thumbnailing will be enabled if you enable uploads"; } print ".
\n"; } else { if( !$conf->ImageMagick ) { print "
• Couldn't find GD library or ImageMagick; image thumbnailing disabled.
\n"; } } $conf->UseImageResize = $conf->HaveGD || $conf->ImageMagick; # $conf->IP = "/Users/brion/Sites/inplace"; $conf->IP = dirname( dirname( __FILE__ ) ); print "
• Installation directory: " . htmlspecialchars( $conf->IP ) . "
\n"; # $conf->ScriptPath = "/~brion/inplace"; $conf->ScriptPath = preg_replace( '{^(.*)/config.*$}', '$1', $_SERVER["PHP_SELF"] ); # was SCRIPT_NAME print "
• Script URI path: " . htmlspecialchars( $conf->ScriptPath ) . "
\n"; $conf->posted = ($_SERVER["REQUEST_METHOD"] == "POST"); $conf->Sitename = ucfirst( importPost( "Sitename", "" ) ); $defaultEmail = empty( $_SERVER["SERVER_ADMIN"] ) ? 'root@localhost' : $_SERVER["SERVER_ADMIN"]; $conf->EmergencyContact = importPost( "EmergencyContact", $defaultEmail ); $conf->DBserver = importPost( "DBserver", "localhost" ); $conf->DBname = importPost( "DBname", "wikidb" ); $conf->DBuser = importPost( "DBuser", "wikiuser" ); $conf->DBpassword = importPost( "DBpassword" ); $conf->DBpassword2 = importPost( "DBpassword2" ); $conf->DBprefix = importPost( "DBprefix" ); $conf->DBmysql5 = (importPost( "DBmysql5" ) == "true") ? "true" : "false"; $conf->RootPW = importPost( "RootPW" ); $conf->LanguageCode = importPost( "LanguageCode", "en" ); $conf->SysopName = importPost( "SysopName", "WikiSysop" ); $conf->SysopPass = importPost( "SysopPass" ); $conf->SysopPass2 = importPost( "SysopPass2" ); /* Check for validity */ $errs = array(); if( $conf->Sitename == "" || $conf->Sitename == "MediaWiki" || $conf->Sitename == "Mediawiki" ) { $errs["Sitename"] = "Must not be blank or \"MediaWiki\"."; } if( $conf->DBuser == "" ) { $errs["DBuser"] = "Must not be blank"; } if( $conf->DBpassword == "" ) { $errs["DBpassword"] = "Must not be blank"; } if( $conf->DBpassword != $conf->DBpassword2 ) { $errs["DBpassword2"] = "Passwords don't match!"; } if( !preg_match( '/^[A-Za-z_0-9]*$/', $conf->DBprefix ) ) { $errs["DBprefix"] = "Invalid table prefix"; } if( $conf->SysopPass == "" ) { $errs["SysopPass"] = "Must not be blank"; } if( $conf->SysopPass != $conf->SysopPass2 ) { $errs["SysopPass2"] = "Passwords don't match!"; } $conf->License = importRequest( "License", "none" ); if( $conf->License == "gfdl" ) { $conf->RightsUrl = "http://www.gnu.org/copyleft/fdl.html"; $conf->RightsText = "GNU Free Documentation License 1.2"; $conf->RightsCode = "gfdl"; $conf->RightsIcon = '${wgStylePath}/common/images/gnu-fdl.png'; } elseif( $conf->License == "none" ) { $conf->RightsUrl = $conf->RightsText = $conf->RightsCode = $conf->RightsIcon = ""; } else { $conf->RightsUrl = importRequest( "RightsUrl", "" ); $conf->RightsText = importRequest( "RightsText", "" ); $conf->RightsCode = importRequest( "RightsCode", "" ); $conf->RightsIcon = importRequest( "RightsIcon", "" ); } $conf->Shm = importRequest( "Shm", "none" ); $conf->MCServers = importRequest( "MCServers" ); /* Test memcached servers */ if ( $conf->Shm == 'memcached' && $conf->MCServers ) { $conf->MCServerArray = array_map( 'trim', explode( ',', $conf->MCServers ) ); foreach ( $conf->MCServerArray as $server ) { $error = testMemcachedServer( $server ); if ( $error ) { $errs["MCServers"] = $error; break; } } } else if ( $conf->Shm == 'memcached' ) { $errs["MCServers"] = "Please specify at least one server if you wish to use memcached"; } /* default values for installation */ $conf->Email =importRequest("Email", "email_enabled"); $conf->Emailuser=importRequest("Emailuser", "emailuser_enabled"); $conf->Enotif =importRequest("Enotif", "enotif_allpages"); $conf->Eauthent =importRequest("Eauthent", "eauthent_enabled"); if( $conf->posted && ( 0 == count( $errs ) ) ) { do { /* So we can 'continue' to end prematurely */ $conf->Root = ($conf->RootPW != ""); /* Load up the settings and get installin' */ $local = writeLocalSettings( $conf ); $wgCommandLineMode = false; chdir( ".." ); eval($local); $wgDBadminuser = "root"; $wgDBadminpassword = $conf->RootPW; $wgDBprefix = $conf->DBprefix; $wgCommandLineMode = true; $wgUseDatabaseMessages = false; /* FIXME: For database failure */ require_once( "includes/Setup.php" ); chdir( "config" ); require_once( "maintenance/InitialiseMessages.inc" ); $wgTitle = Title::newFromText( "Installation script" ); $mysqlOldClient = version_compare( mysql_get_client_info(), "4.1.0", "lt" ); if( $mysqlOldClient ) { print "
• PHP is linked with old MySQL client libraries. If you are using a MySQL 4.1 server and have problems connecting to the database, see http://dev.mysql.com/doc/mysql/en/old-client.html for help.
\n"; } print "
• Trying to connect to MySQL on $wgDBserver as root...\n"; $wgDatabase = Database::newFromParams( $wgDBserver, "root", $conf->RootPW, "", 1 ); if( $wgDatabase->isOpen() ) { $myver = mysql_get_server_info( $wgDatabase->mConn ); $wgDatabase->ignoreErrors(true); $conf->Root = true; print "
  • Connected as root (automatic)
\n"; } else { print "
• MySQL error " . ($err = mysql_errno() ) . ": " . htmlspecialchars( mysql_error() ) . "
"; $ok = false; switch( $err ) { case 1045: case 2000: if( $conf->Root ) { $errs["RootPW"] = "Check password"; } else { print "
• Trying regular user...\n"; /* Try the regular user... */ $wgDBadminuser = $wgDBuser; $wgDBadminpassword = $wgDBpassword; /* Wait one second for connection rate limiting, present on some systems */ sleep(1); $wgDatabase = Database::newFromParams( $wgDBserver, $wgDBuser, $wgDBpassword, "", 1 ); if( !$wgDatabase->isOpen() ) { print "
  • MySQL error " . ($err = mysql_errno() ) . ": " . htmlspecialchars( mysql_error() ) . "
"; $errs["DBuser"] = "Check name/pass"; $errs["DBpassword"] = "or enter root"; $errs["DBpassword2"] = "password below"; $errs["RootPW"] = "Got root?"; } else { $myver = mysql_get_server_info( $wgDatabase->mConn ); $wgDatabase->ignoreErrors(true); $conf->Root = false; $conf->RootPW = ""; print " ok.\n"; # And keep going... $ok = true; } break; } case 2002: case 2003: $errs["DBserver"] = "Connection failed"; break; default: $errs["DBserver"] = "Couldn't connect to database ($err)"; break; } if( !$ok ) continue; } if ( !$wgDatabase->isOpen() ) { $errs["DBserver"] = "Couldn't connect to database"; continue; } print "
• Connected to $myver"; if( version_compare( $myver, "4.0.0" ) >= 0 ) { print "; enabling MySQL 4 enhancements"; $conf->DBmysql4 = true; $local = writeLocalSettings( $conf ); } $mysqlNewAuth = version_compare( $myver, "4.1.0", "ge" ); if( $mysqlNewAuth && $mysqlOldClient ) { print "; You are using MySQL 4.1 server, but PHP is linked to old client libraries; if you have trouble with authentication, see http://dev.mysql.com/doc/mysql/en/old-client.html for help."; } if( $wgDBmysql5 ) { if( $mysqlNewAuth ) { print "; enabling MySQL 4.1/5.0 charset mode"; } else { print "; MySQL 4.1/5.0 charset mode enabled, but older version detected; will likely fail."; } } print "
\n"; @$sel = mysql_select_db( $wgDBname, $wgDatabase->mConn ); if( $sel ) { print "
• Database " . htmlspecialchars( $wgDBname ) . " exists
\n"; } else { $err = mysql_errno(); if ( $err != 1049 ) { print "
• Error selecting database $wgDBname: $err " . htmlspecialchars( mysql_error() ) . "
"; continue; } $res = $wgDatabase->query( "CREATE DATABASE `$wgDBname`" ); if( !$res ) { print "
• Couldn't create database " . htmlspecialchars( $wgDBname ) . "; try with root access or check your username/pass.
\n"; $errs["RootPW"] = "<- Enter"; continue; } print "
• Created database " . htmlspecialchars( $wgDBname ) . "
\n"; } $wgDatabase->selectDB( $wgDBname ); if( $wgDatabase->tableExists( "cur" ) || $wgDatabase->tableExists( "revision" ) ) { print "
• There are already MediaWiki tables in this database. Checking if updates are needed...
\n"; # Create user if required if ( $conf->Root ) { $conn = Database::newFromParams( $wgDBserver, $wgDBuser, $wgDBpassword, $wgDBname, 1 ); if ( $conn->isOpen() ) { print "
• DB user account ok
\n"; $conn->close(); } else { print "
• Granting user permissions..."; if( $mysqlOldClient && $mysqlNewAuth ) { print " If the next step fails, see http://dev.mysql.com/doc/mysql/en/old-client.html for help."; } print "
\n"; dbsource( "../maintenance/users.sql", $wgDatabase ); } } print "

\n";
			chdir( ".." );
			flush();
			do_all_updates();
			chdir( "config" );

			print "

\n"; print "
• Finished update checks.
\n"; } else { # FIXME: Check for errors print "
• Creating tables..."; if( $wgDBmysql5 ) { print " using MySQL 5 table defs..."; dbsource( "../maintenance/mysql5/tables.sql", $wgDatabase ); } else { print " using MySQL 3/4 table defs..."; dbsource( "../maintenance/tables.sql", $wgDatabase ); } dbsource( "../maintenance/interwiki.sql", $wgDatabase ); print " done.
\n"; print "
• Initializing data..."; $wgDatabase->insert( 'site_stats', array( 'ss_row_id' => 1, 'ss_total_views' => 0, 'ss_total_edits' => 0, 'ss_good_articles' => 0 ) ); # setting up the db user if( $conf->Root ) { print "
• Granting user permissions...
\n"; dbsource( "../maintenance/users.sql", $wgDatabase ); } if( $conf->SysopName ) { $u = User::newFromName( $conf->getSysopName() ); if ( 0 == $u->idForName() ) { $u->addToDatabase(); $u->setPassword( $conf->getSysopPass() ); $u->saveSettings(); $u->addGroup( "sysop" ); $u->addGroup( "bureaucrat" ); print "
• Created sysop account " . htmlspecialchars( $conf->SysopName ) . ".
\n"; } else { print "
• Could not create user - already exists!
\n"; } } else { print "
• Skipped sysop account creation, no name given.
\n"; } $titleobj = Title::newFromText( wfMsgNoDB( "mainpage" ) ); $article = new Article( $titleobj ); $newid = $article->insertOn( $wgDatabase ); $revision = new Revision( array( 'page' => $newid, 'text' => wfMsg( 'mainpagetext' ) . "\n\n" . wfMsg( 'mainpagedocfooter' ), 'comment' => '', 'user' => 0, 'user_text' => 'MediaWiki default', ) ); $revid = $revision->insertOn( $wgDatabase ); $article->updateRevisionOn( $wgDatabase, $revision ); print "

• ";
  			initialiseMessages();
  			print "

\n"; } /* Write out the config file now that all is well */ print "

Creating LocalSettings.php...

\n\n"; $localSettings = "<" . "?php$endl$local$endl?" . ">"; // Fix up a common line-ending problem (due to CVS on Windows) $localSettings = str_replace( "\r\n", "\n", $localSettings ); if( version_compare( phpversion(), "4.3.2" ) >= 0 ) { $xt = "xt"; # Refuse to overwrite an existing file } else { $xt = "wt"; # 'x' is not available prior to PHP 4.3.2. We did check above, but race conditions blah blah } $f = fopen( "LocalSettings.php", $xt ); if( $f == false ) { dieout( "

Couldn't write out LocalSettings.php. Check that the directory permissions are correct and that there isn't already a file of that name here...

\n" . "

Here's the file that would have been written, try to paste it into place manually:

\n" . "

\n" . htmlspecialchars( $localSettings ) . "

\n" ); } if(fwrite( $f, $localSettings ) ) { fclose( $f ); writeSuccessMessage(); } else { fclose( $f ); die("

An error occured while writing the config/LocalSettings.php file. Check user rights and disk space then try again.

\n"); } } while( false ); } ?>

Something's not quite right yet; make sure everything below is filled out correctly.

To complete the installation, please do the following:

1. Download config/LocalSettings.php with your FTP client or file manager
2. Upload it to the parent directory
3. Delete config/LocalSettings.php
4. Start using your wiki!

If you are in a shared hosting environment, do not just move LocalSettings.php remotely. LocalSettings.php is currently owned by the user your webserver is running under, which means that anyone on the same server can read your database password! Downloading it and uploading it again will hopefully change the ownership to a user ID specific to you.

Installation successful! Move the config/LocalSettings.php file into the parent directory, then follow this link to your wiki.