Virtueller Campus. Virtueller Campus Horw mit interaktiver Steuerung. HowTo: Server in Betrieb nehmen

Transkript

1 Virtueller Campus Virtueller Campus Horw mit interaktiver Steuerung HowTo: Bachelor Diplomarbeit FS 2013

2 HowTo: Inhaltsverzeichnis 1. EINLEITUNG WONDERLAND.JAR AUF SERVER KOPIEREN NUTZUNG DES START/STOP SCRIPT... 3 Abbildungsverzeichnis ABBILDUNG 1: MIT WINSCP WONDERLAND.JAR AUF DEN SERVER KOPIEREN... 1 Dominik Alessandri I

3 1. Einleitung Um einen Open Wonderland Server starten zu können, sind folgende Vorbedingungen nötig: Server (Ubuntu Linux) mit installiertem JDK o Firewall-Konfiguration: landconfigurefirewall05.pdf Wonderland.jar o Selber kompilieren o Download unter: SSH-Zugang auf Server 2. Wonderland.jar auf Server kopieren Mit der Software WinSCP können Dateien über eine grafische Oberfläche vom Host auf den Server geladen werden. Am einfachsten legt man einen Ordner im Home-Verzeichnis des Benutzers an, wo alle Dateien für den Betrieb des Open Wonderland Servers reinkommen: student@virt-class-alessa:~$ pwd /home/student student@virt-class-alessa:~$ mkdir OpenWonderWorld student@virt-class-alessa:~$ ls Downloads log.txt OpenWonderWorld Der Ordner ist nun angelegt. Mit WinSCP kann nun die Datei Wonderland.jar auf den Server kopiert werden. Abbildung 1: Mit WinSCP Wonderland.jar auf den Server kopieren Dominik Alessandri 1

4 Server stoppen / starten Um den Server korrekt starten zu können, braucht es ein File namens my.run.properties. In dieser Datei werden grundlegende Konfigurationen für den Server definiert. Die Datei für unseren Entwicklungs-Server sieht wie folgt aus: # Default directories for deployment files #wonderland.config.dir=$path{user.home}/.wonderlandserver/%wonderland_version% wonderland.webserver.wfs.root=${wonderland.config.dir}/wfs wonderland.webserver.modules.root=${wonderland.config.dir}/modules wonderland.log.dir=${wonderland.config.dir}/log wonderland.run.dir=${wonderland.config.dir}/run # Whether or not to automatically start any configured apps (such as the # Darkstar server) when the web server starts up wonderland.runner.autostart=true # Whether or not to shutdown any applications launched through the web # UI when the web server exits wonderland.runner.autostop=true #The IP address of the web server wonderland.webserver.host= #Enable persistence of the virtual world between server restarts # None - the database is cleared on each restart # Full - all state is persisted between restarts #wonderland.sgs.persistence=none wonderland.security.allow.guest.login=true Alle möglichen Einstellungen dieser Konfigurationsdatei findet man unter Nun sind alle Bedingungen erfüllt, dass der Server gestartet werden kann. Um zu prüfen, ob im Moment ein OWL Server gestartet ist, kann folgendes Kommando verwendet werden: student@virt-class-alessa:~$ ps aux grep «java jar» root ? S May24 0:00 sudo -u pawi -i java -jar /home/pawi/wonderland/wonderland.jar /home/pawi/wonderland/my.run.properties pawi ? Sl May24 19:08 java -jar /home/pawi/wonderland/wonderland.jar /home/pawi/wonderland/my.run.properties pawi pts/1 S+ 10:32 0:00 grep --color=auto java -jar Der Open Wonderland Server läuft also zu diesem Zeitpunkt. Dominik Alessandri 2

5 Stoppen kann man den Server mit dem folgenden Kommando, wobei die PID aus dem vorherigen Kommando gelesen werden muss. kill [PID] Der Prozess ist jetzt gestoppt und kann wieder neu gestartet werden. Das Startkommando sieht wie folgt aus: nohup java -jar Wonderland.jar my.run.properties Mar 16, :01:05 AM org.jdesktop.wonderland.webserver.launcher.webserverlauncher main Wonderland web server started successfully. Log files are in /home/student/.wonderland-server/0.5-dev/log Web server running on Nohup bewirkt, dass der Output des folgenden Prozesses in die Datei nohup.out umgeleitet wird und somit nicht die Shell vollschreibt. Der Prozess läuft nun als Child-Prozess der Shell. Man muss ihn nun noch in den Hintergrund verschieben, damit der Prozess weiterläuft, wenn der Benutzer sich abmeldet. Dafür wird der Prozess zuerst mit Ctrl+z pausiert. Mit folgendem Kommando kann ein angehaltener Prozess der Shell im Hintergrund weiter laufen: bg %1 [1]+ java -jar Wonderland.jar my.run.properties & Der User kann sich nun normal von der Shell abmelden. 3. Nutzung des Start/Stop Script Auf dem Server des virtuellen Campus ist nebst dem Start mit den normalen Befehlen auch ein Start über ein Startup-Script möglich. Dieses Script wurde auf dem Server als Dienst eingerichtet und kann sofort verwendet werden. Um den Wonderland Server der aktuellen Ressource ( ) des virtuellen Campus zu stoppen muss folgender Befehl in Putty ausgeführt werden: /etc/init.d/wonderland-d stop Um den Server danach wieder zu starten, muss der Parameter am Ende auf START gewechselt werden. /etc/init.d/wonderland-d start Das Start/Stop Script befindet sich auf der Enterpiselab Ressource im Verzeichnis /home/pawi/wonderland/wonderland-d. Diese Datei ist im /etc/init.d mittels einem Systemlink verlinkt. Dominik Alessandri 3