Mediawiki 1.35 LTS telepítése Debian-Apache-MySQL környezetben

Összefoglalás

A leírás a Mediawiki 1.35.4 LTS kiadásának telepítését mutatja be. A leírásban szereplő url-ek alverziónként változnak, ezeket módosítani kell.

A leírás Debian 10.1 operációs rendszeren készült. Az Apache http szervert, a Php futtatókörnyezet és a MySQL adatbázis szervert az operációs rendszer tárolójából telepítjük.

A parancsok root jogot feltételeznek. (állandó root jog: sudo -i)

Előfeltételek

Minimum követelmények

• PHP 7.3.19/7.4.3+
• MySQL 5.5.8+ / MariaDB 5.1+

Webszerver, adatbáziszerver és Php futtatókörnyezet telepítése

apt -y install apache2 mariadb-server php php-mysql php-mbstring php-xml php-apcu php-intl php-gd php-imagick

Adatbázis létrehozása

SQL futtatása: (Feltételezve, hogy a mysql root felhasználónak konzolból nincs jelszava - telepítés alapértelmezett)

• my_wiki: adatbázis neve
• wikiuser: adatbázis felhasználó neve
• password: adatbázis felhasználó jelszava

mysql -uroot -e "CREATE DATABASE my_wiki CHARACTER SET utf8;
CREATE USER 'wikiuser'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'%';"

Webszerver konfigurálása

Az alábbi beállításokkal létre kell hozni az /etc/apache2/sites-available/mediawiki.conf Apache konfigurációt.

• ServerName: domain név, ami alatt a wiki elérhető lesz. (A domaint konfigurálni kell a kiszolgáló IP címéhez)
• ServerAlias: további domain nevek.
• ServerAdmin: webmester e-mail címe.
• DocumentRoot: A könyvtár, ahová a mediawiki motor telepítve lesz.
• VirtualHost: a *:443 a https, a *:80 a http konfiguráció, ha csak az egyik kell, a másik elhagyható
• https konfiguráció
  • SSLCertificateFile: tanúsítvány fájl
  • SSLCertificateKeyFile: privát kulcs file
  • Include (opcionális): tanúsítvány lánc fájl

<IfModule mod_ssl.c>
    <VirtualHost *:443>
        ServerName mydomain.com
        ServerAlias www.mydomain.com
        ServerAdmin webmaster@mydomain.com
        DocumentRoot [vhostdir]
        <Directory "/[vhostdir]/images">
            AllowOverride None
            AddType text/plain .html .htm .shtml .phtml
            php_admin_flag engine off
        </Directory>

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

        SSLEngine on
        SSLCertificateFile  /etc/ssl/certs/ssl-cert-snakeoil.pem
        SSLCertificateKeyFile       /etc/ssl/private/ssl-cert-snakeoil.key
        #Include       /etc/ssl/certs/ssl-chain.conf
    </VirtualHost>
</IfModule>

<VirtualHost *:80>
    ServerName mydomain.com
    ServerAlias www.mydomain.com
    ServerAdmin webmaster@mydomain.com
    DocumentRoot [vhostdir]
    <Directory "[vhostdir]/images">
        AllowOverride None
        AddType text/plain .html .htm .shtml .phtml
        php_admin_flag engine off
    </Directory>
    
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Apache konfiguráció érvényesítése:

a2ensite mediawiki.conf
service apache2 restart

Mediawiki motor telepítése

A megfelelő Mediawiki release letöltése és a fájl kogosultságok beállítása:

wget -qO- wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.4.tar.gz | tar -xzf - -C /tmp
mv /tmp/mediawiki-1.35.X [vhostdir]
chown -R www-data:www-data [vhostdir]

A mediawiki telepítése böngészőben, a beállított domain használatával folytatható. pl: https://mydomain.com

Wiki nyelvének kiválasztása

Környezet ellenőrzése

Adatbázis adatok megadása

Wiki név és admin user megadása

Wiki részletesebb konfigurálása

Telepítés indítása

Konfigurációs fájl mentése

A letöltött LocalSettings.php fájlt a /var/www/mediawiki/ könyvtárba kell másolni.