Manual:Running MediaWiki on Debian GNU/Linux

From MediaWiki.org

The content of this page has not been verified. Instructions written in this page have not been verified to be correct. If there are any inaccuracies, please drop a note at the support desk.

This page was recently moved from MetaWiki. The page probably requires cleanup - please feel free to help out. Remove this template once that is done.

This page describes how to install MediaWiki on Debian using the latest official MediaWiki code.

Quick install mediawiki version 1.11.0

You will need a working version of MySQL or PostgreSQL previously installed.

1. aptitude install mediawiki php5 apache2 mediawiki-extensions
2. ln -s /var/lib/mediawiki /var/www/mediawiki

$ firefox localhost/mediawiki/config/index.php

Edit Local Settings to change $wgLogo

1. vi /etc/mediawiki/LocalSettings.php

[edit] Using the Debian packages

MediaWiki is now in Debian's main archive. The main packages are mediawiki (which provides the latest packaged version of mediawiki) and mediawiki1.7 (which provides mediawiki version1 1.7). This guide is mainly concerned with an installation without those packages. Debian is a stable and secure linux distributions because of the package system. Using it you will allow you to receive upgrades and security fixes. It is easy to learn and will give you years of safe and trouble free use.

To install MediaWiki using Debian's packages, just type as root:

# aptitude install mediawiki1.7

You may also want to install the package mediawiki-extensions:

# aptitude install mediawiki-extensions

For further information on using the Debian packages, see the section Installation with Debian-package below.

[edit] Core Packages

Make sure apt's package index files are synchronized, then install Apache:

aptitude update
aptitude install apache2

[edit] Configure Apache

Debian will automatically create a symlink at /etc/apache2/conf.d/mediawiki1.7.conf pointing to /etc/mediawiki1.7/apache.conf. This takes care of most of the Apache setup.

If you want to have MediaWiki run on a virtual host, you'll want to remove the link in conf.d and add a file in the /etc/apache2/sites_available directory. See the Debian documentation for more information.

Also be aware that if you have PHP configured in anything like a safe mode such that open_basedir is very restrictive then you'll need to add, in an appropriate place such as a <Location /mediawiki> section, something like:

php_admin_value open_basedir ".:/var/lib/mediawiki1.7:/usr/share/mediawiki1.7:/etc/mediawiki1.7"

[edit] Configure MySQL

If you do not have mysql installed (you can check it by typing mysql+Enter in command line) install it with command:

 aptitude install mysql-server

You may need to start the mysqld first, as root

 update-rc.d -f mysql remove
 update-rc.d mysql defaults
 /etc/init.d/mysql start

Most of all you need to apply mysql root password. Remember not to use same password for system root and MySQL root

mysqladmin -u root password 'xxxx'

Warning: Setting the root password with the above command would allow somebody with access to your terminal to retrieve it by issuing:

history

...which may be cleared using...

history -c

Another way to set the password would be to log into MySQL:

mysql -u root

Once logged into the MySQL client, issue:

SET PASSWORD FOR 'root'@'localhost' = PASSWORD('newpwd');
exit

Once the root password is set, check if the password works:

mysql -u root

If you see:

ERROR 1045: Access denied for user: 'root@localhost' (Using password: NO)

Then MySQL root account is now password protected.

[edit] Configure PHP

Make sure your PHP configuration file (/etc/php4/apache/php.ini or /etc/php4/apache2/php.ini or the equivalent line if you have PHP5 which the MediaWiki 1.7 installation will have) has this line:

memory_limit = 20M

and the following lines uncommented:

extension=mysql.so
extension=gd.so

restart Apache / Apache2

apachectl restart  OR  apachectl graceful

apache2ctl restart  OR  apache2ctl graceful

[edit] Get latest MediaWiki

Get the latest MediaWiki from Download page example:

wget http://download.wikimedia.org/mediawiki/1.11/mediawiki-1.11.0.tar.gz

as now 1/2008 version 1.7 is ok Manual:Security#Stay up to date

Copy it and extract in apache root directory:

sudo cp mediawiki-1.11.0.tar.gz /var/www
cd /var/www
sudo tar vxfz mediawiki-1.11.0.tar.gz

rename the extracted directory name to wiki

sudo mv mediawiki-1.11.0 wiki

In order to configure the wiki you have to make the config subdirectory writable by the web server.

To make the directory writable on a Unix/Linux system:

cd /var/www/wiki
sudo chmod a+w config

Navigate your browser to http://localhost/wiki and continue with installation.

Pay good attention for "Checking environment..." in MediaWiki installation script. This can solve a lot of problems for your MediaWiki successful installation. Fill out the configuration form and continue.

Once configuration is done you'll need to move the created LocalSettings.php to the parent directory.

cd /var/www/wiki/config/
chmod 640 LocalSettings.php
mv LocalSettings.php ..

For added safety you can then remove the config subdirectory entirely.

rmdir config

And navigate your browser to http://localhost/wiki to see your new wiki. Done!

If you want to setup a master Source of wiki, and multi-slave for different wiki sites. You can ...

get a auto. generate wiki slave script from create_slave_wiki

