added INSTALL (german installation manual) and started with crypt()ing
[aymargeddon/current.git] / INSTALL
1 Hier wird der Installationsvorgang eines Aymargeddon-Spiels beschrieben. Das ist leider alles noch sehr hakelig, wir entschuldigen uns für die Strapazen.
2
3
4 Vorraussetzungen
5 ================
6
7 Ihr benötigt:
8
9 *    Einen Rechner mit Linux als Betriebssystem (möglicherweise läuft es auch auf anderen Systemen, aber das hat bisher noch niemand probiert)
10 *    den Sourcecode (zu beziehen über "git clone http://aymargeddon.de/aymargeddon.git")
11 *    einen Apache2-Webserver
12 *    Embedded Perl auf diesem Server. Unter Debian squeeze tut es ein: 
13
14 apt-get install libembperl-perl
15
16 *    folgende Perl-Module müssen vorhanden sein: 
17
18      Date::Calc;
19      Mail::Mailer;
20      Data::Dumper;
21
22 *    MySQL als DBMS 
23
24 Wenn das alles läuft, könnt ihr loslegen.
25
26 Eigentliche Installation
27 ========================
28
29 *    Ihr müsst den Apache so konfigurieren, dass das Verzeichnis html/ aus dem Source zugänglich ist von außen und dort epl-Dateien ausgeführt werden können und das Embperl im src-Verzeichnis Module nachladen kann; zB via "PerlPostConfigRequire /etc/apache/startup.pl" und da dann so was in der Art: 
30      
31      use lib qw( /var/www/benni/aymargeddon.de/game/src );
32      1;
33
34 *    Ihr müsst die Datei src/FROGS/Config.pm an eure Gegebenheiten anpassen. Dabei erstmal nur den oberen Abschnitt anfassen.
35
36 *    Ihr müsst eine Datenbank RAGNAROEK in MySQL anlegen.
37
38 *    Ihr müsst einen DB-user "aymargeddon" in MySQL anlegen, der alle Rechte auf dieser DB hat (oder alternativ den Benutzernamen zusätzlich zu Config.pm in ein paar nicht-Perl-scripten ändern)
39
40 *    Ihr müsst eine lesegeschützte Datei an dem Ort anlegen, der in der Config beschrieben ist. In dieser Datei liegt das       Datenbankpasswort. 
41
42 *    Ihr müsst im Verzeichnis var/ den Befehl ./do_sql < RAGNAROEK.sql sowie ./do_sql < LOCALIZE.sql eingeben. (oder evntl.: ./init_server)
43
44 *    Ihr müsst im Verzeichnis src/ den Befehl create.pl <spielfeldgröße> ausführen. Dort dann den Namen des Spiels sowie die Spielgeschwindigkeit eingeben.
45
46 *    Ihr müsst im Verzeichnis src/FROGS/ den Befehl ./start_scheduler ausführen. 
47
48 Jetzt kanns losgehen.
49
50
51 Maintainance
52 ============
53
54 *    Das start_scheduler-script schreibt die logs in die Datei src/FROGS/++out. In der Standardkonfiguration wird noch eine Datei src/FROGS/+out mit sehr detailierten logs erzeugt. 
55
56 *    Mit dem Script backup in var kann man Backups der Datenbank dumpen.