-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 prerequesites 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.
+In 1.3.0 the old command-line installer has been removed.
+A new command-line installer/upgrader may come soon...
- You'll need to compile the texvc helper script; enter the math
- subdirectory of the source tree and run "make".
+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.
- If you don't want embedded TeX support, disable it by setting
+MediaWiki is developed and tested mainly on Unix/Linux
+platforms, but should work on Windows as well.
- $wgUseTex = false;
+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.
- in LocalSettings.php
+If you want math support see the instructions in math/README
-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.
+Don't forget to check the RELEASE-NOTES file...
-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.
+********************** WARNING **************************
+
+REMEMBER: ALWAYS BACK UP YOUR DATABASE BEFORE ATTEMPTING
+TO INSTALL OR UPGRADE!!!
+
+********************** 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
+something nice, like "wiki", since it'll be in your 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! :)
-Don't forget that this is pre-release software under development!
+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.
+
+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
-Wikipedia developers' mailing list; you can ask for help (please
+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://www.wikipedia.org/mailman/listinfo/wikitech-l
+http://mail.wikipedia.org/mailman/listinfo/mediawiki-l (site admin support)
+
+http://mail.wikipedia.org/mailman/listinfo/wikitech-l (development)
dépôts / lhc / web / wiklou.git / blobdiff