Allgemein
eWeBuKi benötigt keine spezielle Distribution um es zu installieren. Getestet wurde das Ganze unter Debian, SuSE, Fedora und EISFAIR. Doch eigentlich sollte jedes Linux funktionieren (Erfolgs Berichte erwünscht).
eWeBuki benutzt unter Linux: Apache(2) (mit “mod_rewrite”), PHP und MySQL. So weit bekannt können alle aktuellen PHP und MySQL Versionen verwendet werden. (Wenn nicht, Fehlermeldung an die Entwickler).
Quelle der Software
Es gibt zwar ein tar (Wegen BeliOS Schließung veraltet) Archiv was jede Nacht aktuell erstellt wird, aber eine Installation mit Subversion (svn) hat den Vorteil, dass sich alle Dateien jederzeit schnell aktualisieren lassen (svn update).
Installation mit Subversion
Um die Subversion-Install-Methode zu verwenden benötigt man natürlich zuerst die Subversion Tools. Subversion ist Bestandteil jeder Distribution und sollte sich ganz einfach über die jeweilige Software Verwaltung installieren lassen.
Hat man Subversion installiert, lässt sich das lokale eWeBuKi Repository ganz einfach erstellen.
svn co http://ewebuki.googlecode.com/svn/trunk/basement name_des_webroot
Das lädt das komplette eWeBuki aus dem Subversion Repository (svn) und speichert es in den Ordner "name_des_webroot" im aktuellen Verzeichnis.
Achtung: Soll der Inhalt dieses Ordners verschoben werden, darf man die versteckten Dateien nicht vergessen!
Wer noch mehr über Subversion wissen will, für den gibts die detaillierte Beschreibung für Entwickler.
Die Dateien
Damit eWeBuKi funktioniert muss man einige Dateien kopieren/umbenennen. Die wichtigste ist die .htaccess Datei im Webroot. Hier sind zusätzliche Tipps für beliebte Hosting Umgebungen.
mv .htaccess-dist .htaccess
Damit die Konfiguration beim Update geschützt ist, sind sämtliche Konfigurationsdateien im Subversion (svn) als *.php-dist abgelegt. Diese Dateien müssen in den unten genannten Verzeichnissen *.php kopiert/umbenannt werden.
conf/
modules/addon/
modules/admin/
modules/basic/
Besonders elegant geht es mit find und awk:
find . -name \*.php-dist | \
awk '{ printf "cp -a \"%s\" `dirname \"%s\"`/`basename \"%s\" .php-dist`.php\n",$0,$0,$0; }' | \
sh
Alternativ funktioniert auch ...
Debian: rename 's/php-dist$/php/' *.php-dist
SuSE: rename .php-dist .php *.php-dist
Midnight-Comander (mc): alle markieren; F5 Taste; source mask: *-dist; to: *
Die Datenbank
Das Werkzeug phpMyAdmin ist die einfachste Methode die Datenbanken zu verwalten und zu bearbeiten. phpMyAdmin ist inzwischen ebenfalls Bestandteil eigentlich jeder Distribution und lässt sich wohl am einfachsten mit deren Software Verwaltung installieren.
Zuerst erstellt man mit phpMyAdmin eine neue Datenbank (DB) und spielt dann in diese den dump aus dem sql Verzeichnis “sql/eWeBuKi.mysql.sql”.
Aus Sicherheitsgründen sollte man einen eigenen Benutzer einrichten, der nur auf diese Datenbank zugreifen kann. Der Benutzer benötigt nur die Rechte “select, insert, update und delete”.
Datenbank Name "db", Datenbank User "user" und Datenbank Passwort "pass" müssen in der Datei conf/site.cfg.php eingetragen werden.
// depends on: $_SERVER["SERVER_NAME"], http.conf: UseCanonicalName On/Off
$access["0"]["server"] = "dev0";
$access["0"]["host"] = "";
$access["0"]["db"] = "eWeBuKi";
$access["0"]["user"] = "changeme";
$access["0"]["pass"] = "changeme";
"server" - eWeBuKi versucht den Server auf dem es läuft selbst zu erkennen und die richtigen Zugangsdaten auszuwählen. Dazu muss "server" einen Teil des Server FQDN Namen enthalten.
Beispiel: Der Server hier heisst "ewebuki.de", in meiner Konfiguration steht also dort "ewebuki".
Mit $access["1"] könnte man so weitere Zugangsdaten z.B. für ein zusätzliches Testsystem hinterlegen und somit die Datei in beiden Installation ohne Änderung nutzen.
"host" - Wwird nur benötigt, wenn der DB Server nicht auf dem gleichen Rechner läuft.
"db" - Der Name der Datenbank die man erstellt hat.
"user" - Der Name des Benutzer den man erstellt hat.
"pass" - Ein sicheres Passwort: Ziffern, Sonderzeiche, Groß- und Kleinschreibung.
Achtung: Das Passwort “changeme” darf nicht verwendet werden, sonst hat man ein Sicherheitsloch wie ein Scheunentor im System!
Der erste Start
Erscheinen im Browser nach Eingabe der URL die Worte:
Glückwunsch Ihr eWeBuKi läuft!
hat man es geschafft.
Häufige Fehler
Allgemein:
- "AllowOverride All" im Webdir ist nicht gesetzt.
- Rechte der Dateien stimmen nicht.
- Gross- und Kleinschreibung wurde nicht beachtet.
Datei, Bilder Probleme:
- Die Bilder fehlen. Beim Apache 1.3 unter Debian ist "Alias /images/ /usr/share/images/" das Problem
- Upload Problem 1: Der User unter dem der webserver läuft, muss im Ordner "file/" schreiben können
- Upload Problem 2: Läuft Apache im safe_mode? - "chuid" wird benötigt!
- Upload Problem bei Bildern: Ist gd.so im apache geladen?
Hilft dass alles nichts, bitte diese Anleitung erneut Schritt für Schritt von Anfang an durchgehen.
Eigenes Design
Für ein eigenes Design benötigt man weitere Ordner für das eigene Design, die alle gleich benannt werden müssen. Der Name "design" kann dabei frei gewählt werden und muss zusätzlich in der Datei conf/site.cfg.php eingetragen werden.
$specialvars["default_design"] = "mein_design"; // design bezeichnung.
css/mein_design/
js/mein_design/
images/mein_design/
templates/mein_design/
Nur Dateien, die vom mitgelieferten Design abweichen sollen, werden in diesen Verzeichnissen angelegt.
BUG: Die "id=content" ist im Editor vergeben und führt wenn sie im eigenen Design verwendet wird dazu, dass die Javascript Funktionen des Content Editors nicht mehr funktionieren. Quick Fix: "contents" statt "content" verwenden
