Help:Installation - Revision history

SimonJolly at 13:13, 31 March 2016

2016-03-31T13:13:12Z

← Older revision		Revision as of 13:13, 31 March 2016
Line 14:		Line 14:
	It is recommended to download the latest version: this is normally listed on the [http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki Installing MediaWiki Manual page].		It is recommended to download the latest version: this is normally listed on the [http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki Installing MediaWiki Manual page].

	The first version installed of the [[PBTWiki]] was carried with [http://releases.wikimedia.org/mediawiki/1.16/ MediwWiki release 1.16.5]: this was the most recent version that didn't require a version of PHP more recent than 5.1.6, which was the version on the HEP www server as of April 2016.		The first version installed of the [[Main Page\|PBTWiki]] was carried with [http://releases.wikimedia.org/mediawiki/1.16/ MediwWiki release 1.16.5]: this was the most recent version that didn't require a version of PHP more recent than 5.1.6, which was the version on the HEP www server as of April 2016.

	It is possible to [http://www.mediawiki.org/wiki/Download_from_Git download the MediaWiki software from Git]: however, this is normally meant for developers and the bleeding edge version isn't needed for the [[Main Page\|PBTWiki]].		It is possible to [http://www.mediawiki.org/wiki/Download_from_Git download the MediaWiki software from Git]: however, this is normally meant for developers and the bleeding edge version isn't needed for the [[Main Page\|PBTWiki]].

SimonJolly at 13:12, 31 March 2016

2016-03-31T13:12:43Z

← Older revision		Revision as of 13:12, 31 March 2016
Line 68:		Line 68:
	== [[Help:Configuration\|Configuration]] ==		== [[Help:Configuration\|Configuration]] ==

	Once these steps have been completed, you can move on to [[~~HelpConfiguration~~\|configuring your MediaWiki]].		Once these steps have been completed, you can move on to [[Help:Configuration\|configuring your MediaWiki]].

SimonJolly at 13:12, 31 March 2016

2016-03-31T13:12:19Z

← Older revision		Revision as of 13:12, 31 March 2016
Line 43:		Line 43:

	== Run Setup Script ==		== Run Setup Script ==

			Once the software has been downloaded and unpacked and the directory has been created for the SQLite database, the final stage is to run the PHP setup script.
			This is accomplished by navigating to the [[Main page\|root directory]] of the MediaWiki through a web browser.
			This should load a page hat gives information on the setup and asks to set a number of options.

			For the [[Main Page\|PBTWiki]], the following options were selected:

			; Wiki name : PBTWiki
			; Copyright/license : No license metadata
			; Object caching : No caching
			; Email features (global) : Enabled
			; User-to-user email : Enabled
			; E-mail notification about changes : Enabled for changes to user discussion pages, and to pages on watch lists
			; E-mail address authentication : Enabled
			; Database type : SQLite
			; Database name : pbtwiki
			; SQLite data directory : <code>/var/www/pbt/</code>

			Note that the SQLite data directory is '''<code>/var/www/pbt/</code>''' and '''not''' <code>/unix/www/pbt/</code>.
			This is because, if logged in directly to the HEP www server (only possible by a HEP sysadmin), web data is stored in <code>/var/www/</code>.
			This area is then mounted as <code>/unix/www/</code> as seen from any other Linux machine in the cluster.
			However, the <code>apache</code> process is running directly on the www server itself, so the local directory name needs to be used.

			== [[Help:Configuration\|Configuration]] ==

			Once these steps have been completed, you can move on to [[HelpConfiguration\|configuring your MediaWiki]].

SimonJolly: Created page with "This page covers the installation of the MediaWiki on the UCL HEP servers. For instructions on configuring the MediaWiki once installation is complete, see the [[Help:Configurat..."

2016-03-31T12:56:55Z

Created page with "This page covers the installation of the MediaWiki on the UCL HEP servers. For instructions on configuring the MediaWiki once installation is complete, see the [[Help:Configurat..."

New page

This page covers the installation of the MediaWiki on the UCL HEP servers. For instructions on configuring the MediaWiki once installation is complete, see the [[Help:Configuration|Configuration help page]].

The installation on the HEP www server followed the online instructions from the [http://www.mediawiki.org/wiki/Manual:Installation_guide MediaWiki Installation Guide].

Detailed instructions on the installation process can be found in the [http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki Installing MediaWiki Manual page].

Some more instructions are available from the [http://www.ibiblio.org/elemental/howto/mediawiki.html Elemental Linux Server MediaWiki Installation Guide].

The Installation process follows the following stages:

== Download Software ==

All current and previous releases of he MediaWiki software are available from the [http://releases.wikimedia.org/mediawiki/ MediaWiki Releases website].
It is recommended to download the latest version: this is normally listed on the [http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki Installing MediaWiki Manual page].

The first version installed of the [[PBTWiki]] was carried with [http://releases.wikimedia.org/mediawiki/1.16/ MediwWiki release 1.16.5]: this was the most recent version that didn't require a version of PHP more recent than 5.1.6, which was the version on the HEP www server as of April 2016.

It is possible to [http://www.mediawiki.org/wiki/Download_from_Git download the MediaWiki software from Git]: however, this is normally meant for developers and the bleeding edge version isn't needed for the [[Main Page|PBTWiki]].

== Extract Software ==

Once downloaded, the software needs to be unpacked in the appropriate location.
On the UCL HEP Linux systems, this is '''<code>/unix/www/html/pbt/pbtWiki</code>'''.
This is equivalent to the web address http://www.hep.ucl.ac.uk/pbt/pbtWiki, which is the full address for the [[Main Page|PBTWiki]].

== Create Directory for SQLite Database ==

All the data for the MediaWiki needs to be stored in a database.
During installation there is the choice of using either MySQL or SQLite: SQLite was chosen as it required the least overhead to get set up.
The SQLite database is a single file that has the <code>*.sqlite</code> extension.
No local database users are created for a MediaWiki SQLite database: access is purely through the web interface by editing pages or viewing the relevant [[Special:SpecialPages|Special Pages]].

For the [[Main Page|PBTWiki]], the SQLite database resides in the directory '''<code>/unix/www/pbt/</code>'''.
The resulting database is stored at '''<code>/unix/www/pbt/pbtwiki.sqlite</code>''': this database '''is created automatically''' during the installation process (see the [[#Run Setup Script|Run Setup Script]] section below).

Note that for the MediaWiki to read and write to the database correctly, both the database file and the directory in which it resides '''must be writeable by the Apache process (ID 48)'''.
Apache is the software that runs the HEP www server.
It has a specific username (<code>apache</code>, ID <code>48</code>) and group (also <code>apache</code>, ID <code>48</code>).
In order to access the database, the directory and database either need to be owned by user <code>apache</code> (<code>48</code>) or by group <code>apache</code> (<code>48</code>).
If it is a member of group <code>apache</code> (<code>48</code>) but not owned by user <code>apache</code> (<code>48</code>), both the file and the directory also need to have their permissions set to be group writeable.

For the [[Main Page|PBTWiki]], the <code>/unix/www/pbt/</code> directory is owned by user <code>apache</code> but is a member of the <code>webadmin</code> group; the <code>/unix/www/pbt/pbtwiki.sqlite</code> database file is owned by user <code>jolly</code> but is a member of the group <code>apache</code> with appropriate group write permissions.

== Run Setup Script ==