MediaWiki Installation

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
	

• Don't forget security updates! Keep an eye on the low-traffic release announcements mailing list.

Checking environment...

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

PHP " . phpversion() . " installed\n"; if( ini_get( "register_globals" ) ) { ?>
• Warning: PHP's register_globals option is enabled. Disable it if you can.
  MediaWiki will work, but your server is more exposed to PHP-based security vulnerabilities.
• 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 MediaWiki.

  " ); } 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." ); } # Crude check for session support if( !function_exists( 'session_name' ) ) dieout( "PHP's session module is missing. MediaWiki requires session support in order to function." ); $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($sep, getenv("PATH")); $diff3names = array("gdiff3", "diff3", "diff3.exe"); $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 = dirname( dirname( __FILE__ ) ); print "
• Installation directory: " . htmlspecialchars( $conf->IP ) . "
\n"; $conf->ScriptPath = preg_replace( '{^(.*)/config.*$}', '$1', $_SERVER["PHP_SELF"] ); # was SCRIPT_NAME print "
• Script URI path: " . htmlspecialchars( $conf->ScriptPath ) . "
\n"; print "
• Environment checked. You can install MediaWiki.
\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->DBtype = importPost( "DBtype", "mysql" ); $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 ); echo "

Generating configuration file...

\n"; // for debugging: // echo "

" . htmlspecialchars( $local ) . "

\n"; $wgCommandLineMode = false; chdir( ".." ); eval($local); if (!in_array($conf->DBtype, array("mysql", "oracle"))) { $errs["DBtype"] = "Unknown database type."; continue; } print "
• Database type: {$conf->DBtype}
\n"; $dbclass = 'Database'.ucfirst($conf->DBtype); require_once("$dbclass.php"); $wgDBtype = $conf->DBtype; $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"; } $dbc = new $dbclass; if( $conf->DBtype == 'mysql' ) { $ok = true; # Let's be optimistic # Decide if we're going to use the superuser or the regular database user 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; } # Attempt to connect echo( "
• Attempting to connect to database server as $db_user..." ); $wgDatabase = Database::newFromParams( $wgDBserver, $db_user, $db_pass, '', 1 ); # Check the connection and respond to errors if( $wgDatabase->isOpen() ) { # Seems OK $ok = true; $wgDBadminuser = $db_user; $wgDBadminpassword = $db_pass; echo( "success.
\n" ); $wgDatabase->ignoreErrors( true ); $myver = mysql_get_server_info( $wgDatabase->mConn ); } else { # There were errors, report them and back out $ok = false; $errno = mysql_errno(); $errtx = htmlspecialchars( mysql_error() ); switch( $errno ) { case 1045: case 2000: echo( "failed due to authentication errors. Check passwords." ); 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; case 2002: case 2003: default: # General connection problem echo( "failed with error [$errno] $errtx.\n" ); $errs["DBserver"] = "Connection failed"; break; } # switch } #conn. att. if( !$ok ) { continue; } } else /* not mysql */ { print "
• Connecting to SQL server..."; $wgDatabase = $dbc->newFromParams($wgDBserver, $wgDBuser, $wgDBpassword, $wgDBname, 1); if (!$wgDatabase->isOpen()) { print " error: " . $wgDatabase->lastError() . "
\n"; } else { $wgDatabase->ignoreErrors(true); $myver = get_db_version(); } } if ( !$wgDatabase->isOpen() ) { $errs["DBserver"] = "Couldn't connect to database"; continue; } print "
• Connected to $myver"; if( version_compare( $myver, "4.0.14" ) < 0 ) { die( " -- mysql 4.0.14 or later required. Aborting." ); } $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"; if ($conf->DBtype == 'mysql') { @$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 ($conf->DBtype == 'mysql') { if( $wgDBmysql5 ) { print " using MySQL 5 table defs..."; dbsource( "../maintenance/mysql5/tables.sql", $wgDatabase ); } else { print " using MySQL 4 table defs..."; dbsource( "../maintenance/tables.sql", $wgDatabase ); } dbsource( "../maintenance/interwiki.sql", $wgDatabase ); } else { dbsource( "../maintenance/oracle/tables.sql", $wgDatabase ); dbsource( "../maintenance/oracle/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 "regular user" account *if we can, and if we need to* if( $conf->Root ) { # See if we need to $wgDatabase2 = Database::newFromParams( $wgDBserver, $wgDBuser, $wgDBpassword, $wgDBname, 1 ); if( $wgDatabase2->isOpen() ) { # Nope, just close the test connection and continue $wgDatabase2->close(); echo( "
• User $wgDBuser exists. Skipping grants.
" ); } else { # Yes, so run the grants echo( "
• Granting user permissions to $wgDBuser on $wgDBname..." ); dbsource( "../maintenance/users.sql", $wgDatabase ); echo( "success.
" ); } } 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.