Server/MediaWiki: Unterschied zwischen den Versionen

Aus Wiki StuRa HTW Dresden
Zur Navigation springen Zur Suche springen
Zeile 172: Zeile 172:
: http://localhost
: http://localhost


<!--
 
: <code>$EDITOR /usr/local/etc/apache24/httpd.conf</code>
* Beginn der restlichen Installation über das web user interface
 
Bei einer Prüfung der Funktionalitäten bei der restlichen Installation über das web user interface weist MediaWiki auf Dienste hin, die es gern nutzen möchte, jedoch bisher nicht installiert sind.
: Installieren der Versionsverwaltung git
:: <code>pkg install git</code>
: Installieren von einer Ergänzung zu Sprachen für PHP
:: <code>pkg install pecl-intl</code>
: Installieren von einer Ergänzung zur Verarbeitung von Bildern für PHP
:: <code>pkg install pecl-imagick</code>
: Installieren von einer Ergänzung zum Nutzen eines Cache für PHP
:: <code>pkg install pecl-APC</code>
 
Auch wird geprüft, wie der Web-Dienst ausgeliefert wird.
: Anpassung der administrativen Mail-Adresse für den Webserver Apache (2.4)
:: <code>$EDITOR /usr/local/etc/apache24/httpd.conf</code>
<pre>
<pre>
#ServerAdmin you@example.com
#ServerAdmin you@example.com
ServerAdmin wiki@stura.htw-dresden.de
ServerAdmin mediawiki@stura.htw-dresden.de
</pre>
</pre>
: <code>$EDITOR /usr/local/etc/apache24/httpd.conf</code>
: Eintragung des Namens des Servers, der die Domain, im Zweifelsfall (etwa mangels DNS) eine IP-Adresse, ist und den Port für den Webserver Apache (2.4) angibt
:: <code>$EDITOR /usr/local/etc/apache24/httpd.conf</code>
<pre>                                                                           
<pre>                                                                           
ServerName 141.56.50.13:80                                                   
ServerName 141.56.50.13:80                                                   
</pre>
</pre>
: <code>pkg install pecl-intl</code>
: <code>pkg install pecl-imagick</code>
: <code>pkg install pecl-APC</code>


erneutes Starten des Webservers Apache
erneutes Starten des Webservers Apache
: <code>/usr/local/sbin/apachectl restart</code>
: <code>/usr/local/sbin/apachectl restart</code>
-->
* Beginn der restlichen Installation über das web user interface


Durchführung der restlichen Installation über das web user interface
Durchführung der restlichen Installation über das web user interface

Version vom 18. Dezember 2014, 14:34 Uhr

Achtung

Dieser Artikel ist ein exemplarischer Artikel.

Es handelt sich hierbei nicht um die Instanz MediWiki als Wiki vom StuRa. Dazu dienen die Artikel:

Installation

Randbedingungen

OS
FreeBSD 10.1
Paketverwaltung
freebsd-man:pkgng (statt freebsd-man:make)

tatsächliche Installation

Initialisieren von pkgng

pkg

Installieren von MediWiki

  • Leider muss eine bestimmte Version zur Installation angegeben werden.
    • Welche Versionen zur Installation zur Verfügung stehen, kann durch eine Suche nach verfügbaren Paketen zu mediawiki herausgefunden werden.
      pkg search mediawiki
pkg install mediawiki124

Installation eines Datenbankservers

  • MediaWiki unterstützt eine Vielzahl von Datenbanken (z. B. SQLite, PostgreSQL oder MariaDB). MySQL ist die übliche Vorauswahl, so auch bei FreeBSD.
pkg install mysql55-server

Starten von MySQL als Server für die Datenbank

/usr/local/etc/rc.d/mysql-server onestart

Obligatorisches Aktualisieren von MySQL zum Prüfen der Funktionsfähigkeit durch sich selbst

/usr/local/bin/mysql_upgrade

Eintragung in die Datei zur Konfiguration der Umgebung des System, dass MySQL nach einem mögliche Neustart laufen soll

