* (bug 7681, 11559) Cookie values no longer override GET and POST variables.
[lhc/web/wiklou.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index f23e85d..1bbdc20 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -4,40 +4,39 @@ Installing MediaWiki
 
 Starting with MediaWiki 1.2.0, it's possible to install
 and configure the wiki "in-place", as long as you have
-the necessary prerequesites available.
-
-In 1.3.0 the old command-line installer has been removed.
-A new command-line installer/upgrader may come soon...
+the necessary prerequisites available.
 
 Required software:
-* Web server with PHP 4.1.2 or higher (4.3.x is preferred)
-* A MySQL server. 4.0.x is preferred, but 3.2.x should
-  work as well.
+* Web server with PHP 5.x or higher.
+* A MySQL server, 4.0.14 or higher OR a Postgres server, 8.1 or higher
 
 MediaWiki is developed and tested mainly on Unix/Linux
 platforms, but should work on Windows as well.
 
 If your PHP is configured as a CGI plug-in rather than
 an Apache module you may experience problems, as this
-configuration is not well tested.
+configuration is not well tested. safe_mode is also not
+tested and unlikely to work. 
+
+If you want math support see the instructions in math/README
 
 Don't forget to check the RELEASE-NOTES file...
 
-********************** WARNING **************************
 
-The web-based install is still somewhat experimental. It
-doesn't yet support updating the format of an existing
-MediaWiki database, the maintenance scripts aren't available,
-and there may be all kinds of horrible bugs or security
-problems that haven't been worked out yet.
+Additional documentation is available online, which may include more
+detailed notes on particular operating systems and workarounds for
+difficult hosting environments:
 
-HOWEVER it is much easier, safer, and more reliable than
-the old install.php, and does not require root access
-if you already have a database and user access to it.
+http://www.mediawiki.org/wiki/Manual:Installation
+
+
+********************** WARNING **************************
 
 REMEMBER: ALWAYS BACK UP YOUR DATABASE BEFORE ATTEMPTING
 TO INSTALL OR UPGRADE!!!
 
+********************** WARNING **************************
+
 ----
 In-place web install
 ----
@@ -47,6 +46,15 @@ your server, or on your local machine and upload the
 directory tree. Rename it from "mediawiki-1.x.x" to
 something nice, like "wiki", since it'll be in your URL.
 
+  +-----------------------------------------------------------+
+  |  Hint: If you plan to use a fancy URL-rewriting scheme    |
+  |  to prettify your URLs, you should put the files in a     |
+  |  *different* directory from the virtual path where page   |
+  |  names will appear.                                       |
+  |                                                           |
+  |    See: http://www.mediawiki.org/wiki/Manual:Short_URL    |
+  +-----------------------------------------------------------+
+
 To run the install script, you'll need to temporarily make
 the 'config' subdirectory writable by the web server. The
 simplest way to do this on a Unix/Linux system is to make
@@ -65,6 +73,16 @@ should now be a 'LocalSettings.php' in the config directory;
 move it back up to the main wiki directory, and the wiki
 should now be working.
 
+  +------------------------------------------------------------+
+  |  Security hint: if you have limited access on your server  |
+  |  and cannot change ownership of files, you might want to   |
+  |  *copy* instead of *move* LocalSettings.php.               |
+  |                                                            |
+  |  This will make the file owned by your user account        |
+  |  instead of by the web server, which is safer in case      |
+  |  another user's account is compromised.                    |
+  +------------------------------------------------------------+
+
 Once the wiki is set up, you should remove the config
 directory, or at least make it not world-writable (though
 it will refuse to config again if the wiki is set up).
@@ -80,7 +98,9 @@ provide enough information to work with, and preferably be aware
 of what you're doing!) and keep track of major changes to the
 software, including performance improvements and security patches.
 
-http://mail.wikipedia.org/mailman/listinfo/mediawiki-l (site admin support)
+http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce (low traffic)
+
+http://lists.wikimedia.org/mailman/listinfo/mediawiki-l (site admin support)
 
-http://mail.wikipedia.org/mailman/listinfo/wikitech-l (development)
+http://lists.wikimedia.org/mailman/listinfo/wikitech-l (development)