Benötigte Software

• Java 1.6 JDK (http://www.sun.com)
• Apache Ant (http://ant.apache.org)
• MySQL 5.0 mit konfigurierter InnoDB (http://www.mysql.org)

Optionale Software

• Unter Windows dringend empfohlen: die GNU-Tools (http://www.cygwin.com oder http://gnuwin32.sourceforge.net) - Bitte die PATH-Variable entsprechend setzen!
• Eclipse (http://www.eclipse.org)
• Eine gute Konsole (http://www.gentoo.org oder http://www.debian.org oder ein anderes *nix )

Download

Um Momentan den Sourcecode herunterzuladen wird Mercurial benötigt, da der Sourcecode mit diesem Revision Control System verwaltet wird. Das System ist dezentral, daher kann man anschließend auf seiner lokalen Kopie nach Lust und Laune Commiten, Branchen usw.

Es stehen zwei Varianten von DS zur Verfügung. Einmal der Entwicklungszweig (SDS) sowie auf der anderen Seite der stabile Zweig (RDS).

Hinweis: Die Grafiken sind nicht Teil der Downloads

Download via Mercurial

Folgenden Befehl in der Kommandozeile ausführen:

hg clone http://dev.drifting-souls.net/repositories/sds/ ds2j-opensource

Anschließend gibt es ein neues Verzeichnis "ds2j-opensource", in dem sich der aktuellste Stand von SDS befindet (sowie der Rest der Repository-Daten).

Um statt SDS RDS zu zu erhalten muss folgender Befehl eingegeben werden:

hg clone http://dev.drifting-souls.net/repositories/rds/ ds2j-opensource

Installation

1. Eine neue Datenbank fuer DS2 anlegen (z.B. "ds2")
2. Einen neuen Benutzer mit Zugriffsrechten auf die Datenbank anlegen
3. Ins DS-Verzeichnis wechseln
4. Die SQL-Scripte im Verzeichnis db/tables/ sowie db/functions.sql in die Datenbank einspielen (Auf die Reihenfolge achten! Erst alle sql mit _create am Ende, dann prüfen dass alle Tabellen das Format "InnoDB" haben, falls nicht ändern. Danach alle sql mit _alter einspielen und danach erst alle sql mit _insert.
5. Im Unterverzeichnis web/WEB-INF/ die Datei web.sample.xml kopieren, und die Kopie in web.xml umbenennen und den configpath anpassen (in der Regel "Pfad/zum/Buildverzeichnis/WEB-INF/cfg/")
6. Im Unterverzeichnis web/WEB-INF/cfg/ die Datei config.sample.xml kopieren, und die Kopie in config.xml umbenennen die Pfade sowie die Datenbankzugangsdaten editieren. (Achtung: Die Pfade müssen auch existieren! D.h. die entsprechenden Ordner müssen angelegt sein. Im Lox-Ordner müssen die Unterordner "tick" "raretick" und "battles" vorhanden sein.)
7. In der Konsole in das Verzeichnis von DS2 wechseln
8. "ant antlr" aufrufen um den RoleLexer aufzubauen
9. "ant check-install" aufrufen um die Installation zu ueberpruefen ( Sollte er hier "Lox-Pfad" anmeckern bitte Punkt 6 nochmal checken.)
10. "ant templates compile" aufrufen
11. "ant run" aufrufen um den integrierten Webserver (Jetty wenn es interessiert) aufzurufen. (Hinweis: Solltet ihr in der config.xml "URL" geaendert haben so müsst ihr die Variable "jetty.contextpath" in der build.properties ebenfalls anpassen. Oder aber "URL" wieder auf "http://localhost:8080/driftingsouls" setzen)

Tomcat

Wenn ihr statt des integrierten Webservers Tomcat verwenden wollt, so müsst ihr den Context in eure server.xml eintragen. Schritt 10 entfällt dann.

Da DS Spring und Aspekte verwendet, muss für den Context die Classloader-Konfiguration geändert werden. Insgesamt sieht der Kontext dann wie folgt aus:

<Context path="/driftingsouls" docBase="/pfad/zu/eurer/ds/installation/build" reloadable="false">

	<!-- please note that useSystemClassLoaderAsParent is available since Tomcat 5.5.20 / remove if previous versions are being used -->

	<Loader loaderClass="org.springframework.instrument.classloading.tomcat.TomcatInstrumentableClassLoader" useSystemClassLoaderAsParent="false"/>

</Context>

Es ist wichtig, dass ihr das Build-Verzeichnis eurer DS-Installation angebt und nicht web!

Neben der Einrichtung des Contexts ist noch ein weiterer Schritt notwendig. Und zwar müsst ihr das spring-tomcat-weaver.jarin das Tomcat-Verzeichnis (im Falle von Tomcat 5.5 /pfad/zum/tomcat/server/lib/ - bei anderen Tomcat-Versionen kann das Verzeichnis abweichen) kopieren.

Login

Stellt sicher, dass euer Tomcat gestartet ist. Ruft dann im Webbrowser die Url http://localhost:8080/driftingsouls/ auf.
In der Datenbank sind eine Reihe von Accounts vorhanden. Alle haben das Passwort test (Ausgenommen ID 0. Ein Login dort ist aber auch nicht sinnvoll) Hinweis: Das Passwort für alle vorhandenen Accounts lautet "test", ausgenommen dem Account mit der ID 0

Alternativ könnt ihr euch natürlich einen eigenen Account anlegen. Da ihr vmlt. jedoch keinen Mailserver installiert habt müsst ihr das Passwort anschließend per Hand setzen. Geht dazu in die Datenbank in die Tabelle Users. Dort steht in der Spalte passwort das Passwort mittels md5 verschlüsselt. Am einfachsten ist es das Passwort eines der anderen Accounts zu kopieren (und wundert euch bitte nicht über die Exceptions in der Tomcat-Ausgabe. Die Melden nur, dass keine Verbindung zum Mailserver aufgebaut werden konnte).

Eigenen Account anlegen

Um nun einen eigenen Account anlegen zu können müsst ihr ersteinmal eines der Systeme mit Asteroiden und Nebeln füllen. Loggt euch dazu in den GTU-Account ein (dieser hat Administrationsrechte). Im Adminmenü unter Objekte findet ihr nun den Punkt hinzufügen. Erzeugt damit einige Asteroiden und Nebel.
Nun wechselt wieder in das Portal. Wählt registrieren aus und gebt eure Daten ein. Wenn euch als Startsystem ein anderes als das empfohlen wird, welches ihr mit Nebeln und Asteroiden gefüllt habt, ändert unbedingt die Auswahl! Nach dem Registrieren solltet ihr das Passwort via Email erhalten haben, sofern ihr über einen Mailserver verfügt. Wenn dies jedoch nicht der Fall ist wechselt in die Datenbank und dort in die Tabelle Users und kopiert den Inhalt des Feldes passwort von einem der anderen Accounts in euren neuerstellten Account hinein. Ihr könnt nun dieses Passwort zum Einloggen benutzen.