Das Gameserver Webinterface ist dafür gedacht, auf einer LAN-Party bestimmte Gameserver (CS, COD, ..) auf Linux-Servern zu starten. Vorteil daran ist, man kann das Webinterface für etliche Server nutzen und muss nicht für jeden Server einzeln auf die Konsole gehen. Außerdem kann die Webseite z.B. an den Turnier-Support übergeben werden, damit diese ohne Linux- und Server-Kenntnisse mit einem Knopfdruck Gameserver bereitstellen können. Deswegen auch die unterschiedlichen Rechte für die Benutzer:

• User - darf Server anlegen, killen und sich die Übersicht angucken
• Admin - darf zusätzlich Server und Games einrichten - und darf unter "home" die Liste von gestorbenen Servern aufräumen - und ihm werden weitere Informationen angezeigt (z.B. beim Starten der Befehl, der ausgeführt wird) - und er darf die Server rebooten und herunterfahren
• Superadmin - darf zusätzlich User anlegen und editieren Dabei richtet sich der User an den Typischen Turnier-Support, der Gameserver bereitstellt, aber nichts mit den eigentlichen Servern zu tun hat. Dank des Score-Systems braucht der User kein Hintergrundwissen - Wenn er ein Gameserver starten will, werden ihm nur Server zur Auswahl gegeben, auf denen das Game auch läuft, auf denen noch genug Ressourcen frei sind und die erreichbar sind. Die Admins sind dann diejenigen, die die Server einrichten und administrieren. Der Cleanup z.B. darf nur von diesen ausgeführt werden, damit sie die Möglichkeit haben, nach Ursachen zu forschen. Übrigens: Beim Anlegen eines Users kann kein Passwort gesetzt werden - es wird ein default-Passwort gesetzt, was beim Anmelden vom User geändert werden muss.

• Einfaches Starten und Stoppen von Gameservern per Webinterface
• Stoppen mehrerer Gameserver gleichzeitig
• Unterschiedliche Berechtigungen
• Benutzerdefenierte Variablen in den Start-Befehlen für die Gameserver
• Default-Werte für die benutzerdefenierten Variablen
• Zuweisung der Games zu den Servern -> Games können nur auf den passenden Servern gestartet werden
• Score-System, damit nicht zu viele Gameserver auf einem Server gestartet werden können
• Übersicht mit laufenden Servern, Games und Scores, sowie farbliche Anzeige freier und ausgefallener Server
• Abgeschmierte Gameserver werden farblich markiert
• Nicht erreichbare Server werden farblich markiert und stehen nicht zum Starten von Games zur Verfügung
• Alle Gameserver werden mit dem Programm "screen" gestartet
• Passwortlose SSH-Verbindung vom Webinterface per SSH-Key auf die Server
• Herunterfahren und rebooten einzelner oder aller Server (Linux shutdown)
• Syncronisieren einer Gameserver-Installation auf beliebige andere Server (Nur ein Server muss aktualisiert werden - danach syncen)
• Anbindung an das dotlan-Turniersystem: Starten von Gameservern, wenn beide Teams bereit sind, stoppen wenn das Ergebnis eingetragen ist

ACHTUNG: Um die Sync-Funktion nutzen zu können, muss auf jedem Server (Quelle & Ziel) rsync installiert werden.

1. Pakete nachinstallieren apt-get install apache2 libapache2-mod-php5 php5-mysql mysql-server mysql-client sshpass screen
2. Daten in das htdocs Verzeichnis entpacken
3. SSH-Keys erzeugen (Passphrase leer lassen):
   ssh-keygen -f /etc/apache2/ssh_key_gswi
chown www-data:www-data /etc/apache2/ssh_key_gswi*
4. In der config.inc.php die MySQL-Daten anpassen (alles andere kann bleiben)
5. DB-Struktur einspielen: DB.sql
   mysql -u mysql_user -p mysql_db < DB.sql
6. Seite aufrufen

User: superadmin
PW: default

1. Auf dem dotlan-Server in der /etc/mysql/my.cnf einstellen, dass der Server auch auf externe IPs lauscht (bind-address)
2. Auf dem dotlan-Server einen MySQL-User anlegen: GRANT USAGE ON *.* TO 'gameserver_wi'@'%' IDENTIFIED BY '<HIER EIN SICHERES PW ...>';
GRANT SELECT ON `dotlan`.`t_teilnehmer` TO 'gameserver_wi'@'%';
GRANT SELECT ON `dotlan`.`t_turnier` TO 'gameserver_wi'@'%';
GRANT SELECT (nick, id) ON `dotlan`.`user` TO 'gameserver_wi'@'%';
GRANT SELECT ON `dotlan`.`events` TO 'gameserver_wi'@'%';
GRANT SELECT ON `dotlan`.`t_teilnehmer_part` TO 'gameserver_wi'@'%';
GRANT SELECT ON `dotlan`.`t_contest` TO 'gameserver_wi'@'%';
3. Auf dem Gameserver Webinterface Server in der config.inc.php die MySQL-Daten von dem dotlan-Server eintragen
   WICHTIG: Nutzt den oben eingerichteten User mit den wenigen Rechten und mit gutem Passwort!!
