====== Installation ======

Diese Installationsanleitung richtet sich an Programmierer und Benutzer, die auf ihrem eigenen Server DSAo-Md installieren wollen. Dies ist keine detaillierte Schritt-für-Schritt-Anleitung. Sie ist eher abstrakt und damit plattformunabhängig gehalten.

**Diese Dokumentation richtet sich nicht an Spieler. Zum Spielen ist diese Anleitung nicht nötig.**

===== Vorarbeit =====

Folgende Software sollte bereits installiert und funktionstüchtig sein:

  * Webserver (z.B. Apache oder lighttpd) mit PHP
  * MySQL-Server
  * Subversion (optional, s.u.)

**Achtung:** Die Seite [[http://framework.zend.com/manual/en/requirements.introduction.html|Voraussetzungen des Zend Frameworks]] enthält wichtige Informationen über zu benötigte PHP-Extensions usw.



===== Beziehen des Codes =====

Zunächst muss man sich den Quelltext von DSAo-Md herunterladen. Dazu gibt es zwei Möglichkeiten.

==== Letzte stabile Version herunterladen ====

Dies ist primär für Benutzer interessant, die auf ihrem Server DSAo-Md installieren wollen.

  * Zunächst muss also auf der [[http://sourceforge.net/project/showfiles.php?group_id=253156|SF-Downloadseite]] das letzte stabile Release heruntergeladen werden.
  * Nun wird das Archiv entpackt
  * Anschließend wird von der [[http://framework.zend.com/download/latest|Zend Framework-Downloadseite]] eines der beiden Pakete geladen (minimal genügt) und ebenfalls entpackt, und zwar wird der Unterordner /library/Zend nach /devel/lib/ entpackt
  * ggf. muss der Code (unterhalb des Ordners /devel/) nun auf den Server hochgeladen werden

==== SVN-Version ====

Für Entwickler und mutige Server-Betreiber bietet sich die etwas einfachere Installation über die letzte SVN-Version an. Genaue Installationsschritte befinden sich in unserem [[Versionsverwaltung|Artikel über die Versionsverwaltung]].

===== MySQL-Tabellen =====

Z.B. über phpMyAdmin kann eine Datenbank angelegt werden oder eine vorhandene Datenbank verwendet werden (Tabellenpräfices werden bisher nicht unterstützt). Nun müssen alle mitgelieferten SQL-Dateien in die Datenbank importiert werden.

===== Webservers =====

==== Apache ====
Getestet mit Revision 432 (letzte stable) unter Ubuntu 9.10 Karmic Koala mit bereits funktionierendem Apache + PHP + MySQL.
domain.tld ist dabei geeignet zu ersetzen. Als Test könnte man hier lokal einfach dsa angeben.
Wenn in der /etc/hosts dann die Zeile <code=bash>127.0.0.1 dsa</code> ergänzt wird kann im Internetnavigator unter http://dsa/ die Seite erreicht werden.

Damit Apache die Seite aber anzeigen kann muss die Datei /etc/apache2/ports.conf um folgende Zeile ergänzt werden:
<code=bash>NameVirtualHost domain.tld:80</code>
Eine neue Datei muss unter /etc/apache2/sites-enabled/ angelegt werden (Name z.B.: 001-dsao):
<code=bash><VirtualHost domain.tld:80>
RewriteEngine On
RewriteRule ^.*\.(js|ico|gif|jpg|png|css)(\?.*)? $0
RewriteRule .*\?(.*)$ /pfad/zum/dsao/ordner/devel/htdocs/index.php?$1
RewriteRule ^$ /pfad/zum/dsao/ordner/devel/htdocs/index.php
DocumentRoot /pfad/zum/dsao/ordner/devel/htdocs
</VirtualHost></code>
Dann per <code=bash>sudo apache2ctl restart</code> Apache neustarten und http://domain.tld/ (oder wie oben angegeben http://dsa/) aufrufen

==== lighttpd ====

In der Konfigurationsdatei muss folgendes am Anfang hinzugefügt werden:

<file>
# vhosts based on conditionals

$HTTP["host"] == "domain.tld" {
        server.document-root = "/path/to/dsao_md/devel/public"
        url.rewrite-once = (
                "^.*\.(js|ico|gif|jpg|png|css)(\?.*)?" => "$0",
                ".*\?(.*)$" => "/index.php?$1",
                "" => "/index.php"
        )
}
</file>

Weiterhin muss das Modul 'mod_access' aktiviert werden.


===== Konfiguration =====

Hier muss die Datei in /etc/config/config.ini.dist nach /etc/config/config.ini kopiert werden und entsprechend der jeweiligen Umgebung angepasst werden. Kommentare dazu befinden sich in der Datei selbst.

===== Benutzeraccounts =====

Standardmäßig existieren drei Benutzeraccounts:

^ Benutzername  ^ Passwort  ^ Funktion      ^
| admin         | Admin123  | Administrator |
| robb          | Robb1234  | Testbenutzer  |
| lock          | Lock1234  | Gesperrter B. |

Diese können gelöscht werden, zumindest aber sollten die Passwörter geändert werden.

Nun sollte das Spiel soweit einsatzfähig sein.

{{tag>code.veraltet}}