Wikipédia:Saját wiki telepítése Fedorában

Ez a szócikk saját wiki telepítését írja le Fedora munkaállomásra, és foglalkozik néhány üzemeltetési kérdéssel is. A leírtakhoz némi Linux-jártasságra van szükség.

E szócikk írásakor a 28-as Fedora a legfrissebb stabil verzió.

Telepítés

Parancssorban vagyunk, root felhasználóként jelentkeztünk be.

A wiki telepítése egyetlen utasítás, mely 55 csomagot telepít kb. 350 MByte méretben:

dnf install mariadb-server php-mysqlnd mediawiki

Az apache konfigurálása

Az apache csúfneve Fedorában httpd.

systemctl start  httpd              # elindítjuk apache-t
systemctl enable httpd              # boot után is induljon el
firewall-cmd --add-port=80/tcp --permanent
systemctl restart firewalld         # a 80-as portot beengedjük a tűzfalon

Ezután kívülről is elérhető a gépünk IP-címe böngészővel.

A mariaDB indítása

A mySQL és a mariaDB két egymással kompatibilis relációsadatbázis-kezelő, csak a fejlesztőjük más. A két név a wiki szempontjából felcserélhető.

systemctl start  mariadb      # elindítjuk az adatbáziskezelőt
systemctl enable mariadb      # boot után is induljon el
mysql_secure_installation     # az eredeti root jelszó üres. Állítsunk be másikat, a többi kérdésre üres sor

A mediawiki konfigurálása

A /etc/httpd/conf.d/mediawiki.conf-ot javítsuk. Húzzuk ki a #-jelet két sor elől:

Alias /wiki/skins /usr/share/mediawiki/skins
Alias /wiki /var/www/wiki

Indítsuk újra az apache-t:

systemctl restart httpd

Konfigurálás böngészőből

A wiki program már működőképes, de az adatbázist még létre kell hozni, és néhány beállítás is hiányzik. A konfigurálás során a háttérben létrejönnek az adatbázis táblák, és kapunk egy böngészőből letölthető konfigurációs fájlt (LocalSettings.php), amit a fájlrendszerbe kell majd másolni. A konfigurálás nem módosítja a már feltelepített fájlokat; ehhez joga sincs.

A böngészőbe írandó webcím: http://localhost/wiki/. Másik gépből is lehet konfigurálni, ilyenkor értelemszerűen localhost helyett a wiki-s gép IP-címét vagy nevét kell megadni.

A lapok kérdéseket tesznek fel. Csak azokat a válaszokat írjuk itt le, ahol változtatni kell.

Nyelv

Magyar nyelvet állítunk be, hacsak nincs valami különleges célunk a wikivel.

Üdvözöl a MediaWiki!

Nincs kérdés a lapon.

Kapcsolódás az adatbázishoz

• Adatbázis hosztneve: localhost (akkor is, ha másik gépről konfigurálunk)
• Adatbázisnév: … (ékezet nélküli nevet válasszunk)
• Felhasználónév: root
• Jelszó: amit a mysql_secure_installation utasításban megadtunk

Adatbázis-beállítások

A lap még mindig a mysql-ről kérdez:

• Tárolómotor: InnoDB
• Adatbázis karakterkészlete: Bináris

Név

Ez a lap már tényleg a wikit konfigurálja:

• A wiki neve: … (itt nyugodtan lehet ékezetet használni)
• Projektnévtér: a magyar Wikipédián ez Wikipédia. Ilyen névtér nem lesz a saját wikinkben, hacsak itt meg nem adjuk a Wikipédia nevet. A névtér a wiki-vel kapcsolatos, nem szócikk típusú információk névtere. Alaphelyzetben azonos a wiki előző pontban megadott nevével.
• Adminisztrátori fiók: a mindenható wiki-szerkesztő neve és jelszava. Ez tehát nem mysql, hanem wiki- (alkalmazás) user. Elvárás, hogy a jelszó legalább 8 karakter legyen, és különbözzék a felhasználó nevétől. Ennek saját wiki esetében nem sok értelme van, aki pedig szerverre telepít wiki-t, remélhetőleg tudja, mit csinál…
• Email-cím: saját wiki esetén nincs értelme. Nem akarunk saját magunkkal levelezni.

Beállítások

• Felhasználói jogosultságok profilja: ki láthatja ill. szerkesztheti a wikit. Saját wikinél a nyílt wikit érdemes megadni.
• Szerzői jog és licenc: saját wikiben nem kell.
• Kimenő e-mailek: saját wikiben ne engedélyezzük.
• Kiterjesztések: megadhatjuk az összeset is: könnyebb később megszüntetni egy kiterjesztést, mint újat felvenni. Saját wikiben a ConfirmEdit, Interwiki, Renameuser, SpamBlacklist és TitleBlacklist mindenképpen feleslegesnek tűnik.
• Képek és fájlok feltöltése: engedélyezzük. A Instant Commons engedélyezése minden képnél megnézi, van-e ilyen nevű a Commons-on; több kép esetén ez nagyon le tudja lassítani a lap betöltését még gyors internetkapcsolattal is, ha pedig épp nincs internetkapcsolat, hiányzó kép ikont látunk, ami úgy is marad: a lap változtatás nélküli szerkesztésével szüntethető meg.
• A logó URL-címe: ne strapáljuk magunkat: fütyül rá, mit állítunk be. Később majd módosítjuk.
• Objektum-gyorsítótárazás: nem kell.

