Kenneth: /* 1.32.0 */

2019-02-11T04:19:54Z

1.32.0

New page

== Installation ==

See https://www.mediawiki.org/wiki/Manual:Installation_guide

== Installation Dependencies ==

=== CentOS 6 ===

Setup Apache, PHP and MySQL:
yum install httpd php mysql mysql-server php-mysql php-xml php-intl
# optional
yum install gd ImageMagick php-gd

Install Caching (CentOS 6):
# Select APC, XCache or WinCache.
yum install php-pecl-apc
# or (but not both)
yum install php-xcache
# or (but not both)
# install wincache?
service httpd restart

Install APC: [http://www.tecmint.com/install-apc-alternative-php-cache-in-rhel-centos-fedora/]
yum install php-pear php-devel httpd-devel pcre-devel gcc make
pecl install apc

Install GD or ImageMagick:
yum install ImageMagick

Install git
yum install git

=== Ubuntu ===

Ubuntu 16 or 18

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install apache2 mysql-server php php-mysql libapache2-mod-php php-xml php-mbstring
sudo apt-get install php-apcu php-intl imagemagick inkscape php-gd php-cli php-curl git

sudo phpenmod mbstring
sudo phpenmod xml
sudo systemctl restart apache2.service

sudo a2enmod ssl
sudo a2enmod rewrite

sudo mysql -u root -p
CREATE DATABASE my_wiki;
CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';
GRANT ALL ON my_wiki.* TO 'new_mysql_user'@'localhost';
quit;

cd /etc/apache2
sudo ln -s /var/log/apache2 logs

== Install MediaWiki ==

MediaWiki Download - http://www.mediawiki.org/wiki/Download

=== 1.32.0 ===

cd /www
wget https://releases.wikimedia.org/mediawiki/1.32/mediawiki-1.32.0.tar.gz
tar -zvxf mediawiki-1.32.0.tar.gz
mv mediawiki-1.32.0 wiki
mv mediawiki-1.32.0.tar.gz wiki
cd wiki

chown :www-data cache
chmod g+w cache

=== 1.31.0 ===

cd /www
wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.0.tar.gz
tar -zvxf mediawiki-1.31.0.tar.gz
mv mediawiki-1.31.0 wiki
mv mediawiki-1.31.0.tar.gz wiki
cd wiki

=== 1.28 ===

MediaWiki 1.28 requires PHP version 5.5.9:
cd /www
wget http://releases.wikimedia.org/mediawiki/1.28/mediawiki-1.28.2.tar.gz
tar -zvxf mediawiki-1.28.2.tar.gz
mv mediawiki-1.28.2 wiki
mv mediawiki-1.28.2.tar.gz wiki
cd wiki

=== 1.24 ===

MediaWiki 1.24
cd /www
wget http://releases.wikimedia.org/mediawiki/1.24/mediawiki-1.24.1.tar.gz
tar -zvxf mediawiki-1.24.1.tar.gz
mv mediawiki-1.24.1 wiki
mv mediawiki-1.24.1.tar.gz wiki
cd wiki

== Configure MediaWiki ==

Make config folder writable
# chmod a+w config
# centos:
sudo chown apache mw-config
# ubuntu:
sudo chown www-data mw-config

#chown www-data cache

Setup apache virtual hosting:
# centos:
/etc/httpd/conf.d/wiki.conf
# apache:
/etc/apache2/sites-enabled/wiki.conf

wiki.conf Basic Apache Setup:
<pre>
NameVirtualHost *:80

<VirtualHost *:80>
ServerName wiki.example.com
DocumentRoot /www/wiki
ErrorDocument 404 /index.html
ErrorLog logs/wiki-error_log
CustomLog logs/wiki-access_log common
</VirtualHost>
</pre>

Clean URL Apache setup:
<pre>
NameVirtualHost *:80

<VirtualHost *:80>
ServerName wiki.example.com
DocumentRoot /www/wiki
ErrorLog logs/wiki-error_log
CustomLog logs/wiki-access_log common
ErrorDocument 404 /index.html

# comment out this section until after mw-config step is complete
<Directory /www/wiki>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !^favicon.ico$
#RewriteCond %{REQUEST_FILENAME} !^mylogo.png$
#RewriteRule ^(.+)$ /index.php?title=$1 [PT,L,QSA]
RewriteRule ^(.*)$ /index.php/$1 [L,QSA]

# Ubuntu:
Require all granted
</Directory>
</VirtualHost>
</pre>

Clean URL Apache with SSL setup:
<pre>
<VirtualHost *:443>
ServerName wiki.example.com

# SSL Enabled:
SSLEngine on
SSLCertificateFile /etc/wiki.pem
SSLCertificateChainFile /etc/wiki.pem

DocumentRoot /www/wiki

ServerAdmin website@example.com
ErrorLog logs/wiki-error_log
CustomLog logs/wiki-access_log common

# Short URL
<Directory /www/wiki>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !^favicon.ico$
#RewriteCond %{REQUEST_FILENAME} !^mylogo.png$
#RewriteRule ^(.+)$ /index.php?title=$1 [PT,L,QSA]
RewriteRule ^(.*)$ /index.php/$1 [L,QSA]

# Ubuntu:
Require all granted
</Directory>
</VirtualHost>

<VirtualHost *:80>
ServerName wiki.example.com
Redirect permanent / https://wiki.example.com
</VirtualHost>
</pre>

Restart Apache
# centos:
service httpd restart
# ubuntu:
service apache2 restart

Start wizard:
http://wiki.example.com/mw-config/index.php

Note: If you just go to http://wiki.example.com/ you will also be directed to the mw-config setup.

=== Wizard ===

# Environmental Checks
#* Check for issues reported by wizard and fix. (restart apache, refresh config page, rinse and repeat)
# Database
#* MySQL database settings (innodb, binary mode)
# Options
#* Enable which extensions and skins you wish to use
# Install
#* Click to finalize
# Complete
#* Instructions for LocalSettings.php

Database (done by wizard): [http://www.mediawiki.org/wiki/Manual:Installing_MediaWiki]
create database wikidb;
create database wikidb DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;
grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password';

Remove config wizard (for security)
mkdir .archive
mv mw-config .archive
# or
rm -rf mw-config

Cleanup:
mkdir .archive
mv mediawiki-* StartProfiler.sample COPYING CREDITS FAQ HISTORY INSTALL README README.mediawiki RELEASE-NOTES* UPGRADE .archive
mv docs maintenance .archive

References:
* MediaWiki Installation Guide - http://www.mediawiki.org/wiki/Installation

== Upgrading ==

php maintenance/update.php

References:
* Manual:Upgrading - MediaWiki - https://www.mediawiki.org/wiki/Manual:Upgrading

== Upgrade ==

MediaWiki/Installation - Revision history

Kenneth: /* 1.32.0 */