echo 'mysql_enable="yes"' >> /etc/rc.conf

Installation eines Webservers

  • MediaWiki kann durch eine Vielzahl von Web-Diensten (z. B. nginx) ausgeliefert. Apache ist die übliche Vorauswahl, so auch bei FreeBSD.
pkg install apache24

Eintragung in die Datei zur Konfiguration der Umgebung des System, dass Apache (2.4) nach einem mögliche Neustart laufen soll

echo 'apache24_enable="yes"' >> /etc/rc.conf

Installieren des Moduls zur Verwendung von PHP für Web-Dienste

pkg install mod_php5
Eintragung des gewünschten Umgangs von Anwendungen mit Dateien der Endung php
echo '<FilesMatch "\.php$">' >> /usr/local/etc/apache24/httpd.conf
echo 'SetHandler application/x-httpd-php' >> /usr/local/etc/apache24/httpd.conf
echo '</FilesMatch>' >> /usr/local/etc/apache24/httpd.conf
echo '<FilesMatch "\.phps$">' >> /usr/local/etc/apache24/httpd.conf
echo 'SetHandler application/x-httpd-php-source' >> /usr/local/etc/apache24/httpd.conf
echo '</FilesMatch>' >> /usr/local/etc/apache24/httpd.conf
oder
$EDITOR /usr/local/etc/apache24/httpd.conf
<FilesMatch "\.php$">
	SetHandler application/x-httpd-php
</FilesMatch>
<FilesMatch "\.phps$">
	SetHandler application/x-httpd-php-source
</FilesMatch>

Erzeugen eines Accounts für die Datenbank MySQL und das Setzen des dazugehörigen Passwortes

/usr/local/bin/mysqladmin --user=name-of-the-user-in-mysql password "password-of-the-user-in-mysql"

Anpassen der Datei für die Konfiguration vom Webserver Apache (2.4)

  • Abschaltung des allgemeinen globalen Verbietes des Zugriffs
    $EDITOR /usr/local/etc/apache24/httpd.conf
#<Directory />                                                               
#	AllowOverride none                                                      
#	Require all denied
#</Directory>
  • Ändern des zentralen Verzeichnisses wo sich die Daten befinden, die als Webdienst ausgeliefert werden sollen
    $EDITOR /usr/local/etc/apache24/httpd.conf
#DocumentRoot "/usr/local/www/apache24/data"
DocumentRoot "/usr/local/www/mediawiki"
  • Ergänzen des Einbeziehens vom Verzeichnis wo MediaWiki beheimatet ist
    echo '<Directory "/usr/local/www/mediawiki">' >> /usr/local/etc/apache24/httpd.conf
    echo 'Options Indexes FollowSymLinks' >> /usr/local/etc/apache24/httpd.conf
    echo 'DirectoryIndex index.php index.html' >> /usr/local/etc/apache24/httpd.conf
    echo 'AllowOverride None' >> /usr/local/etc/apache24/httpd.conf
    echo 'Order allow,deny' >> /usr/local/etc/apache24/httpd.conf
    echo 'Allow from all' >> /usr/local/etc/apache24/httpd.conf
    echo '</Directory>' >> /usr/local/etc/apache24/httpd.conf
    oder
    $EDITOR /usr/local/etc/apache24/httpd.conf
<Directory "/usr/local/www/mediawiki">
	Options Indexes FollowSymLinks
	DirectoryIndex index.php index.html
	AllowOverride None
	Order allow,deny
	Allow from all
</Directory>

Starten des Webservers Apache

/usr/local/sbin/apachectl restart

Prüfen des erfolgreichen Auslieferns des Web-Dienstes

http://localhost


  • Beginn der restlichen Installation über das web user interface

Bei einer Prüfung der Funktionalitäten bei der restlichen Installation über das web user interface weist MediaWiki auf Dienste hin, die es gern nutzen möchte, jedoch bisher nicht installiert sind.

Installieren der Versionsverwaltung git
pkg install git
Installieren von einer Ergänzung zu Sprachen für PHP
pkg install pecl-intl
Installieren von einer Ergänzung zur Verarbeitung von Bildern für PHP
pkg install pecl-imagick
Installieren von einer Ergänzung zum Nutzen eines Cache für PHP
pkg install pecl-APC

