MediaWiki Installation

Setup has completed, your wiki is configured.

Please delete the /config directory for extra security.

" ); } if( file_exists( "./LocalSettings.php" ) ) { writeSuccessMessage(); dieout( '' ); } if( !is_writable( "." ) ) { dieout( "

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

Afterwards retry to start the setup.

" ); } require_once( "$IP/install-utils.inc" ); require_once( "$IP/maintenance/updaters.inc" ); class ConfigData { function getEncoded( $data ) { # removing latin1 support, no need... return $data; } function getSitename() { return $this->getEncoded( $this->Sitename ); } function getSysopName() { return $this->getEncoded( $this->SysopName ); } function getSysopPass() { return $this->getEncoded( $this->SysopPass ); } function setSchema( $schema, $engine ) { $this->DBschema = $schema; if ( !preg_match( '/^\w*$/', $engine ) ){ $engine = 'InnoDB'; } switch ( $this->DBschema ) { case 'mysql5': $this->DBTableOptions = "ENGINE=$engine, DEFAULT CHARSET=utf8"; $this->DBmysql5 = 'true'; break; case 'mysql5-binary': $this->DBTableOptions = "ENGINE=$engine, DEFAULT CHARSET=binary"; $this->DBmysql5 = 'true'; break; default: $this->DBTableOptions = "TYPE=$engine"; $this->DBmysql5 = 'false'; } $this->DBengine = $engine; # Set the global for use during install global $wgDBTableOptions; $wgDBTableOptions = $this->DBTableOptions; } } ?>

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.

For $full, compile PHP using --with-$comp, " ."or install the $comp.so module

Found database drivers for:"; $DefaultDBtype = ''; foreach (array_keys($ourdb) AS $db) { if ($ourdb[$db]['havedriver']) { if ( $DefaultDBtype == '' ) { $DefaultDBtype = $db; } print " ".$ourdb[$db]['fullname']; } } print "
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.
Fatal: zend.ze1_compatibility_mode is active! This option causes horrible bugs with MediaWiki; you cannot install or use MediaWiki unless this option is disabled.
Warning: PHP's safe mode is active. You may have problems caused by this, particularly if using image uploads.
PHP server API is $sapi; "; $script = defined('MW_INSTALL_PHP5_EXT') ? 'index.php5' : 'index.php'; if( $wgUsePathInfo ) { print "ok, using pretty URLs ($script/Page_Title)"; } else { print "using ugly URLs ($script?title=Page_Title)"; } print "
Have XML / Latin1-UTF-8 conversion support.
Warning: A value for session.save_path has not been set in PHP.ini. If the default value causes problems with saving session data, set it to a valid path which is read/write/execute for the user your web server is running under.
Session save path ({$ssp}) appears to be valid.
Warning: Your session.save_path value ({$ssp}) appears to be invalid or is not writable. PHP needs to be able to save data to this location for correct session operation.
PHP is configured with no memory_limit.
PHP's memory_limit is " . htmlspecialchars( $memlimit ) . ". "; $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.
" . htmlspecialchars( $memlimit ) . " seems too low, installation may fail!"; } else { $conf->raiseMemory = true; print "ok."; } } print "
Turck MMCache installed
XCache installed
APC installed
eAccelerator installed
Couldn\'t find Turck MMCache, eAccelerator, APC or XCache; cannot use these for object caching.
Found GNU diff3: $conf->diff3.
GNU diff3 not found.
Found ImageMagick: $im; image thumbnailing will be enabled if you enable uploads.
Found GD graphics library built-in"; if( !$conf->ImageMagick ) { print ", image thumbnailing will be enabled if you enable uploads"; } print ".
Couldn't find GD library or ImageMagick; image thumbnailing disabled.
Installation directory: " . htmlspecialchars( $conf->IP ) . "
Script URI path: " . htmlspecialchars( $conf->ScriptPath ) . "
Installing MediaWiki with php5 file extensions
Installing MediaWiki with php file extensions
Environment checked. You can install MediaWiki.
\n"; echo "
Generating configuration file...
\n"; echo "

Errors in generated configuration; " . "most likely due to a bug in the installer... " . "Config file was:

" .
				htmlspecialchars( $local ) .
				"

