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 Configuration help page.
The installation on the HEP www server followed the online instructions from the MediaWiki Installation Guide.
Detailed instructions on the installation process can be found in the Installing MediaWiki Manual page.
Some more instructions are available from the Elemental Linux Server MediaWiki Installation Guide.
The Installation process follows the following stages:
All current and previous releases of he MediaWiki software are available from the MediaWiki Releases website. It is recommended to download the latest version: this is normally listed on the Installing MediaWiki Manual page.
The first version installed of the PBTWiki was carried with 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.
Once downloaded, the software needs to be unpacked in the appropriate location.
On the UCL HEP Linux systems, this is
This is equivalent to the web address http://www.hep.ucl.ac.uk/pbt/pbtWiki, which is the full address for the 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
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 Pages.
For the PBTWiki, the SQLite database resides in the directory
The resulting database is stored at
/unix/www/pbt/pbtwiki.sqlite: this database is created automatically during the installation process (see the 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 (
48) and group (also
In order to access the database, the directory and database either need to be owned by user
48) or by group
If it is a member of group
48) but not owned by user
48), both the file and the directory also need to have their permissions set to be group writeable.
For the PBTWiki, the
/unix/www/pbt/ directory is owned by user
apache but is a member of the
webadmin group; the
/unix/www/pbt/pbtwiki.sqlite database file is owned by user
jolly but is a member of the group
apache with appropriate group write permissions.
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 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 PBTWiki, the following options were selected:
- Wiki name
- No license metadata
- Object caching
- No caching
- Email features (global)
- User-to-user email
- E-mail notification about changes
- Enabled for changes to user discussion pages, and to pages on watch lists
- E-mail address authentication
- Database type
- Database name
- SQLite data directory
Note that the SQLite data directory is
/var/www/pbt/ and not
This is because, if logged in directly to the HEP www server (only possible by a HEP sysadmin), web data is stored in
This area is then mounted as
/unix/www/ as seen from any other Linux machine in the cluster.
apache process is running directly on the www server itself, so the local directory name needs to be used.
Once these steps have been completed, you can move on to configuring your MediaWiki.