4. Auf dem Gameserver Webinterface Server in der config.inc.php ein sichere SOAP-PW eintragen ($soap_user und $soap_pw)
5. Das Verzeichnis "turnier_server" auf den dotlan-Server in das dotlan-Verzeichnis verschieben und in der index.php das gleiche SOAP-PW eintragen ($soap_user und $soap_pw)
6. Die Dotlan-Templates um einen Button erweitern (html/templates/tpl_name/turnier/turnier_contest_single.tpl und turnier_contest_team.tpl):
   <tr>
<td class="msghead3" colspan="2" style="padding: 2px 6px;">Contest-Server:</td>
</tr>
<tr>
<td class="msgrow1" colspan="2" style="padding: 2px 6px;">
<div align="center">
<input type="button" value="Contest-Server starten" onclick="location.href='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/turnier_server/?tcid={$tcid}&round={$round}';" style="font-weight: bold;"/>
</div>
</td>
</tr>
7. Auf dem Gameserver Webinterface Server einen Cronjob in die /etc/crontab eintragen:
   */1 * * * * www-data /usr/bin/php /var/www/cronjob_turniere.php > /dev/null 2>&1

• Hier gibt man Name, IP, User und Score an
• Wenn schon Games vorhanden sind, kann man dem Server games zuweisen - nur diese Games können dann auch auf dem Server gestartet werden
• Nach dem Hinzufuegen des Servers, in der Tabelle auf "Zugriff einrichten" klicken - danach kann das Webinterface auf den Server zugreifen

• Einzugeben ist:
  • Icon (Auflistung aller Dateien im Ordner "images/")
  • Name (Kurzname, ohne sonderzeichen etc - wird für den Screen-Namen benutzt) - z.B. "cs16" oder "css" oder "cod4" oder ...
  • CMD (Befehl zum Starten des Gameservers - hier können Variablen im Format ##varname## benutzt werden)
    • ##port## gibt den Server-Port an - der wird automatisch vergeben beim Starten
    • ##port1## ist ein weiterer verfügbarer Port, der z.B. für TV-Server verwendet werden kann - der wird automatisch vergeben beim Starten
    • Ansonsten kann man eigene Variablen vergeben, z.B. ##Servername## für den Namen und ##MaxPlayers## für die Anzahl der Spieler
    • Die eigenen Variablen werden beim Starten alle abgefragt
  • Defaults (Default-Werte für die eigenen(!) Variablen getrennt durch Semikolon ";")
    • Wenn man z.B. ##Servername## und ##MaxPlayers## defeniert hat, kann man als Defaults folgendes angeben: Servername xyz cs Server;11
    • Damit würden die Felder beim Starten automatisch mit "Servername xyz cs Server" und "11" gefüllt werden
    • Wichtig: Die Defaults müssen in der Reihenfolge angegeben werden, in der die variablen im CMD auftauchen
    • Für ##port## kann man keine Defaults angeben
  • Startport (Port, ab dem der nächste freie Port für den Server verwendet wird)
  • Score (Score-Wert, die dieses Game kostet)
  • Server (Liste der Server, auf denen dieses Game laufen kann)
• Ein Game kann nur auf den Servern gestartet werden, auf denen das Game zugewiesen ist

• Hier wird die Verknüpfung zwischen Gameserver und dotlan-Turnier eingestellt
• Ein Cronjob läuft jede Minute um die Server von beendeten Begegnungen (Ergebnis wurde eingetragen) automatisch zu stoppen
• Die Turnierserver werden auf irgendeinem Server gestartet, wo das Game laufen kann (siehe Games einrichten) und wo noch genug Score frei ist
• Gestartet wird ein Turnierserver von den Usern über das Dotlan-Modul "turnier_server"

• Die Server bekommen bestimmte Scores (z.B. 100)
• Die Games bekommen bestimmte Scores (z.B. cs16 = 10, css = 20)

Dann hat der Server 100 Score-Punkte zu verfügung - die Games kosten 20 bzw 10 Score-Punkte In diesem Beispiel können also maximal fünf css Gameserver auf dem Server gestartet werden, da 5 x 20 = 100 Wenn nur vier css Gameserver gestartet werden (4 x 20 = 80) können zusätzlich noch zwei cs16 auf diesem Server gestartet werden (2 x 10 = 20) - Zusammen macht das dann wieder 100 Wenn auf einem Server nicht mehr genug Score-Punkte für ein Gameserver verfügbar sind, steht dieser nicht zur Verfügung. Damit kann man die Last der Server automatisch beschränken und kontrollieren.