Database type: {$conf->DBtypename}
Loading class: $dbclass
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.
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.
Attempting to connect to database \"postgres\" as superuser \"$wgDBsuperuser\"..." ); $wgDatabase = $dbc->newFromParams($wgDBserver, $wgDBsuperuser, $conf->RootPW, "postgres", 1); if (!$wgDatabase->isOpen()) { print " error: " . $wgDatabase->lastError() . "
Attempting to connect to database \"$wgDBname\" as \"$wgDBuser\"..." ); $wgDatabase = $dbc->newFromParams($wgDBserver, $wgDBuser, $wgDBpassword, $wgDBname, 1); if (!$wgDatabase->isOpen()) { print " error: " . $wgDatabase->lastError() . "
Connected to $myver"; if ($conf->DBtype == 'mysql') { if( version_compare( $myver, "4.0.14" ) < 0 ) { 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.

MySQL 4.1/5.0 charset mode enabled, but older version detected; will likely fail.

Database " . htmlspecialchars( $wgDBname ) . " exists

{$databaseSafe} is not a valid database name.

Error selecting database {$databaseSafe}: {$err} "; print htmlspecialchars( mysql_error() ) . "

Attempting to create database...
Couldn't create database " . htmlspecialchars( $wgDBname ) . "; try with root access or check your username/pass.
Created database " . htmlspecialchars( $wgDBname ) . "

Postgres 8.0 or later is required

There are already MediaWiki tables in this database. Checking if updates are needed...
SHOW TABLE STATUS query failed!
Warning: Unrecognised existing collation
Warning: you requested the {$conf->DBschema} schema, " . "but the existing database has the $existingSchema schema. This upgrade script ". "can't convert it, so it will remain $existingSchema.
Warning: you requested the {$conf->DBengine} storage " . "engine, but the existing database uses the $existingEngine engine. This upgrade " . "script can't convert it, so it will remain $existingEngine.
DB user account ok
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";
			chdir( ".." );
			flush();
			do_all_updates();
			chdir( "config" );
			print "

\n"; print "

Finished update checks.
Warning: {$conf->DBengine} storage engine not available, " . "using MyISAM instead
Creating tables..."; if ($conf->DBtype == 'mysql') { dbsource( "../maintenance/tables.sql", $wgDatabase ); dbsource( "../maintenance/interwiki.sql", $wgDatabase ); } elseif (is_callable(array($wgDatabase, 'setup_database'))) { $wgDatabase->setup_database(); } else { $errs["DBtype"] = "Do not know how to handle database type '$conf->DBtype'"; continue; } print " done.
Initializing statistics...
User $wgDBuser exists. Skipping grants.
Granting user permissions to $wgDBuser on $wgDBname..." ); dbsource( "../maintenance/users.sql", $wgDatabase ); echo( "success.
Warning: Skipped sysop account creation - invalid username!
Created sysop account " . htmlspecialchars( $conf->SysopName ) . ".
Could not create user - already exists!
Skipped sysop account creation, no name given.
\n"; print "
Creating LocalSettings.php...
\n\n"; $localSettings = "<" . "?php$endl$local"; // Fix up a common line-ending problem (due to CVS on Windows) $localSettings = str_replace( "\r\n", "\n", $localSettings ); $f = fopen( "LocalSettings.php", 'xt' ); if( $f == false ) { print( "

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...

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

\n" . htmlspecialchars( $localSettings ) . "

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

\n"; $mainListOpened = false; if( count( $errs ) ) { /* Display options form */ if( $conf->posted ) { echo "

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

\n"; } ?>

Site config

Preferably a short word without punctuation, i.e. "Wikipedia".
Will appear as the namespace name for "meta" pages, and throughout the interface.

Displayed to users in some error messages, used as the return address for password reminders, and used as the default sender address of e-mail notifications.

Language:

Select the language for your wiki's interface. Some localizations aren't fully complete. Unicode (UTF-8) is used for all localizations.

ScriptPath}/config/$script?License=cc&RightsUrl=[license_url]&RightsText=[license_name]&RightsCode=[license_code]&RightsIcon=[license_button]" ); $icon = urlencode( "$wgServer$wgUploadPath/wiki.png" ); $ccApp = htmlspecialchars( "http://creativecommons.org/license/?partner=$partner&exit_url=$exit&partner_icon_url=$icon" ); print "choose"; if( $conf->License == "cc" ) { ?>
- RightsIcon ) . "\" alt='(Creative Commons icon)' />", "hidden" ); ?>
- RightsText ), "hidden" ); ?>
- RightsCode ), "hidden" ); ?>
- RightsUrl ) . "\">" . htmlspecialchars( $conf->RightsUrl ) . "", "hidden" ); ?>

A notice, icon, and machine-readable copyright metadata will be displayed for the license you pick.

