https://training-course-material.com/index.php?action=history&feed=atom&title=MediaWiki_in_Depth%2FSetupMediaWiki in Depth/Setup - Revision history2026-05-13T23:42:09ZRevision history for this page on the wikiMediaWiki 1.45.1https://training-course-material.com/index.php?title=MediaWiki_in_Depth/Setup&diff=26854&oldid=prevBernard Szlachta at 13:21, 10 July 20152015-07-10T13:21:50Z<p></p>
<p><b>New page</b></p><div>{{Cat|MediaWiki}}<br />
{{Cat|course_code_mwdev1}}<br />
[[MediaWiki in Depth|Click to jump back to MediaWiki in Depth]]<br />
<br />
==Interlude: The Real Requirements for Installing Mediawiki==<br />
<br />
Now with that background in place, it should be of no surprise that there are essential skills to be able to successfully install MediaWiki. It is an industrial-strength piece of software that does very little to hold your hands; and it is the opinion of many that if you are installing any software that is open to the entire web (including malicious users and bots), you should without exception know what you are doing.<br />
<br />
Naturally, these topics are all outside the scope of this course, but if we have time left over for question-and-answer, we could explore these more.<br />
<br />
Do note that for a local install for your own personal use, none of the above need apply!<br />
<br />
<br />
===Prerequisites===<br />
* Linux/UNIX experience<br />
** System installation, configuration (Debian, Ubuntu, etc.)<br />
<br />
<br />
* PHP configuration experience: the more, the less trouble<br />
** PHP is rough. It's riddled with inconsistencies and gotchas that you ''must'' be aware of to keep your installation afloat<br />
** If you know how to create a php.ini from scratch, you're in a good spot<br />
*** ''Stay away from PHP > 5.4''<br />
<br />
<br />
* Basic MySQL experience<br />
** For a professional installation, security concerns also come to play--again: the more, the less trouble<br />
** SQLite is also an option<br />
<br />
* Apache configuration<br />
** There are lots of tutorials for this, but to get certain features to work (url rewriting, etc), a fundamental understanding is necessary<br />
<br />
==Setup (Debian Linux)==<br />
This setup will be specific to Debian Linux, but the concepts and basic procedures I will go over differ little between distributions. If you sysadmin a different distribution at your workplace, you will know where to make the according changes.<br />
<br />
<br />
===Using aptitude to install what we need===<br />
* We need php <= 5.4, mysql database server/client, apache2 webserver and its php module (so it can run php software such as MediaWiki)<br />
** sudo aptitude update <br />
** sudo aptitude install apache2 libapache2-mod-php5 php5-mysql mysql-server mysql-client<br />
<br />
===Downloading the latest version of MediaWiki===<br />
* '''Note:''' your company's policy may vary-- it might be wise to create your own deb repository for easier maintenance<br />
* [https://www.mediawiki.org/wiki/Download Get MediaWiki]<br />
** cp mediawiki-1.23.3.tar.gz /var/www<br />
** tar xzvf mediawiki-1.23.3.tar.gz<br />
** mv mediawiki-1.23.3.tar.gz mw<br />
<br />
* Basic sysadmin practice: ''always read the release notes''<br />
* Marking the images/ directory as writable by the apache user (www-data)<br />
<br />
===Configuring Apache===<br />
* This will be very specific to your install<br />
* [[More Resources]]<br />
<br />
===Configuring MySQL===<br />
* Creating our database and user for MediaWiki<br />
** mysql -u root -p<br />
** CREATE DATABASE wikidb;<br />
** GRANT ALL ON wikidb.* to 'wikiuser'@'localhost' identified by 'samplePassword';<br />
<br />
<br />
===Installing MediaWiki===<br />
* Getting your LocalSettings.php</div>Bernard Szlachta