run the wiki init. install on web, then create the LocalSettings.php.

create a user, then change him/her to sysop.

[edit] Installation with Debian-package

Note: this description is still referring to the older mediawiki1.5.

I just got it all working. What I did was to install a Debian-package with mediawiki1.5. After installation I pointed my browser to: http://localhost/mediawiki/setup and filled in the form there. After that I moved my LocalSettings.php from the folder where it was, to the suggested folder. I did a chmod 444 on all files in that folder. After that i did a "chmod 700 on the folder /etc/mediawiki1.5". Now I clicked on the URL in the installation results, and whamo, there it was, my wiki :) Did this twice on two different Debian installs today, so the procedure should work.

Warning: The Ubuntu packages are several versions behind. As of 02:41, 13 October 2006 (UTC), it was on version 1.4.12.

--- update for mediawiki1.7

Did the install of the Mediawiki 1.7 on Debian Etch (apache2, mysql, php5) by "aptitude install mediawiki" and everything works right on without a glitch. Way to go Debian!

[edit] TeX Support

You need these packages installed:

• ocaml
• imagemagick
• gs
• cjk-latex (now called latex-cjk-all)
• tetex-extra
• php4-imagick
• binutils ("/usr/bin/as" is needed by make job)
• gcc

aptitude install ocaml imagemagick gs cjk-latex tetex-extra php4-imagick binutils gcc

or you can just use the mediawiki-math package. There is all packages needed include its.:

aptitude install mediawiki-math

After installation, enable inline LaTeX equations by uncommenting:

$wgUseTeX           = true;

in LocalSettings.php file.(by default in /etc/mediawiki)

It is not necessary to make texvc if you install the mediawiki-math package. However, /var/www/wiki/math/README does not specify what permissions are necessary for the math directory. I get this error under Ubuntu Breezy after installing the mediawiki-math package. Failed to parse (Can't write to or create math output directory):

If you get the above error, make sure that the '$wgUploadPath' and '$wgUploadDirectory' in LocalSettings.php point to an existing directory which is writable by the webserver. For the mediawiki1.5 1.5.8-1 package, you may have to edit LocalSettings.php to change the directory name from 'images' to 'upload' (check your /var/lib/mediawiki1.5 directory for this).

Make sure your php.ini contains the following row: extension=imagick.so Next compile texvc in your math directory: cd /var/www/wiki/math make You may have to manually create the directories for math temp and output directories: cd /var/www/wiki/images mkdir -m777 math tmp

[edit] Ocaml-fix

NOTE: This problem is only about missing gcc.

(Added 18/05/05)
Using make I got some errors using Debian stable (Sarge) (unfortunately they are not in my console any more, so i cant show them) but installing additional packages worked. The Error Messages are similar to those (reproduced on ubuntu) :

ocamlopt -c util.ml
ocamlc -c render_info.mli
ocamlc -c tex.mli
ocamlyacc parser.mly
ocamlc -c parser.mli
ocamlopt -c parser.ml
ocamlc -c html.mli
ocamlopt -c html.ml
ocamlc -c mathml.mli
ocamlopt -c mathml.ml
ocamlc -c texutil.mli
ocamlopt -c texutil.ml
ocamlopt -c render.ml
ocamllex lexer.mll
188 states, 3222 transitions, table size 14016 bytes
ocamlopt -c lexer.ml
ocamlopt -c texvc.ml
ocamlopt -o texvc unix.cmxa util.cmx parser.cmx html.cmx mathml.cmx texutil.cmx render.cmx lexer.cmx texvc.cmx
sh: gcc: command not found
Error during linking
make: *** [texvc] Error 2
rm parser.ml lexer.ml

In order to fix the problems do the following install:

aptitude install ocaml-core gcc

NOTE: If you have run ocaml -i thinking this would help (as I did) the script may have removed some files. If you can, copy the contents of a backup /images/math directory to your new one after having deleted the old files and run make again.

Note that you have to change the LaTeX code to see if it works (purge the page.)

[edit] This worked on etch and mediawiki 1.11

1. go to /wiki/math/
2. aptitude install ocaml texlive imagemagick build-essential ocaml-core gcc
3. add new folder math in wiki/images
4. chmod 777 math
5. chown www-data math
6. in localsettings.php insert $wgTmpDirectory = "$IP/images/math";
7. in localsettings.php change to $wgUseTeX = true;
8. test if it works - enter "* \int_a^x f(\alpha\,)\,dx" on a page and save it

[edit] Sufficient package combination for Etch and Mediawiki 1.12

• If you do not have texvc:

apt-get install  texlive imagemagick gs make ocaml

After build of texvc, you may remove every packages installed with "ocaml".

• If you have texvc (you can build it on another Etch):

apt-get install  texlive imagemagick gs

[edit] See also

• Manual:Running MediaWiki on Ubuntu
• Manual:Running MediaWiki on Linux
• MediaWiki and Security
• m:MediaWiki development

[edit] Links

• MediaWiki installation in Debian and Windows XP (as part of Synarcher installation)

Languages:

English  • 日本語