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      JSON
  22
  23      gibts alle auch als Debian-Pakete.
  24
  25 *    MySQL als DBMS
  26
  27 Wenn das alles läuft, könnt ihr loslegen.
  28
  29 Eigentliche Installation
  30 ========================
  31
  32 *    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/apache2/startup.pl" und da dann so was in der Art:
  33
  34      use lib qw( /var/www/benni/aymargeddon.de/game/src );
  35      1;
  36
  37 *    Ihr müsst die Datei src/FROGS/Config.pm an eure Gegebenheiten anpassen. Dabei erstmal nur den oberen Abschnitt anfassen.
  38
  39 *    Ihr müsst eine Datenbank RAGNAROEK in MySQL anlegen.
  40
  41 *    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)
  42
  43 *    Ihr müsst eine lesegeschützte Datei an dem Ort anlegen, der in der Config beschrieben ist. In dieser Datei liegt das       Datenbankpasswort.
  44
  45 *    Ihr müsst im Verzeichnis var/ den Befehl ./do_sql < RAGNAROEK.sql sowie ./do_sql < LOCALIZE.sql eingeben. (oder evntl.: ./init_server)
  46
  47 *    Ihr müsst im Verzeichnis src/ den Befehl create.pl <spielfeldgröße> ausführen. Dort dann den Namen des Spiels sowie die Spielgeschwindigkeit eingeben.
  48
  49 *    Ihr müsst im Verzeichnis src/FROGS/ den Befehl ./start_scheduler ausführen.
  50
  51 Jetzt kanns losgehen.
  52
  53
  54 Maintainance
  55 ============
  56
  57 *    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.
  58
  59 *    Mit dem Script backup in var kann man Backups der Datenbank dumpen.