An admin can lock/delete pages, block users from editing, and do other maintenance tasks.
A new account will be added only when creating a new wiki database.

The password cannot be the same as the username.

Object caching:

"; aField( $conf, "Shm", "Turck MMCache", "radio", "turck" ); echo "
"; aField( $conf, 'Shm', 'XCache', 'radio', 'xcache' ); echo "
"; aField( $conf, "Shm", "APC", "radio", "apc" ); echo "
"; aField( $conf, "Shm", "eAccelerator", "radio", "eaccel" ); echo "
"; aField( $conf, "Shm", "DBA (not recommended)", "radio", "dba" ); echo "

An object caching system such as memcached will provide a significant performance boost, but needs to be installed. Provide the server addresses and ports in a comma-separated list.

MediaWiki can also detect and support eAccelerator, Turck MMCache, APC, and XCache, but these should not be used if the wiki will be running on multiple application servers.

DBA (Berkeley-style DB) is generally slower than using no cache at all, and is only recommended for testing.

E-mail, e-mail notification and authentication setup

E-mail features (global):

Use this to disable all e-mail functions (password reminders, user-to-user e-mail, and e-mail notifications) if sending mail doesn't work on your server.

User-to-user e-mail:

The user-to-user e-mail feature (Special:Emailuser) lets the wiki act as a relay to allow users to exchange e-mail without publicly advertising their e-mail address.

E-mail notification about changes:

For this feature to work, an e-mail address must be present for the user account, and the notification options in the user's preferences must be enabled. Also note the authentication option below. When testing the feature, keep in mind that your own changes will never trigger notifications to be sent to yourself.

There are additional options for fine tuning in /includes/DefaultSettings.php; copy these to your LocalSettings.php and edit them there to change them.

E-mail address authentication:

If this option is enabled, users have to confirm their e-mail address using a magic link sent to them whenever they set or change it, and only authenticated e-mail addresses can receive mails from other users and/or change notification mails. Setting this option is recommended for public wikis because of potential abuse of the e-mail features above.

Database config

Database type: $errs[DBpicktype]\n"; ?>

If your database server isn't on your web server, enter the name or IP address here.

If you only have a single user account and database available, enter those here. If you have database root access (see below) you can specify new accounts/databases to be created. This account will not be created if it pre-exists. If this is the case, ensure that it has SELECT, INSERT, UPDATE, and DELETE permissions on the MediaWiki database.

Superuser account: checked="checked" /> Use superuser account

If the database user specified above does not exist, or does not have access to create the database (if needed) or tables within it, please check the box and provide details of a superuser account, such as root, which does.

If you need to share one database between multiple wikis, or between MediaWiki and another web application, you may choose to add a prefix to all the table names to avoid conflicts.

Avoid exotic characters; something like mw_ is good.

Storage Engine

Select one:

InnoDB is best for public web installations, since it has good concurrency support. MyISAM may be faster in single-user installations. MyISAM databases tend to get corrupted more often than InnoDB databases.

Database character set

Select one:

This option is ignored on upgrade, the same character set will be kept.

WARNING: If you use backwards-compatible UTF-8 on MySQL 4.1+, and subsequently back up the database with mysqldump, it may destroy all non-ASCII characters, irreversibly corrupting your backups!.

In binary mode, MediaWiki stores UTF-8 text to the database in binary fields. This is more efficient than MySQL's UTF-8 mode, and allows you to use the full range of Unicode characters. In UTF-8 mode, MySQL will know what character set your data is in, and can present and convert it appropriately, but it won't let you store characters above the Basic Multilingual Plane.

The username specified above (at "DB username") will have its search path set to the above schemas, so it is recommended that you create a new user. The above schemas are generally correct: only change them if you are sure you need to.

NOTE: SQLite only uses the Database name setting above, the user, password and root settings are ignored.

SQLite stores table data into files in the filesystem. If you do not provide an explicit path, a "data" directory in the parent of your document root will be used.

This directory must exist and be writable by the web server.

If you need to share one database between multiple wikis, or between MediaWiki and another web application, you may choose to add a prefix to all the table names to avoid conflicts.

Avoid exotic characters; something like mw_ is good.

Installation successful!

To complete the installation, please do the following:

Download config/LocalSettings.php with your FTP client or file manager
Upload it to the parent directory
Delete config/LocalSettings.php
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.

EOT; } else { echo <<

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

You should change file permissions for LocalSettings.php as required to prevent other users on the server reading passwords and altering configuration data.