X-Git-Url: http://git.heureux-cyclage.org/?a=blobdiff_plain;f=INSTALL;h=c4bb8be987f486a0b14bc272125ed4a449131311;hb=328739710ad90bb39121000efc64b03f52b27c0c;hp=f4d5e2d998f34b7064d3dd18da7966033b7c5ea4;hpb=d82c14fb4fbac288b42ca5918b0a72f33ecb1e69;p=lhc%2Fweb%2Fwiklou.git diff --git a/INSTALL b/INSTALL index f4d5e2d998..c4bb8be987 100644 --- a/INSTALL +++ b/INSTALL @@ -1,159 +1,85 @@ -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: - - - AddType application/x-httpd-php .php .php4 .phtml - AddType application/x-httpd-php-source .phps - - - php_admin_flag engine off - - - - php_admin_flag engine on - - - 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.3.2 or higher. +* A SQL server, the following types are supported +** MySQL 5.0.2 or higher +** PostgreSQL 8.3 or higher +** SQLite 3.3.7 or higher +** Oracle 9.0.1 or higher - 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 +---- + +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 | + +--------------------------------------------------------------------------+ + +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 generated a configuration file. There is now a copy of "LocalSettings.php" +available to download from the installer. Download this now, there is not a +way (yet) to get it after you exit the installer. Place it in the main wiki +directory, and the wiki should now be working. + +Once the wiki is set up, you should remove the mw-config directory (though it will +refuse to config again if the wiki is set up). ---- -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. +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://www.wikipedia.org/mailman/listinfo/wikitech-l +http://lists.wikimedia.org/mailman/listinfo/mediawiki-l (site admin support) +http://lists.wikimedia.org/mailman/listinfo/wikitech-l (development)