Media Wiki Installation: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 82: Line 82:
Regardless on whether we are installing a new Media Wiki instance to use it as such, or we intent do restore an old instance, a full new instance initialization is required.
Regardless on whether we are installing a new Media Wiki instance to use it as such, or we intent do restore an old instance, a full new instance initialization is required.
==Create the Database==
==Create the Database==
==Configure <tt>httpd</tt> to Serve the Media Wiki Instance==


=TO DEPLETE=
=TO DEPLETE=
[[Media Wiki Native Installation]]
[[Media Wiki Native Installation]]

Revision as of 00:17, 30 December 2023

External

Internal

Overview

A full new installation of the latest LTS (Long Term Support) Media Wiki instance is in most cases the best option, for both new deployments and restoration of older deployments from backup. This procedure has been written to support both new deployments and restoration of old deployments from backup and possibly upgrade into the new instance.

Pick the Latest LTS Release

Always install the latest LTS (Long Term Support) release.

Pick the latest LTS minor version from this pages:

https://www.mediawiki.org/wiki/Version_lifecycle
https://www.mediawiki.org/wiki/Release_notes

Pick the latest patch version from this page, by navigating down the minor version folder and selecting the latest released patch:

https://releases.wikimedia.org/mediawiki/

The article was last updated for Media Wiki 1.39.6.

Install httpd

Install or upgrade to the newest stable httpd version for your platform. The Media Wiki compatibility page does not recommend any specific httpd version.

Installation instructions:

RHEL/Centos 7 MacOS

Install letsencrypt Certificates

The specific Media Wiki SSL and certificate configuration from /etc/httpd/conf.d/ssl.conf (the Listen directive and the only virtual host) and /etc/letsencrypt or /etc/pki/tls must be transferred manually from the backup file, after the web server and generic HTTPS support is installed.

No change in /etc/httpd/conf/httpd.conf should be required. If the state of another wiki is restored, the restoration script will remind of the need to apply SSL configuration and the required steps.

RHEL/Centos 7

PHP

PHP Installation

Select the newest compatible stable version from:

https://www.mediawiki.org/wiki/Compatibility#PHP

It is probably OK to install the latest stable PHP version even if it is not explicitly specified on the compatibility page. Media Wiki 1.39 works well with PHP 8.3 even if PHP 8.3 is not mentioned on the compatibility page.

Installation and httpd configuration instructions:

RHEL/Centos 7 MacOS

PHP Configuration

Some PHP installations come with error reporting set to dump all errors, including some not appropriate for production, like deprecation messages.

PHP Error Reporting Configuration

Install MariaDB

Select the newest compatible stable version from:

https://www.mediawiki.org/wiki/Compatibility#Database

It is probably OK to install the latest stable MariaDB version even if it is not explicitly specified on the compatibility page.

Installation and post-install configuration instructions:

RHEL/Centos 7 MacOS

Install the Media Wiki Release

Go to https://releases.wikimedia.org/mediawiki/, download the latest patch corresponding to the selected LTS release and expand it in the httpd document root.

RHEL/Centos 7 MacOS

Perform a New Instance Initialization

Regardless on whether we are installing a new Media Wiki instance to use it as such, or we intent do restore an old instance, a full new instance initialization is required.

Create the Database

Configure httpd to Serve the Media Wiki Instance

TO DEPLETE

Media Wiki Native Installation