Help:Installation: Difference between revisions
Content deleted Content added
replace a redirect by direct link |
|||
| (12 intermediate revisions by 11 users not shown) | |||
| Line 1: | Line 1: | ||
{{MovedToMediaWiki|Manual:Installing MediaWiki}} |
|||
{{H:h|system admin toc}} |
|||
{{moveToMediaWiki}} |
|||
This page '''guides''' you through the process of installation of the latest stable version on '''linux'''. There is another page for installation from [[mw:Subversion|Subversion]]. The 1.6 series is the last to support versions of PHP earlier than PHP 5. |
|||
Imported with full page histories. [[User:Titoxd|Tito]][[:en:User:Titoxd|<font color="#008000">xd</font>]]<sup>([[:en:User talk:Titoxd|?!?]])</sup> 04:08, 4 May 2007 (UTC) |
|||
There are also guides for installing MediaWiki on '''Windows''' and IIS, which is a little harder: |
|||
{{languages}} |
|||
* [[Installing MediaWiki on Windows XP]] -> [[Installing MediaWiki on Windows XP - MediaWiki 1.9.2]] |
|||
* [[Installing MediaWiki on Windows Server 2003 SP1]] |
|||
* see also other guides: [[#External links]] |
|||
MediaWiki can be difficult to install for the average computer user who does not have experience with Apache, PHP and MySql. Most users who wish to use wiki software may benefit from using a free wiki host (see a [http://en.wikibooks.org/wiki/Wiki_Science:How_to_start_a_Wiki#.22Hosted_wiki.22_and_Wiki_hosts list of wiki hosts] on Wikibooks). |
|||
== Preparations == |
|||
== Minimum system requirements == |
|||
The recommended minimum settings is 256MB of RAM for a single-computer website, although this will not suffice for a busy public site. Some users have reported running MediaWiki on computers with as little as 48MB of RAM. |
|||
=== Prerequisites === |
|||
Before you can install '''MediaWiki''', there are four prerequisite components you must install. When you install these, remember to read the associated documentation. If your website is hosted for you then contact the server administrators or hosting company to ensure these are installed. |
|||
# An '''Apache web server''', available at [http://httpd.apache.org/download.cgi the official download page]. |
|||
#* MediaWiki also apparently runs under IIS 6.0, [http://www.0x50.org/ Cherokee] and [http://lighttpd.net lighttpd]. |
|||
#* Sun has some [http://developers.sun.com/prodtech/webserver/reference/techart/mediawiki.html installation instructions] for running Mediawiki on the ''Sun Java System Web Server 7.0''. |
|||
# A recent version of '''PHP''', the programming language in which MediaWiki is written. This is available from the [http://www.php.net/downloads.php official download page]. As of version 1.7 '''PHP 5.x is required''' -- PHP 4.x is not supported from this version onwards. |
|||
#* See [[PHP config]] for compiling options |
|||
#* Some Linux servers may also require the equivalent MySQL package and PHP session management package; see the documentation for the operating system. |
|||
#* When installing on windows using the Microsoft installer, add the extension for your database of choice (MySQLi or PostgresSQL) to the features to be installed. |
|||
#* If your Apache server has the [http://www.hardened-php.net/ Hardened PHP patch], you may need to edit several variables in your /etc/php.ini file if you wish to have Wiki pages with large amounts of content. In particular, consider the settings for varfilter.max_value_length, hphp.post.max_value_length, and hphp.request.max_value_length. The default settings may limit your pages to less than 10k or 64k in size. |
|||
#* Many people report blank pages in recent versions after submitting articles to their new wiki. A likely cause is the memory limit in default php installations (usually 8 MB). Please check your PHP and/or Apache error logs. To modify this setting edit <code>/etc/php.ini</code> and increase the "memory_limit" setting. For example to raise it to 20 MB replace the existing text with "<code>memory_limit = 20M</code>". Make sure to restart your Apache server after you have changed this value. |
|||
# A '''MySQL database server''', which will be used to store all the text and data. This is available from the [http://dev.mysql.com/downloads/ official download page]. |
|||
#* As of version 1.8, [http://www.postgres.org Postgres] is also supported. It should be noted that support for Postgres is very new and not as well tested as the MySQL equivalent. |
|||
# '''MediaWiki itself''', which is available from the [http://www.mediawiki.org/wiki/Download official download page]. Development versions are available from the [http://sourceforge.net/projects/wikipedia/ Sourceforge.net project page]. |
|||
HAHAHA |
|||
== Configuration == |
|||
=== Local settings === |
|||
After setup, a file called '''<tt>LocalSettings.php</tt>''' is created in the "config" directory. This file contains all the information needed by MediaWiki to run. If it does not find the file in the main folder, it will launch the installation script to create a new one in the "config" directory. |
|||
# Move this file to the main wiki directory (if you installed MediaWiki to '''<tt>public_html/wiki</tt>''', move it there). '''Do not leave a copy in the config folder''', as this poses a severe security risk. |
|||
# Set stringent permissions on the '''<tt>LocalSettings.php</tt>''' file. ( chmod 600 and chown <webserver owner> ) |
|||
# '''Delete''' the entire "config" directory. |
|||
=== Advanced configuration === |
|||
For help with more advanced technical configuration, see [[Help:Configuration]] and [[Help:Administration]]. |
|||
For a brief overview that addresses the empty help pages and text and layout modification, see [[Help:Installation-Software_Configuration]]. |
|||
== Uninstallation == |
|||
Removing MediaWiki entirely can be accomplished in two steps: removing the directory where MediaWiki was installed, and dropping the MediaWiki database from MySQL or Postgres. |
|||
For example, if you installed MediaWiki to '''/var/www/mediawiki-xyz''', you might do |
|||
rm -r /var/www/mediawiki-xyz |
|||
===MySQL=== |
|||
To remove the MySQL database holding your wiki, use the '''mysql''' utility to interactively connect to MySQL as a user with adequate permissions, then issue the following command at the '''mysql>''' prompt: |
|||
DROP DATABASE wikidb; |
|||
(If you needed to retain some tables, you could also drop just some of the tables individually. See [http://mail.wikipedia.org/pipermail/mediawiki-l/2005-November/008090.html this MediaWiki-L message] for details.) |
|||
===Postgres=== |
|||
To remove the Postgres database holding your wiki, run the following command: |
|||
dropdb wikidb |
|||
You can also connect as a superuser using the '''psql''' program and issue: |
|||
DROP DATABASE wikidb; |
|||
== See also == |
|||
* [[mw:Help:FAQ#Installation_.26_Configuration|Installation FAQ]] |
|||
* [[Help:Upgrading MediaWiki]] |
|||
* [[MediaWiki architecture]] |
|||
* [[Postgres config]] -- more details on Postgres configuration for MediaWiki |
|||
== External links == |
|||
*Lopez, Daniel ''Sams Teach Yourself Apache 2 in 24 Hours''. Excellent easy to use book, the 3rd chapter, which explains how to install Apache, can be viewed on Amazon.com [http://www.amazon.com/gp/reader/0672323559/ here] ''(must register with Amazon first to view pages)'' |
|||
*An [http://www.mundy.org/xp/ outdated explanation] of how to install, configure, and get Apache 1.3, MySQL 3, PHP 4 running under Windows XP in less than 30 minutes. ('''This document is significantly out of date, having been updated October 5, 2003, but is otherwise well written!''') For example, as of January 1, 2006: |
|||
*# It references Apache 1.3, Apache 2.2 is current. The syntax it suggests for httpd.conf prevents Apache from restarting. |
|||
*# It references PHP 4. PHP 5.1 is current. |
|||
*# It references MySQL 3.23. MySQL 5.x is current. |
|||
* Life Hacker has [http://www.lifehacker.com/software/wikipedia/geek-to-live-set-up-your-personal-wikipedia-163707.php instructions] for installing MediaWiki on Windows XP. |
|||
'''Deploying MediaWiki with Sun Java System Web Server 7.0''' |
|||
* Sun has recently released their latest version of Web Server - [http://www.sun.com/download/products.xml?id=45ad781d Sun Java System Web Server 7.0](formerly known as iPlanet Enterprise Server or Sun ONE Web Server). Here is a technical [http://developers.sun.com/prodtech/webserver/reference/techart/mediawiki.html article] on how to deploy MediaWiki with Sun Java System Web Server 7.0. Feel free to post your queries and concerns that you run into at [http://forum.java.sun.com/forum.jspa?forumID=759 Sun's Web Server Software forum] |
|||
* Also, if you need more help on how to get PHP as such working with [http://www.sun.com/download/products.xml?id=45ad781d Sun Java System Web Server 7.0], then check out this [http://developers.sun.com/prodtech/webserver/reference/techart/php2.html article] which describes the steps involved in configuring and running PHP with Web Server 7.0. |
|||
[[User:Natarajan|Natarajan]] 02:03, 24 January 2007 (UTC) |
|||
* A compact step-by-step guide to configure WAMP + MediaWiki is also [http://oss.segetech.com/wamp.html available]. |
|||
For Windows XP, I think you may want to point users to a site similar to [http://www.apachefriends.org/en/xampp-windows.html XAMPP for Windows]. This appears to cover the basic requirements of Apache, PHP and MySQL. |
|||
'''See also''' : |
|||
* [[Newcomers guide to installing on Windows]] |
|||
* if you prefer IIS 6 try [[Installing MediaWiki on Windows Server 2003 SP1]] |
|||
* if you prefer IIS 5.1 try [[Installing MediaWiki on Windows XP]] |
|||
* if you want step-by-step instruction try [[streamlined Windows Install Guide ]] |
|||
* How to [[upgrade from PHP4 to PHP5 on RedHat Enterprise Linux]] (AS4) |
|||
* [http://blog.eukhost.com/2006/10/11/apache-installation/ Apache Installation] |
|||
{{h:f|langs=|enname=Installation}} |
|||
==Reference== |
|||
<div class='references-small'> |
|||
<references/> |
|||
</div> |
|||
Latest revision as of 09:44, 8 July 2023
|
This page has been moved to Manual:Installing MediaWiki on mediawiki.org.
Any modifications or additions to this page should be made on mediawiki.org instead. |
Imported with full page histories. Titoxd(?!?) 04:08, 4 May 2007 (UTC)