Wikipédia:Saját wiki telepítése Fedorában
Ezen az oldalon egy technikai leírást olvashatsz a Wikipédia szerkesztéséről. Tartsd szem előtt, hogy nem minden ajánlott, ami technikailag megvalósítható! |
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
[szerkeszté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
[szerkesztés]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
[szerkesztés]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
[szerkesztés]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
[szerkesztés]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
[szerkesztés]Magyar nyelvet állítunk be, hacsak nincs valami különleges célunk a wikivel.
Üdvözöl a MediaWiki!
[szerkesztés]Nincs kérdés a lapon.
Kapcsolódás az adatbázishoz
[szerkesztés]- 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
[szerkesztés]A lap még mindig a mysql-ről kérdez:
- Tárolómotor: InnoDB
- Adatbázis karakterkészlete: Bináris
Név
[szerkesztés]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
[szerkesztés]- 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
[szerkesztés]Létrehozza az adatbázis-táblákat. Olyan 40 másodperc alatt végez.
LocalSettings.php
[szerkesztés]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ó
[szerkesztés]Verziók
[szerkesztés]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
[szerkesztés]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
[szerkesztés]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
[szerkesztés]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
[szerkesztés]- 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)