MediaWiki is Copyright (C) 2001-2006 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; default: print "unknown; "; case "cgi": case "cgi-fcgi": case "apache2filter": case "isapi": print "using ugly URLs (index.php?title=Page_Title)"; $conf->prettyURLs = false; break; } 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->RootUser = importPost( "RootUser", "root" ); $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"; } # Determine how we're going to connect to the database if( $conf->RootPW == '-' ) { # Regular user $conf->Root = false; $db_user = $wgDBuser; $db_pass = $wgDBpassword; } else { # Superuser $conf->Root = true; $db_user = $conf->RootUser; $db_pass = $conf->RootPW; } # Now attempt the connection echo( "
• Connecting to $wgDBname on $wgDBserver as $db_user..." ); $wgDatabase = Database::newFromParams( $wgDBserver, $db_user, $db_pass, "", 1 ); if( $wgDatabase->isOpen() ) { # We're in; set up a few variables $ok = true; echo( "success.
\n" ); $wgDatabase->ignoreErrors( true ); $myver = mysql_get_server_info( $wgDatabase->mConn ); $wgDBadminuser = $db_user; $wfDBadminpassword = $db_pass; } else { # There was an error; if we recognise it, give some useful feedback $ok = false; $errno = mysql_errno(); $errtx = htmlspecialchars( mysql_error() ); echo( "failed with error $errno: $errtx.\n" ); switch( $errno ) { case 1045: case 2000: # Authentication if( $conf->Root ) { # The superuser details are wrong $errs["RootUser"] = "Check username"; $errs["RootPW"] = "and password"; } else { # The regular user details are wrong $errs["DBuser"] = "Check username"; $errs["DBpassword"] = "and password"; } break; default: # Something else $errs["DBserver"] = "Couldn't connect to database"; break; } # switch } # conn att if( !$ok ) continue; # Print out the mySQL version and enable mySQL 4 enhancements as needed echo( "
• Connected to $myver" ); if( version_compare( $myver, "4.0.0" ) >= 0 ) { echo( "; using enhancements for mySQL 4.
" ); $conf->DBmysql4 = true; $local = writeLocalSettings( $conf ); } # Check for possible authentication problems re. password encryption in newer mySQL versions $mysqlNewAuth = version_compare( $myver, "4.1.0", "ge" ); if( $mysqlNewAuth && $mysqlOldClient ) { echo( "
• You are using mySQL 4.1, however, PHP is linked to older client libraries. If you encounter authentication problems, see http://dev.mysql.com/doc/mysql/en/old-client.html for pertinent solutions.
\n" ); } # Check versions with regards to character sets, cough up an error if there are inconsistencies if( $wgDBmysql5 ) { if( $mysqlNewAuth ) { echo( "
• Enabling mySQL 4.1/5.0 character set mode.
\n" ); } else { echo( "
• mySQL 4.1/5.0 character set mode has been enabled, however, an older version of mySQL has been detected. This will likely cause the installation to fail.
\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 ) ); # Set up the DB user if we (i) can and (ii) need to if( $conf->Root ) { $db = Database::newFromParams( $wgDBserver, $wgDBuser, $wgDBpassword, $wgDBname, 1 ); if( $db->isOpen() ) { $db->close(); } else { print "
• Granting user permissions...
\n"; dbsource( "../maintenance/users.sql", $wgDatabase ); $db->close(); } } 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 ); } ?>