Auch wird geprüft, wie der Web-Dienst ausgeliefert wird.

Anpassung der administrativen Mail-Adresse für den Webserver Apache (2.4)
$EDITOR /usr/local/etc/apache24/httpd.conf
#ServerAdmin you@example.com
ServerAdmin mediawiki@stura.htw-dresden.de
Eintragung des Namens des Servers, der die Domain, im Zweifelsfall (etwa mangels DNS) eine IP-Adresse, ist und den Port für den Webserver Apache (2.4) angibt
$EDITOR /usr/local/etc/apache24/httpd.conf
                                                                           
ServerName 141.56.50.13:80                                                   

erneutes Starten des Webservers Apache

/usr/local/sbin/apachectl restart

Durchführung der restlichen Installation über das web user interface

Eintragen der nach dem Abschluss der restlichen Installation über das web user interface erstellten Datei LocalSettings.php

$EDITOR /usr/local/www/mediawiki/LocalSettings.php

tatsächliche Installation Siehe auch

ergänzende Installation

VisualEditor installieren

Installieren von npm (Paketverwaltung von node.js)

pkg install npm
pkg install git

Wechseln in ein beliebiges Verzeichnis, wo dann Parsoid installiert werden soll

cd /usr/local/www

Klonen (via git) von Parsoid in das aktuelle Verzeichnis

git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid

Wechseln in das eben erstellte Verzeichnis, wo Parsoid installiert werden soll

cd parsoid

mit npm verwaltetes Installieren von Parsoid

npm install

Erzeugen einer vorgefertigten Datei zur Konfiguration von Parsoid

cp api/localsettings.js.example api/localsettings.js

Anpassen der Datei zur Konfiguration von Parsoid

$EDITOR api/localsettings.js
/*                                                                            
        parsoidConfig.setInterwiki( 'localhost', 'http://localhost/w/api.php' );
*/                                                                            
        parsoidConfig.setInterwiki( 'localhost', 'http://141.56.50.13/api.php' );

Testweises Starten von Parsoid

node api/server.js
http://localhost:8000
http://localhost:8000/localhost/Hauptseite

Ergänzen der Einträge für Parsoid in die Datei zu Konfiguration von MediaWiki

$EDITOR /usr/local/www/mediawiki/LocalSettings.php
// URL to the Parsoid instance
// MUST NOT end in a slash due to Parsoid bug
$wgVisualEditorParsoidURL = 'http://141.56.50.13:8000';

// Interwiki prefix to pass to the Parsoid instance
// Parsoid will be called as $url/$prefix/$pagename
$wgVisualEditorParsoidPrefix = 'localhost';

Heraussuchen der zur Version von MediaWiki passenden Version

https://www.mediawiki.org/wiki/Special:ExtensionDistributor/VisualEditor

Herunterladen des Paketes

cd /tmp && curl -Ok# https://extdist.wmflabs.org/dist/extensions/VisualEditor-REL1_24-af11aa1.tar.gz

Entpacken des Paketes an die passende Stelle, im Unterverzeichnis extensions, wo MediaWiki beheimatet ist

cd /tmp && tar -xzf VisualEditor-REL1_24-af11aa1.tar.gz -C /usr/local/www/mediawiki/extensions

mit npm verwaltetes Installieren von VisualEditor in dem Verzeichnis der Extention

cd /usr/local/www/mediawiki/extensions/VisualEditor && npm install

Ergänzen der Einträge für Parsoid in die Datei zu Konfiguration von MediaWiki

$EDITOR /usr/local/www/mediawiki/LocalSettings.php
require_once "$IP/extensions/VisualEditor/VisualEditor.php";

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

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

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

Wechseln in das Verzeichnis von Parsoid und dortiges Starten des Dienstes, der dann dort im Hintergrund laufen soll

cd /usr/local/www/parsoid && node api/server.js &

Semantic MediaWiki installieren