Changes
m
fix link
{{H:h|system admin toc}}
'''Other languages''' : {{H-langs:Running MediaWiki on Linux}}
<-[[MediaWiki User's Guide]]: [[Running MediaWiki]]
==Required software==
* Web server with PHP 4.1.2 or higher (4.3.x is preferred, see [http://www.php.net/manual/en/install.unix.php www.php.net/manual/en/install.unix.php] )
** apache web server
** PHP
* A MySQL server. 4.0.x is preferred, but 3.2.x should work as well. (see [http://dev.mysql.com/doc/mysql/en/Installing.html dev.mysql.com/doc/mysql/en/Installing.html] )
These instructions assume you are using Linux and Apache, and that LAMP http://en.wikipedia.org/wiki/LAMP (Linux, Apache, MySQL, PHP) is already set up on your machine.
== Installation (from a Linux perspective) ==
You may prefer to see the [[Installation|general Installation instructions]]. The following installation steps give a quick overview from a Linux only perspective:
# Download MediaWiki: [http://wikipedia.sourceforge.net wikipedia.sourceforge.net] or see [[MediaWiki from CVS]]
# If you downloaded a gzipped file, unzip the source files in some directory: <tt>tar zxvf mediawiki-x.y.z.tar.gz</tt>. <br>(If you are not a real Linux Guru and you have [http://www.rarlab.com/ WinRAR] (like WinZip but works with gzipped files) on your Windows system you can cheat a little bit here. You can download the file to your Windows machine, use WinRAR to unzip the gzipped file into a directory in Windows and then use an FTP program like [http://www.ipswitch.com/Products/WS_FTP/ WS_FTP Pro] to transfer the entire wiki directory for you.)
# The new [[web-based install]] usually does not require root access. If for some reason you are using the old installation you might need to use commands such as: <tt>su -</tt> and <tt>mv /path_to_mediawiki_unzip_dir/</tt>. At this point you should also read the README, RELEASE-NOTES, INSTALL inside the mediawiki-x.y.z directory. However, keep in mind that either those files or this guide may be outdated, in which case someone else would appreciate your updates to this page after you're done :)
# Move the directory into your web directory: e.g. <tt>mv mediawiki-x.y.z /usr/local/apache/htdocs/wiki</tt> or <tt>mv mediawiki-x.y.z public_html/wiki</tt> or use your FTP software to do this for you.
# Now you need to [http://sunsite.mff.cuni.cz/MIRRORS/ftp.mysql.com/doc/en/Adding_users.html set up the databases] on which you will store your wiki. In Cpanel you can click on MySQL Databases. You will need to <tt>Add Db</tt> with the name you want to call your database, <tt>Add User </tt> to create a user with access to this database, then <tt>Add User to Db</tt> to connect that user to the database. Remember all this information because you will need it when you run the MediaWiki install script. Finally click on <tt>phpMyAdmin</tt> at the bottom of the MySQL Account Maintenance page in Cpanel to check your information and get MySQL running.
# 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 by typing: <tt>chmod -R a+w config</tt> in the directory you intend to install MediaWiki in. To do this you will need a telnet client like [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY] on your system. Note: On some newer Linux distributions you will also need to change the SELinux file type (see below)
# If you run the script and you get an error saying the script is unable to write to the tmp directory you may need to change the permissions for the tmp directory in your root. If you are installing on a new system you may need to change this. Often this directory will be already set up with write permission granted, so you can skip this step and come back if you run into a problem. To change the permissions for the tmp directory go into the root directory and type: <tt>chmod -R a+w tmp</tt> You typically must have root access in order to change the permissions to this directory. If you get an error message and you don't have root access then you will need to contact your service provider.
# At this point you should have Apache and MySQL running (this varies between distributions and setups, see their documentations for specifics). If you follow the steps above you really don't need to worry about this as they will be running automatically. Anyway, the install worked for me.
# Go to your browser and surf into the wiki directory. It'll direct you into the config script (if it doesn't, just load up the <tt>mediawiki-1.3.0beta4/config/index.php</tt> file). 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.
# 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) using again <tt>chmod -R a-w config</tt>. If you changed the tmp directory you can probably leave this as is so you can install other software on your system.
=== Some Installation Gotchas ===
==== SElinux ====
Linux distributions which support SELinux ('Security Extensions') are becoming more widespread. On such systems, PHP scripts will still be unable to write to the config directory, after you have set the normal file permissions. You will also need to use the 'chcon' command to change the SELinux file type. [http://codex.gallery2.org/index.php/Gallery2:Installation_on_a_SELinux_Server Gallery install documentation] describes this.
==== Running a PHP Accelerator? ====
In some cases, when running 1.2.4, one may encounter problems during the install. If this happens, try disabling phpa by placing <tt>php_value phpa Off</tt> in .htaccess in the root directory of your install.
== Platform specific instructions ==
=== Debian GNU/Linux ===
*[[Running MediaWiki on Debian GNU/Linux]]
=== Ubuntu GNU/Linux ===
*[[Help:Running MediaWiki on Ubuntu GNU/Linux]]
=== Gentoo Linux ===
*[[Running MediaWiki on Gentoo Linux]]
=== Mandrake Linux ===
*[[Running MediaWiki on Mandrake]]
=== Fedora Core ===
*[[Running MediaWiki on Fedora Core]]
=== Red Hat Linux ===
*[[Running MediaWiki on Red Hat Linux]]
===Slackware Linux===
*[[Running MediaWiki on Slackware Linux]]
=== SuSE Linux 9.3 ===
*[[Running MediaWiki on SuSE Linux 9.3]]
== Related topics ==
* [[Running MediaWiki on Windows]]
* [[Running MediaWiki on Sourceforge.net]]
* [[Apache config]]
* [[PHP config]]
* [[MySQL config]]
* [[Documentation:Configuration]]
* [[Help:Configuration]]
* [[Robots.txt]] -- how to prevent search engines from indexing the internals of your wiki
* [[Rewrite Rules]] -- how to get rid of /index.php in URLs
== References ==
file INSTALL in mediawiki-1.3.2.tar.gz
'''Other languages''' : {{H-langs:Running MediaWiki on Linux}}
<-[[MediaWiki User's Guide]]: [[Running MediaWiki]]
==Required software==
* Web server with PHP 4.1.2 or higher (4.3.x is preferred, see [http://www.php.net/manual/en/install.unix.php www.php.net/manual/en/install.unix.php] )
** apache web server
** PHP
* A MySQL server. 4.0.x is preferred, but 3.2.x should work as well. (see [http://dev.mysql.com/doc/mysql/en/Installing.html dev.mysql.com/doc/mysql/en/Installing.html] )
These instructions assume you are using Linux and Apache, and that LAMP http://en.wikipedia.org/wiki/LAMP (Linux, Apache, MySQL, PHP) is already set up on your machine.
== Installation (from a Linux perspective) ==
You may prefer to see the [[Installation|general Installation instructions]]. The following installation steps give a quick overview from a Linux only perspective:
# Download MediaWiki: [http://wikipedia.sourceforge.net wikipedia.sourceforge.net] or see [[MediaWiki from CVS]]
# If you downloaded a gzipped file, unzip the source files in some directory: <tt>tar zxvf mediawiki-x.y.z.tar.gz</tt>. <br>(If you are not a real Linux Guru and you have [http://www.rarlab.com/ WinRAR] (like WinZip but works with gzipped files) on your Windows system you can cheat a little bit here. You can download the file to your Windows machine, use WinRAR to unzip the gzipped file into a directory in Windows and then use an FTP program like [http://www.ipswitch.com/Products/WS_FTP/ WS_FTP Pro] to transfer the entire wiki directory for you.)
# The new [[web-based install]] usually does not require root access. If for some reason you are using the old installation you might need to use commands such as: <tt>su -</tt> and <tt>mv /path_to_mediawiki_unzip_dir/</tt>. At this point you should also read the README, RELEASE-NOTES, INSTALL inside the mediawiki-x.y.z directory. However, keep in mind that either those files or this guide may be outdated, in which case someone else would appreciate your updates to this page after you're done :)
# Move the directory into your web directory: e.g. <tt>mv mediawiki-x.y.z /usr/local/apache/htdocs/wiki</tt> or <tt>mv mediawiki-x.y.z public_html/wiki</tt> or use your FTP software to do this for you.
# Now you need to [http://sunsite.mff.cuni.cz/MIRRORS/ftp.mysql.com/doc/en/Adding_users.html set up the databases] on which you will store your wiki. In Cpanel you can click on MySQL Databases. You will need to <tt>Add Db</tt> with the name you want to call your database, <tt>Add User </tt> to create a user with access to this database, then <tt>Add User to Db</tt> to connect that user to the database. Remember all this information because you will need it when you run the MediaWiki install script. Finally click on <tt>phpMyAdmin</tt> at the bottom of the MySQL Account Maintenance page in Cpanel to check your information and get MySQL running.
# 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 by typing: <tt>chmod -R a+w config</tt> in the directory you intend to install MediaWiki in. To do this you will need a telnet client like [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY] on your system. Note: On some newer Linux distributions you will also need to change the SELinux file type (see below)
# If you run the script and you get an error saying the script is unable to write to the tmp directory you may need to change the permissions for the tmp directory in your root. If you are installing on a new system you may need to change this. Often this directory will be already set up with write permission granted, so you can skip this step and come back if you run into a problem. To change the permissions for the tmp directory go into the root directory and type: <tt>chmod -R a+w tmp</tt> You typically must have root access in order to change the permissions to this directory. If you get an error message and you don't have root access then you will need to contact your service provider.
# At this point you should have Apache and MySQL running (this varies between distributions and setups, see their documentations for specifics). If you follow the steps above you really don't need to worry about this as they will be running automatically. Anyway, the install worked for me.
# Go to your browser and surf into the wiki directory. It'll direct you into the config script (if it doesn't, just load up the <tt>mediawiki-1.3.0beta4/config/index.php</tt> file). 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.
# 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) using again <tt>chmod -R a-w config</tt>. If you changed the tmp directory you can probably leave this as is so you can install other software on your system.
=== Some Installation Gotchas ===
==== SElinux ====
Linux distributions which support SELinux ('Security Extensions') are becoming more widespread. On such systems, PHP scripts will still be unable to write to the config directory, after you have set the normal file permissions. You will also need to use the 'chcon' command to change the SELinux file type. [http://codex.gallery2.org/index.php/Gallery2:Installation_on_a_SELinux_Server Gallery install documentation] describes this.
==== Running a PHP Accelerator? ====
In some cases, when running 1.2.4, one may encounter problems during the install. If this happens, try disabling phpa by placing <tt>php_value phpa Off</tt> in .htaccess in the root directory of your install.
== Platform specific instructions ==
=== Debian GNU/Linux ===
*[[Running MediaWiki on Debian GNU/Linux]]
=== Ubuntu GNU/Linux ===
*[[Help:Running MediaWiki on Ubuntu GNU/Linux]]
=== Gentoo Linux ===
*[[Running MediaWiki on Gentoo Linux]]
=== Mandrake Linux ===
*[[Running MediaWiki on Mandrake]]
=== Fedora Core ===
*[[Running MediaWiki on Fedora Core]]
=== Red Hat Linux ===
*[[Running MediaWiki on Red Hat Linux]]
===Slackware Linux===
*[[Running MediaWiki on Slackware Linux]]
=== SuSE Linux 9.3 ===
*[[Running MediaWiki on SuSE Linux 9.3]]
== Related topics ==
* [[Running MediaWiki on Windows]]
* [[Running MediaWiki on Sourceforge.net]]
* [[Apache config]]
* [[PHP config]]
* [[MySQL config]]
* [[Documentation:Configuration]]
* [[Help:Configuration]]
* [[Robots.txt]] -- how to prevent search engines from indexing the internals of your wiki
* [[Rewrite Rules]] -- how to get rid of /index.php in URLs
== References ==
file INSTALL in mediawiki-1.3.2.tar.gz
