-The Wikipedia software was developed collabortively by
-many people, so it's something of a hodgepodge. The
-main wiki software itself is written in PHP, and requires
-the Apache web server and MySQL database. The optional
-math rendering functions are written in Objective CAML,
-which is required to compile them. The test suite is
-written in Java, using several external libraries.
-
-Recommended versions are: Apache 1.3.26 or later; MySQL
-2.23.51 or later; PHP 4.2.2 or later. The installation at
-wikipedia.org also uses the APC caching software, but
-that's entirely optional and doesn't affect anything else.
-
-The math rendering functions are more complex, and will
-probably only work on Linux. Objective CAML (probably
-3.06 or later) is required to compile texvc, but produces
-static binaries. TeTeX and ImageMagick are required at
-runtime, and ImageMagick requires GhostScript. These are
-present in most Linux distributions.
-
-Before installing the software, you must copy the file
-"LocalSettings.sample" to "LocalSettings.php", and
-"AdminSettings.sample" to "AdminSettings.php", and
-customize both of the php files to your local setup
-(things like installation parh, passwords, etc.) The
-script install.php in the maintenance directory can then
-be run to install the software.
-
-Here are some more notes on building a system from scratch
-the way it was done for the Wikipedia server:
-
-Downloads:
-
- gcc-2.95.3.tar.gz
- mysql-3.23.51.tar.gz
- libiconv-1.8.tar.gz
- apache_1.3.26.tar.gz
- php-4.2.1.tar.gz
- apc-cvs.tar.gz
-
-And for math support:
- ocaml-3.06.tar.gz
- (TeTeX, ImageMagick, and GhostScript come with most Linux distros)
-
-1. MySQL strongly recommends using gcc 2.95 to compile MySQL.
- RedHat Linux comes with 2.96 by default, so you'll have to install
- 2.95 first. Use "../gcc*/configure --enable-shared" If your Linux
- installation doesn't use gcc 2.96 you can skip this step.
-
-2. Install MySQL source; add "mysql" user and group. Make sure the
- directory into which you installed gcc 2.95 appears before the
- directory of gcc 2.96 in your path. Configure with:
-
- FLAGS="-O3 -mpentiumpro" CXX=gcc CXXFLAGS="-O3 -mpentiumpro -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --enable-assembler --with-mysqld-ldflags=-all-static --disable-shared --with-extra-charset=complex
-
- Edit the file myisam/ftdefs.h, changing the define for minimum word
- length for fulltext indexing: #define MIN_WORD_LEN 2. Update
- $wgDBminWordLen in LocalSettings.php to reflect this. Build and
- install according to instructions. Make root user as recommended;
- the root password will be required for the wiki installation script.
-
-3. Unpack the phase3.zip source distribution, or check out the "phase3"
- module from CVS. Copy LocalSettings.sample to LocalSettings.php,
- AdminSettings.sample to AdminSettings.php, and customize them for
- things like local paths and passwords. If desired, update
- FulltextStoplist.php from the MySQL sources if you have customized
- MySQL's stop list.
-
-4. Optionally, install libiconv (http://www.gnu.org/software/libiconv/).
- This will be used by some language packages for converting
- native-charset URLs to and from UTF-8. If you're running an
- English-only wiki, this won't be necessary.
-
-5. Unpack Apache distribution and begin configuring, but don't finish
- build yet. Configure with something like:
-
- OPTIM='-O2 -mpentiumpro' ./configure --with-layout=Apache
-
-6. If you'll want to use Apache's mod_rewrite to make page-viewing URLs
- look like static links (as wikipedia.org does), install the included
- patch "apache-ampersand.diff" which is needed to support page titles
- with ampersands in them:
-
- patch -p0 < /path/to/maintenance/apache-ampersand.diff
-
-7. Unpack and configure PHP. Configure with something like:
-
- ./configure --enable-apc --with-mysql=/usr/local/mysql --with-iconv=/usr/local/lib --with-apache=/home/lee/src/apache_1.3.26
-
- (using your own local paths, of course). Build and install as
- instructed. Set "register_globals" on in the config file.
-
-8. Finish building Apache. Configure with something like:
-
- OPTIM='-O2 -mpentiumpro' ./configure --with-layout=Apache --enable-module=rewrite --activate-module=src/modules/php4/libphp4.a
-
- Update httpd.conf as needed for your site. For example:
-
- <IfModule mod_php4.c>
- AddType application/x-httpd-php .php .php4 .phtml
- AddType application/x-httpd-php-source .phps
- </IfModule>
- <IfModule mod_php4.c>
- php_admin_flag engine off
- </IfModule>
- <Directory "DIRECTORY_OF_WIKI_SCRIPTS">
- <IfModule mod_php4.c>
- php_admin_flag engine on
- </IfModule>
- </Directory>
- RewriteEngine On
- RewriteMap ampescape int:ampescape
- RewriteRule ^/wiki/(.*)$ /wiki.phtml?title=${ampescape:$1} [L]
-
- It is *seriously* recommended that you configure the webserver
- to disable running of PHP scripts except in the script directories
- (the "php_admin_flag engine off/on" directives above) to prevent
- the uploading and running of malicious scripts.
+---
+Installing MediaWiki
+---
-9. Optionally, install APC, following standard instructions for
- installing as a Zend extension.
+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.
-10. If using embedded TeX support, be sure TeX and ImageMagick are
- installed (they are common on most Linux distros and freely
- downloadable). Also get and install OCaml according to its
- instructions.
+Required software:
+* Web server with PHP 5.1.x or higher.
+* A SQL server, the following types are supported
+** MySQL 4.0.14 or higher
+** PostgreSQL 8.1 or higher
+** SQLite
- You'll need to compile the texvc helper script; enter the math
- subdirectory of the source tree and run "make".
+MediaWiki is developed and tested mainly on Unix/Linux platforms, but should
+work on Windows as well.
- If you don't want embedded TeX support, disable it by setting
+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.
- $wgUseTex = false;
+If you want math support see the instructions in math/README
- in LocalSettings.php
+Don't forget to check the RELEASE-NOTES file...
-11. You should now be able to run the install.php script. Use PHP in
- command-line mode, i.e., type "php install.php". Should be run as
- root, or as a user or group able to create files and directories
- in the installation tree.
-12. If you have Java installed and running, install the "ant" package
- from Apache (http://ant.apache.org/) and run ant in the testsuite
- directory to build the tests. Copy wikitest.prefs.sample to
- wikitest.prefs, and edit to reflect your local settings. Then
- "./run WikiSuite -o -b" will run the whole test suite and report.
+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_guide
+
+
+******************* WARNING *******************
+
+REMEMBER: ALWAYS BACK UP YOUR DATABASE BEFORE
+ATTEMPTING TO INSTALL OR UPGRADE!!!
+
+******************* WARNING *******************
+
+----
+In-place web install
----
-Don't forget that this is pre-release 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
-Wikipedia 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.
+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 |
+ +--------------------------------------------------------------------------+
+
+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.
+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
+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).
+
+
+----
+
+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)
+
+http://lists.wikimedia.org/mailman/listinfo/mediawiki-l (site admin support)
-http://www.wikipedia.org/mailman/listinfo/wikitech-l
+http://lists.wikimedia.org/mailman/listinfo/wikitech-l (development)
dépôts / lhc / web / wiklou.git / blobdiff