MediaWiki Install 2022-09-01

• Previous Version: https://wiki.traxel.com/index.php/MediaWiki_Install_2022-01-22

Notes

Additional Modules

• Survey Extension, should work well for HeatSync
  • https://www.mediawiki.org/wiki/Extension:Survey

Create a Host

I'm not going to document this part. Pick your favorite hosting service and create a Debian 10 host.

If your provider supports it, get a permanent IP address and point it at the new host. This will let you blow away the host, create a new one, point the IP at the new host, and redo the install without having to update the DNS entry and wait for the cascade.

Note the IP address.

IP: 35.160.237.84

System Update and Core Software

Following is based, in part, on MediaWiki Installation Requirements.

Log in to your host.

Script:

sudo apt update -y
sudo apt upgrade -y
# the one true editor
sudo apt install -y emacs-nox
# Apache with TLS support
sudo apt install -y apache2 certbot python3-certbot-apache
# DB, PHP, and Apache Modules
sudo apt install -y mariadb-server php php-mysql libapache2-mod-php
# PHP Support for MediaWiki Features:
sudo apt install -y php-xml php-mbstring php-apcu php-intl php-cli php-curl
# other mediawiki feature support:
sudo apt install -y git imagemagick texlive

Retry: On my first pass through, just pasting this to a CLI, it stopped after the second line (upgrade). I then pasted the whole thing into a file and called it with "sh init.sh", and it ran the whole way through. When I nuke this box and come back through I want to try again using the shell script file on the first pass. Worst case you just keep re-calling the script until it makes it through.

MediaWiki Tarball

• https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki

I am installing from the tarball instead of using the Debian package because other package tools, like RPM or Snap, or other distros than Debian, might put directories in different places. Following the MediaWiki tarball instructions should be close to universal.

$ mkdir tmp
$ cd tmp
$ wget https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.2.tar.gz

One difference on other distros may be the location of /var/www/html. Adjust the following commands to match your distro's structure if you're not using Deb 10.

$ cd /var/www
$ sudo tar -xvzf ~/tmp/mediawiki-1.38.2.tar.gz
$ sudo mv html static
$ sudo ln -s mediawiki-1.38.2 mediawiki

Configure MariaDB

Pick a username for MediaWiki to use (I'm using wiki_wiki as an example).

Pick a database name (I'm using hsl_wiki as an example).

Pick a password other than "CHANGE THIS PASSWORD".

$ sudo cat > mariadb-wiki-account.sh
create database hsl_wiki;
grant all on hsl_wiki.* to 'wiki_wiki'@'localhost' identified by 'CHANGE THIS PASSWORD';
flush privileges;

Control-D to write the file.

$ sudo mariadb < mariadb-wiki-account.sh

Then you can verify it worked if you like. (there won't be any tables, but it shouldn't give you an auth error)

$ mariadb -u wiki_wiki -p
MariaDB> show tables in hsl_wiki;
MariaDB> exit

Configure Temporary DNS

This is assuming that there is a legacy wiki running on wiki.domain.com, and you will be bringing up the new machine with the temporary name wiki-new.domain.com. Once you have the new machine running and validated, you will migrate wiki.domain.com to the new machine.

Go to your domain name registrar and add an A Record for the machine and two CNAME records; one for the wiki engine and one for static content. I'm using "jimbo2" as the machine name, you can use whatever you like.

Type	Host	Value	TTL
A Record	jimbo2	35.160.237.84	Automatic
CNAME	wiki-new	jimbo2.traxel.com	Automatic
CNAME	wiki-static-new	jimbo2.traxel.com	Automatic

It may take a bit to cascade through your resolvers. If you want to be able to hit it immediately, you can update your /etc/hosts file. Add a line like "35.160.237.84 mediawiki.domain.com" but with your IP and domain, after the localhost mappings.

Configure Apache

Next we'll add an Apache config for mediawiki.domain.com, and point the default to a directory that will serve static content.

/etc/apache2/sites-available/mediawiki.conf

<VirtualHost *:80>
  ServerName mediawiki.traxel.com

  ServerAdmin webmaster@localhost
  DocumentRoot /var/www/mediawiki

  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

/etc/apache2/sites-available/000-default.conf

<VirtualHost *:80>
  #ServerName www.traxel.com

  ServerAdmin webmaster@localhost
  DocumentRoot /var/www/static

  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>