xHowTo_Server in Betrieb nehmen
Werbung
Virtueller Campus
Virtueller Campus Horw mit interaktiver
Steuerung
HowTo: Server in Betrieb nehmen
Bachelor Diplomarbeit FS 2013
BDA „Virtueller Campus Horw mit interaktiver Steuerung“
HowTo: Server in Betrieb nehmen
Hochschule Luzern
Technik & Architektur
Inhaltsverzeichnis
1.
EINLEITUNG .......................................................................................................................... 1
2.
WONDERLAND.JAR AUF SERVER KOPIEREN ........................................................................... 1
3.
NUTZUNG DES START/STOP SCRIPT ....................................................................................... 3
Abbildungsverzeichnis
ABBILDUNG 1: MIT WINSCP WONDERLAND.JAR AUF DEN SERVER KOPIEREN ........................................................ 1
Dominik Alessandri
Christian Wietlisbach
I
BDA „Virtueller Campus Horw mit interaktiver Steuerung“
Hochschule Luzern
Server in Betrieb nehmen
Technik & Architektur
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:
http://openwonderland.googlecode.com/svn/www/wiki/backup/pdf/ProjectWonder
landConfigureFirewall05.pdf
Wonderland.jar
o Selber kompilieren
o Download unter: http://openwonderland.org/download/binary
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
Christian Wietlisbach
1
BDA „Virtueller Campus Horw mit interaktiver Steuerung“
Hochschule Luzern
Server in Betrieb nehmen
Technik & Architektur
2.1.1.
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=147.88.213.98
#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
http://wiki.openwonderland.org/Wiki.jsp?page=Server%20Properties.
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
4322 0.0 0.0 49808 1212 ?
S
May24
0:00
sudo -u pawi -i java -jar /home/pawi/wonderland/Wonderland.jar
/home/pawi/wonderland/my.run.properties
pawi
4326 0.1 28.6 3184596 882460 ?
Sl
May24 19:08 java -jar /home/pawi/wonderland/Wonderland.jar
/home/pawi/wonderland/my.run.properties
pawi
7154 0.0 0.0
9564
916 pts/1
S+
10:32
0:00
grep --color=auto java -jar
Der Open Wonderland Server läuft also zu diesem Zeitpunkt.
Dominik Alessandri
Christian Wietlisbach
2
BDA „Virtueller Campus Horw mit interaktiver Steuerung“
Hochschule Luzern
Server in Betrieb nehmen
Technik & Architektur
Stoppen kann man den Server mit dem folgenden Kommando, wobei die PID aus dem vorherigen
Kommando gelesen werden muss.
student@virt-class-alessa:~$ kill [PID]
Der Prozess ist jetzt gestoppt und kann wieder neu gestartet werden. Das Startkommando sieht wie
folgt aus:
student@virt-class-alessa:~/OpenWonderWorld$ nohup java -jar Wonderland.jar my.run.properties
Mar
16,
2013
11: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 http://147.88.213.98:8080/
----------------------------------------------------------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:
student@virt-class-alessa:~/OpenWonderWorld$ 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 (147.88.213.71) des virtuellen Campus zu stoppen muss folgender Befehl in Putty ausgeführt werden:
pawi@virtClass:~$ /etc/init.d/wonderland-d stop
Um den Server danach wieder zu starten, muss der Parameter am Ende auf „START” gewechselt
werden.
pawi@virtClass:~$ /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
Christian Wietlisbach
3
