„Mediawiki 1.31 LTS telepítése Debian-Apache-MySQL környezetben” változatai közötti eltérés
Nincs szerkesztési összefoglaló |
|||
| (19 közbenső módosítás ugyanattól a szerkesztőtől nincs mutatva) | |||
| 1. sor: | 1. sor: | ||
==Összefoglalás== | ==Összefoglalás== | ||
A leírás | A leírás a [[mediawikiwiki:MediaWiki|Mediawiki]] [[mediawikiwiki:MediaWiki_1.31|1.31 LTS]] [[mediawikiwiki:Release_notes|kiadásának]] telepítését mutatja be. A leírásban szereplő url-ek [[mediawikiwiki:Release_notes/1.31|alverziónként]] változnak, ezeket módosítani kell. | ||
A | A leírás Debian 9.11 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 | A parancsok root jogot feltételeznek. (állandó root jog: sudo -i) | ||
==Előfeltételek== | |||
===Minimum követelmények=== | |||
*PHP 7.0.0+ | |||
*MySQL 5.5.8+ / MariaDB 5.1+ | |||
*Debian 9+ (amennyiben a környezetet az operációs rendszer tárolójából telepítettük) | |||
===Webszerver, adatbáziszerver és Php futtatókörnyezet telepítése=== | ===Webszerver, adatbáziszerver és Php futtatókörnyezet telepítése=== | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
apt- | apt -y install apache2 mysql-server php php-mysql php-mbstring php-xml php-pecl-http php-apcu php-intl | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Adatbázis létrehozása=== | ===Adatbázis létrehozása=== | ||
Feltételezve, hogy a mysql root felhasználónak konzolból nincs jelszava | 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 | *'''my_wiki''': adatbázis neve | ||
*wikiuser: adatbázis felhasználó neve | *'''wikiuser''': adatbázis felhasználó neve | ||
*password: adatbázis felhasználó jelszava | *'''password''': adatbázis felhasználó jelszava | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="bash"> | ||
CREATE DATABASE my_wiki CHARACTER SET utf8; | mysql -uroot -e "CREATE DATABASE my_wiki CHARACTER SET utf8; | ||
CREATE USER 'wikiuser'@'%' IDENTIFIED BY 'password'; | CREATE USER 'wikiuser'@'%' IDENTIFIED BY 'password'; | ||
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'%'; | GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'%';" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Webszerver konfigurálása=== | ===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. | |||
*ServerName: domain név, ami alatt a wiki elérhető lesz. (A domaint konfigurálni kell a kiszolgáló IP címéhez) | *'''VirtualHost''': a *:443 a https, a *:80 a http konfiguráció, ha csak az egyik kell, a másik elhagyható | ||
*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ó | *https konfiguráció | ||
**SSLCertificateFile: tanúsítvány fájl | **'''SSLCertificateFile''': tanúsítvány fájl | ||
**SSLCertificateKeyFile: privát kulcs file | **'''SSLCertificateKeyFile''': privát kulcs file | ||
**Include (opcionális): tanúsítvány lánc fájl | **'''Include''' (opcionális): tanúsítvány lánc fájl | ||
<syntaxhighlight lang="apacheconf"> | <syntaxhighlight lang="apacheconf"> | ||
<IfModule mod_ssl.c> | <IfModule mod_ssl.c> | ||
| 61. sor: | 50. sor: | ||
ServerAlias www.mydomain.com | ServerAlias www.mydomain.com | ||
ServerAdmin webmaster@mydomain.com | ServerAdmin webmaster@mydomain.com | ||
DocumentRoot | DocumentRoot [vhostdir] | ||
<Directory "/ | <Directory "/[vhostdir]/images"> | ||
AllowOverride None | AllowOverride None | ||
AddType text/plain .html .htm .shtml .phtml | AddType text/plain .html .htm .shtml .phtml | ||
| 82. sor: | 71. sor: | ||
ServerAlias www.mydomain.com | ServerAlias www.mydomain.com | ||
ServerAdmin webmaster@mydomain.com | ServerAdmin webmaster@mydomain.com | ||
DocumentRoot | DocumentRoot [vhostdir] | ||
<Directory " | <Directory "[vhostdir]/images"> | ||
AllowOverride None | AllowOverride None | ||
AddType text/plain .html .htm .shtml .phtml | AddType text/plain .html .htm .shtml .phtml | ||
php_admin_flag engine off | php_admin_flag engine off | ||
</Directory> | </Directory> | ||
ErrorLog ${APACHE_LOG_DIR}/error.log | ErrorLog ${APACHE_LOG_DIR}/error.log | ||
CustomLog ${APACHE_LOG_DIR}/access.log combined | CustomLog ${APACHE_LOG_DIR}/access.log combined | ||
</VirtualHost> | </VirtualHost> | ||
</syntaxhighlight>Apache konfiguráció<syntaxhighlight lang="bash"> | </syntaxhighlight>Apache konfiguráció érvényesítése:<syntaxhighlight lang="bash"> | ||
ln -s /etc/apache2/sites-available/mediawiki.conf /etc/apache2/sites-enabled/mediawiki.conf | ln -s /etc/apache2/sites-available/mediawiki.conf /etc/apache2/sites-enabled/mediawiki.conf | ||
service apache2 restart | service apache2 restart | ||
| 98. sor: | 88. sor: | ||
==Mediawiki motor telepítése== | ==Mediawiki motor telepítése== | ||
<syntaxhighlight lang="bash"> | A megfelelőMediawiki release letöltése és a fájl kogosultságok beállítása:<syntaxhighlight lang="bash"> | ||
wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31. | wget -qO- https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.X.tar.gz | tar -xzf - -C /tmp | ||
mv /tmp/mediawiki-1.31.X [vhostdir] | |||
chown -R www-data:www-data | chown -R www-data:www-data [vhostdir] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
A mediawiki telepítése böngészőben, a beállított domain használatával folytatható. pl: <nowiki>https://mydomain.com</nowiki> | A mediawiki telepítése böngészőben, a beállított domain használatával folytatható. pl: <nowiki>https://mydomain.com</nowiki> | ||
| 122. sor: | 111. sor: | ||
Konfigurációs fájl mentése | Konfigurációs fájl mentése | ||
[[Fájl:Screencapture-wiki-local-mw-config-index-php-2019-12-26-15 33 02.png|középre|bélyegkép|Wiki web install step 10]] | [[Fájl:Screencapture-wiki-local-mw-config-index-php-2019-12-26-15 33 02.png|középre|bélyegkép|Wiki web install step 10]] | ||
A letöltött LocalSettings.php fájlt a | A letöltött LocalSettings.php fájlt a '''/var/www/mediawiki/''' könyvtárba kell másolni. | ||
==Hasznos beállítások== | |||
===Natív html engedélyezése=== | ===Natív html engedélyezése=== | ||
A szerkesztőnek engedélyezni lehet, hogy html tartalmat illesszen az oldalba. | A szerkesztőnek engedélyezni lehet, hogy html tartalmat illesszen az oldalba. | ||
A '''/[vhostdir]/LocalSettings.php''' konfigurációs fájlba illesszük be a következőt:<syntaxhighlight lang="php"> | |||
$wgRawHtml = true; | $wgRawHtml = true; | ||
</syntaxhighlight>A bekapcsoláskor a <nowiki><html>...</html></nowiki> tagek közé helyezett html kódot nem értelmezi, | </syntaxhighlight>A bekapcsoláskor a <nowiki><html>...</html></nowiki> tagek közé helyezett html kódot nem értelmezi, változatlanul hagyja. | ||
[[mediawikiwiki:Manual:$wgRawHtml|Több információ]] | [[mediawikiwiki:Manual:$wgRawHtml|Több információ]] | ||
=== Feltölthető képméret növelése === | ===Feltölthető képméret növelése=== | ||
A '''/[vhostdir]/LocalSettings.php''' konfigurációs fájlba illesszük be a következő konfigurációs elemet. Lehetséges [[mediawikiwiki:Manual:$wgMaxImageArea|értékek és információ]] A php fájlfeltöltés méretét is növelni kell a php.ini, ha az kisebb a beállított értéknél.<syntaxhighlight lang="php"> | |||
$wgMaxImageArea = | $wgMaxImageArea = | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Kód kiemelés (code syntax highlighting) beállítása=== | |||
A telepített verzióban installálva van a [[mediawikiwiki:Extension:SyntaxHighlight|SyntaxHighlight]] bővítmény, de kell még pár beállítás, hogy működjön. | |||
Pygments Python modul futtathatóságának beállítása:<syntaxhighlight lang="bash"> | |||
chmod a+x /[vhostdir]/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize | |||
</syntaxhighlight>A '''/[vhostdir]/LocalSettings.php''' konfigurációs fájlba illesszük be a következő konfigurációs elemet.<syntaxhighlight lang="php"> | |||
$wgSyntaxHighlightModels[CONTENT_MODEL_SCRIBUNTO] = 'lua'; | |||
</syntaxhighlight> | |||
===E-mail beállítások=== | |||
A '''/[vhostdir]/LocalSettings.php''' konfigurációs fájlba illesszük be az alábbi konfigurációs elemeket. [[mediawikiwiki:Manual:$wgEnableEmail|További információ]]<syntaxhighlight lang="php"> | |||
$wgEnableEmail = true; // E-mail küldés engedélyezése | |||
$wgSMTP = [ | |||
'host' => "mail.example.com", // SMTP server domain vagy IP cím | |||
'IDHost' => "example.com", // SMTP helo név, tipikusan a wiki domain név | |||
'port' => 25, // SMTP server port | |||
'auth' => true, // SMTP authentikáció engedélyezése (true vagy false) | |||
'username' => "my_user_name", // SMTP user név | |||
'password' => "my_password" // SMTP jelszó | |||
]; | |||
$wgPasswordSender = "noreply@mydomain.com"; // általános e-mail feladó | |||
$wgEmergencyContact = "noreply@mydomain.com"; // rendszer riasztások e-mail feladó | |||
$wgEmailAuthentication = true; // e-mail megerősítése szükséges, hogy a rendszer e-mail küldjön a regisztrált címre | |||
$wgEmailConfirmToEdit = true; // e-mail megerősítése szükséges a wiki szerkesztéséhez | |||
== | </syntaxhighlight> | ||
==Egyéb funkciók== | |||
[[Mediawiki 1.31 LTS VisualEditor bővítmény telepítése Debian környezetben|Rich text szövegszerkesztő (VisualEditor)]] | |||
[[Mediawiki 1.31 LTS Active Directory integráció Debian-MySQL környezetben|Active Directory integráció]] | |||
[[Kategória:Mediawiki]] | |||
[[Kategória:Debian]] | |||
[[Kategória:Mediawiki 1.31 LTS]] | |||
A lap jelenlegi, 2020. október 26., 14:14-kori változata
Összefoglalás
A leírás a Mediawiki 1.31 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 9.11 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.0.0+
- MySQL 5.5.8+ / MariaDB 5.1+
- Debian 9+ (amennyiben a környezetet az operációs rendszer tárolójából telepítettük)
Webszerver, adatbáziszerver és Php futtatókörnyezet telepítése
apt -y install apache2 mysql-server php php-mysql php-mbstring php-xml php-pecl-http php-apcu php-intl
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:
ln -s /etc/apache2/sites-available/mediawiki.conf /etc/apache2/sites-enabled/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- https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.X.tar.gz | tar -xzf - -C /tmp
mv /tmp/mediawiki-1.31.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.
Hasznos beállítások
Natív html engedélyezése
A szerkesztőnek engedélyezni lehet, hogy html tartalmat illesszen az oldalba.
A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be a következőt:
$wgRawHtml = true;
A bekapcsoláskor a <html>...</html> tagek közé helyezett html kódot nem értelmezi, változatlanul hagyja.
Feltölthető képméret növelése
A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be a következő konfigurációs elemet. Lehetséges értékek és információ A php fájlfeltöltés méretét is növelni kell a php.ini, ha az kisebb a beállított értéknél.
$wgMaxImageArea =
Kód kiemelés (code syntax highlighting) beállítása
A telepített verzióban installálva van a SyntaxHighlight bővítmény, de kell még pár beállítás, hogy működjön.
Pygments Python modul futtathatóságának beállítása:
chmod a+x /[vhostdir]/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize
A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be a következő konfigurációs elemet.
$wgSyntaxHighlightModels[CONTENT_MODEL_SCRIBUNTO] = 'lua';
E-mail beállítások
A /[vhostdir]/LocalSettings.php konfigurációs fájlba illesszük be az alábbi konfigurációs elemeket. További információ
$wgEnableEmail = true; // E-mail küldés engedélyezése
$wgSMTP = [
'host' => "mail.example.com", // SMTP server domain vagy IP cím
'IDHost' => "example.com", // SMTP helo név, tipikusan a wiki domain név
'port' => 25, // SMTP server port
'auth' => true, // SMTP authentikáció engedélyezése (true vagy false)
'username' => "my_user_name", // SMTP user név
'password' => "my_password" // SMTP jelszó
];
$wgPasswordSender = "noreply@mydomain.com"; // általános e-mail feladó
$wgEmergencyContact = "noreply@mydomain.com"; // rendszer riasztások e-mail feladó
$wgEmailAuthentication = true; // e-mail megerősítése szükséges, hogy a rendszer e-mail küldjön a regisztrált címre
$wgEmailConfirmToEdit = true; // e-mail megerősítése szükséges a wiki szerkesztéséhez