summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL109
1 files changed, 51 insertions, 58 deletions
diff --git a/INSTALL b/INSTALL
index 1bbdc201..e5bf0c11 100644
--- a/INSTALL
+++ b/INSTALL
@@ -2,101 +2,94 @@
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 prerequisites available.
+Starting with MediaWiki 1.2.0, it's possible to install and configure the wiki
+"in-place", as long as you have the necessary prerequisites available.
Required software:
* 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.
+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. safe_mode is also not
-tested and unlikely to work.
+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. 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...
-Additional documentation is available online, which may include more
-detailed notes on particular operating systems and workarounds for
-difficult hosting environments:
+Additional documentation is available online, which may include more detailed
+notes on particular operating systems and workarounds for difficult hosting
+environments:
-http://www.mediawiki.org/wiki/Manual:Installation
+http://www.mediawiki.org/wiki/Manual:Installation_guide
-********************** WARNING **************************
+******************* WARNING *******************
-REMEMBER: ALWAYS BACK UP YOUR DATABASE BEFORE ATTEMPTING
-TO INSTALL OR UPGRADE!!!
+REMEMBER: ALWAYS BACK UP YOUR DATABASE BEFORE
+ATTEMPTING TO INSTALL OR UPGRADE!!!
-********************** WARNING **************************
+******************* WARNING *******************
----
In-place web install
----
-Decompress the MediaWiki installation archive either on
-your server, or on your local machine and upload the
-directory tree. Rename it from "mediawiki-1.x.x" to
+Decompress the MediaWiki installation archive either on 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 |
- +-----------------------------------------------------------+
+ +--------------------------------------------------------------------------+
+ | 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
-it world-writable:
+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 it world-writable:
chmod a+w config
-Hop into your browser and surf into the wiki directory.
-It'll direct you into the config script. Fill out the form...
-remember you're probably not on an encrypted connection.
+Hop into your browser and surf into the wiki directory. It'll direct you into
+the config script. Fill out the form... remember you're probably not on an
+encrypted connection.
Gaaah! :)
-If all goes well, you should soon be told that it's set up
-your wiki database and written a configuration file. There
-should now be a 'LocalSettings.php' in the config directory;
-move it back up to the main wiki directory, and the wiki
+If all goes well, you should soon be told that it's set up your wiki database
+and written a configuration file. There 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. |
- +------------------------------------------------------------+
+ +-------------------------------------------------------------------------+
+ | 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).
+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).
----
-Don't forget that this is free software under development!
-Chances are good there's a crucial step that hasn't made it
-into the documentation. You should probably sign up for the
-MediaWiki developers' mailing list; you can ask for help (please
-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.
+Don't forget that this is free software under development! Chances are good
+there's a crucial step that hasn't made it into the documentation. You should
+probably sign up for the MediaWiki developers' mailing list; you can ask for
+help (please 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://lists.wikimedia.org/mailman/listinfo/mediawiki-announce (low traffic)