Telepítés

Létrehozza az adatbázis-táblákat. Olyan 40 másodperc alatt végez.

LocalSettings.php

Az utolsó lépés. A böngésző nagyon el akarja menteni a címbeli file-t. Engedjünk neki, és a file-t root-ként másoljuk be a /var/www/wiki könyvtárba. Ettől megnyugszik a lelke, nekünk pedig a file szerkesztésével módunk lesz az előbb kihagyott logót módosítani ($wgLogo változó). Ezután kattintsunk az enter your wiki linkre (rejtély, miért angolul írja: a lap többi része magyarul van). A frissen telepített wiki nyitólapját látjuk. Ha mégsem, ürítsük a böngésző cache-ét. A wiki a nyitólap kivételével üres.

A LocalSettings.php jogait úgy állítsuk be, hogy csak az apache tudja olvasni (hiszen a root adatbázis-felhasználó jelszava van benne):

chgrp apache /var/www/wiki/LocalSettings.php     # apache csoportjogon fogja olvasni a fájlt
chmod o-rw /var/www/wiki/LocalSettings.php       # a világ jogait elvesszük
ls -l /var/www/wiki/LocalSettings.php

Az eredmény:

-rw-r-----. 1 root apache 4961 aug    5 20.28 /var/www/wiki/LocalSettings.php

Adminisztráció

Verziók

E szócikk írásakor a 28-as Fedora a stabil. A wiki komponensei és verziói:

• mediawiki 1.29.2
• PHP 7.2.8
• mariadb 10.2.16
• apache webszerver 2.4.33

Statikus weblapok

A httpd csomag telepíti az apache-t: a http://localhost URL-en az apache bejelentkező lapja látható Fedora Test Page címmel. Az apache DocumentRoot-ja a /etc/httpd/conf/httpd.conf fájlban van megadva, értéke /var/www/html. Egyetlen fájl sem található benne. A /etc/httpd/conf.d/welcome.conf fájl szerint ilyenkor a /usr/share/httpd/noindex/index.html tartalmát mutatja a böngésző. Ha a wiki mellett normál lapokat is szeretnénk, érdemes a document root-ot megváltoztatni, és egy másik fájlrendszerbe tenni (lásd LVM vagy ZFS).

Wiki admin

A wiki a http://localhost/wiki címen érhető el. A konfigurációs fájl helye /etc/httpd/conf.d/mediawiki.conf, aminek

Alias /wiki /var/www/wiki

sora adja meg az URL-t és a wiki fájljainak gyökerét. A /var/lib/wiki könyvtárat itt is érdemes átmozgatni másik fájlrendszerbe, mert képek feltöltésével nagyra nőhet a helyfoglalása. A fájlok a root tulajdonában vannak, kivéve az images könyvtárat; ezek az apache-t futtató apache felhasználó számára írhatóak. Ide kerülnek majd a wiki-be feltöltött médiafájlok (pl. képek): ezeket az apache fogja odaírni a böngészőtől kapott utasításra. Ezért kell az írásjog.

A könyvtár másolásával és némi kézi apache-konfigurálással több saját wikit lehet üzemeltetni anélkül, hogy a wiki kódját lemásolnánk. Ezért van annyi szimbolikus link a /var/lib/wiki könyvtárban. A mediawiki csomag upgrade-jével az összes, a /var/lib/wiki másolásával létrehozott wiki frissülni fog.

Apache admin Fedorában

Az apache-nak egy konfigurációs fájlja van: Fedorában a /etc/httpd/conf/httpd.conf, azonban az Include ill. IncludeOptional utasítással képes más fájlt is beilleszteni a konfigurációba. A Fedorában két könyvtárra és néhány fájlra osztották szét a konfigurációt. Rajtunk áll, hogy hová írunk egy változtatást, hiszen a végeredmény egy konfig fájl, melyben az utasítások sorrendje nem számít (hacsak nem állítjuk be kétszer különböző értékre ugyanazt az apache-változót). A két könyvtár:

• /etc/httpd/conf.d: egy alkalmazáshoz tartozó apache-utasításokat tartalmazó fájlok. Pl. a wiki fájlneve mediawiki.conf.
• /etc/httpd/conf.modules.d: apache-modulok listáit tartalmazó fájlok. A modulok apache-utasítások kódját tartalmazzák, nélkülük az apache az utasításokat sem érti.

A konfigurációs fájlokban történő változtatás után az apache-t újra kell indítani (systemctl restart httpd).

Források

• LocalSettings.php (mediawiki)
• Running MediaWiki on Fedora (mediawiki)
• Install MySQL 8.0/5.7 on Fedora 28/27, CentOS/RHEL 7.5/6.9. www.if-not-true-then-false.com (2018. május 19.) (Hozzáférés: 2018. augusztus 5.)
• Apache HTTP Server Version 2.4 Documentation (apache)

Kapcsolódó szócikkek

• Saját wiki telepítése Debianban
• Wikipédia:Wikitelepítés a saját gépedre lépésről lépésre
• Wikipédia:Wiki migrálása Debianba