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

Összefoglalás

A leírás Debian 9.11 operációs rendszeren készült.

A példák a szöveges fájlok szerkesztéséhez mcedit szövegszerkesztőt feltéteznek (Telepítés: apt-get install mc)

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

A szükséges Apache webszerver, MySQL adatbázis szerver és Php futtatókörnyezet az operációs rendszer tárolójából telepítjük.

A Mediawiki 10.31.5 long-term support kiadása lesz telepítve. Eltérő verzió telepítése esetén a bővítmények és a Parsoid verzió kompatibilitást ellenőrizni kell.

A példában a webszerver, adatbázis szerver és a VisualEditor-hoz szükséges Parsoid szolgáltatás egy hoston fut. Nagy igénybevételű wiki site esetében ezek különválaszthatóak.

Futtató környezet telepítése

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

apt-get install apache2 mysql-server php php-mysql php-mbstring php-xml php-pecl-http php-apcu php-intl

Adatbázis létrehozása

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

mysql -uroot

SQL futtatása:

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

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

quit;

Webszerver konfigurálása

A pédában Apache-Debian alapértelmezések lesznek használatban: A /var/www/ könyvtár és a www-data user lesz használva.

Apache konfiguráció létrehozása:

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

• 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 /var/www/mediawiki-1.31.5
        <Directory "/var/www/mediawiki-1.31.5/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 /var/www/mediawiki-1.31.5
    <Directory "/var/www/mediawiki-1.31.5/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ó

ln -s /etc/apache2/sites-available/mediawiki.conf /etc/apache2/sites-enabled/mediawiki.conf
service apache2 restart

Mediawiki motor telepítése

wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.5.tar.gz -P /tmp/
tar -xzf /tmp/mediawiki-1.31.5.tar.gz -C /var/www/
chown -R www-data:www-data /var/www/mediawiki-1.31.5/
rm /tmp/mediawiki-1.31.5.tar.gz

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

Wiki web install step 1

Wiki nyelvének kiválasztása

Wiki web install step 2

Környezet ellenőrzése

Wiki web install step 3

Adatbázis adatok megadása

Wiki web install step 4

Wiki web install step 5

Wiki név és admin user megadása

Wiki web install step 6

Wiki részletesebb konfigurálása

Wiki web install step 7

Telepítés indítása

Wiki web install step 8

Wiki web install step 9

Konfigurációs fájl mentése

Wiki web install step 10

A letöltött LocalSettings.php fájlt a /var/www/mediawiki-1.31.5/ könyvtárba kell másolni pl WinSCP segítségével.

VisualEditor telepítése

A wikinek egy speciális nyelve van (WikiText), amelyet el kell sajátítani, hogy a wiki oldalait szerkeszthessük. A VisualEditor plugin lehetővé teszi, hogy a wiki oldalakat bárki szövegszerkesztő szerűen szerkessze. A plugin működéséhez szükséges a Parsoid szolgáltatás, ami WikiText és a html konverziót végzi. A Parsoid működéséhez szükséges a NodeJS.

Szükséges csomagok telepítése:

apt-get install curl apt-transport-https dirmngr

NodeJS telepítése

curl -sL https://deb.nodesource.com/setup_6.x | bash -
apt-get install -y nodejs

Parsoid telepítése

apt-key advanced --keyserver keys.gnupg.net --recv-keys AF380A3036A03444
echo "deb https://releases.wikimedia.org/debian jessie-mediawiki main" | tee /etc/apt/sources.list.d/parsoid.list
apt-get update
apt-get install parsoid

Wiki api ellenőrzése

curl https://mydomain.com/api.php

Ha beolvassa a html oldalt, akkor működik.

! https esetén érvényes tanúsítvány kell!

Pasoid konfiguráció:

A konfigurációban mydomain.com -ot kell kicserélni a wiki domainjére. Több domain esetén az - uri: konfigurációs részletet kell többszörözni.

mcedit etc/mediawiki/parsoid/config.yaml

#----
  - module: ../src/lib/index.js
#----
    conf:
	   - uri: 'https://mydomain.com/api.php'
	     domain: 'mydomain.com'
#----

VisualEditor bővítmény telepítése

wget https://extdist.wmflabs.org/dist/extensions/VisualEditor-REL1_31-c3c9140.tar.gz -P /tmp/
tar -xzf /tmp/VisualEditor-REL1_31-c3c9140.tar.gz -C /var/www/mediawiki-1.33.1/extensions
rm /tmp/VisualEditor-REL1_31-c3c9140.tar.gz

VisualEditor konfiguráció:

mcedit /var/www/mediawiki-1.33.1/LocalSettings.php

A konfiguráció végére be kell szúrni a következő konfigurációs részletet, és a mydomain.com -ot kell kicserélni a wiki domainjére.

wfLoadExtension( 'VisualEditor' );

// Enable by default for everybody
$wgDefaultUserOptions['visualeditor-enable'] = 1;

// Optional: Set VisualEditor as the default for anonymous users
// otherwise they will have to switch to VE
// $wgDefaultUserOptions['visualeditor-editor'] = "visualeditor";

// Don't allow users to disable it
$wgHiddenPrefs[] = 'visualeditor-enable';

// OPTIONAL: Enable VisualEditor's experimental code features
#$wgDefaultUserOptions['visualeditor-enable-experimental'] = 1;


$wgVirtualRestConfig['modules']['parsoid'] = array(
    // URL to the Parsoid instance
    // Use port 8142 if you use the Debian package
    'url' => 'http://localhost:8142',
    //// Parsoid "domain", see below (optional)
    'domain' => 'mydomain.com',
    // Parsoid "prefix", see below (optional)
    //'prefix' => 'mydomain.com'
);


// This feature requires a non-locking session store. The default session store will not work and
// will cause deadlocks (connection timeouts from Parsoid) when trying to use this feature. Only required for MediaWiki 1.26.x and earlier!
$wgSessionsInObjectCache = true;

// Forward users' Cookie: headers to Parsoid. Required for private wikis (login required to read).
// If the wiki is not private (i.e. $wgGroupPermissions['*']['read'] is true) this configuration
// variable will be ignored.
//
// WARNING: ONLY enable this on private wikis and ONLY IF you understand the SECURITY IMPLICATIONS
// of sending Cookie headers to Parsoid over HTTP. For security reasons, it is strongly recommended
// that $wgVirtualRestConfig['modules']['parsoid']['url'] be pointed to localhost if this setting is enabled.
$wgVirtualRestConfig['modules']['parsoid']['forwardCookies'] = true;