dozentenmodulserver/README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104


bwLehrpool-Server - Management Server for Virtual Machines and Events
The bwLehrpool-Server is a bwLehrpool server application to manage virtual machines and events for study and coursework.
Already created virtual machines can be uploaded to the bwLehrpool-Server to share those virtual machines with students and workgroup members as well as link them to events.
A virtual machine download from the bwLehrpool-Server allows customization of virtual machines locally for your purposes.
Build
A build of the bwLehrpool-Server requires the installation of the build automation tool Maven and the Java development kit OpenJDK 8.
Dependencies
If a Maven offline build takes place (mvn -o), the following dependencies are required and must be built manually first:

master-sync-shared

Application
The bwLehrpool-Server application can be built automatically by calling Maven with the following command line call:
mvn clean package


A build of the bwLehrpool-Server application creates a Java archive file (*.jar) that can be found at target/dozmod-server-*-jar-with-dependencies.jar.
Configuration
Server
The bwLehrpool-Server application requires a Java property configuration file for its operation.
A template for this configuration file can be found at setup/config.properties.tmpl.
The template can be finalized with the dockerize utility using the following command line call where DOZMOD_* are environment variables to finalize the content of the configuration file:
export DOZMOD_DATABASE_HOST="192.168.200.20"
export DOZMOD_DATABASE_NAME="sat"
export DOZMOD_DATABASE_USER="root"
export DOZMOD_DATABASE_PASSWORD="dozmod"
export DOZMOD_DATABASE_LOCATION_TABLE=""
export DOZMOD_MASTER_SERVER_HOST="bwlp-masterserver.ruf.uni-freiburg.de"
export DOZMOD_MASTER_SERVER_PORT="9091"
export DOZMOD_MASTER_SERVER_USE_SSL="true"
export DOZMOD_SERVER_WEB_BIND_LOCALHOST="false"
export DOZMOD_VSTORE_PATH="/mnt/bwLehrpool"

# finalize the template content with values from environment variables
dockerize -template setup/config.properties.tmpl:config.properties


Logging
The logging of the bwLehrpool-Server application to the console is implemented with log4j.
Default Logging Configurations
The default logging configurations are specified in the property file under src/main/properties/log4j.properties.
This configuration file is packaged automatically into the bwLehrpool-Server application during a build.
Overwrite Logging Defaults
If logging configurations other than the defaults are required, the configuration file packaged into the bwLehrpool-Server application can be overwritten by specifying a custom configuration file.
The custom configuration file is specified by execute the bwLehrpool-Server application with the following command line call where <CONFIG> is an absolute path to the custom configuration file and <APP> is a path to the built bwLehrpool-Server application (Java archive file):
java -Dlog4j.configuration=file:<CONFIG> -jar <APP>


Execution
Standalone
An execution of the bwLehrpool-Server application requires an already finalized bwLehrpool-Server configuration file located in the current working directory.
This configuration file can be created from a configuration template as explained above.
Then, the bwLehrpool-Server application can be executed with the following command line call where <APP> is a path to the built bwLehrpool-Server application (Java archive file):
java -jar <APP>


Docker Infrastructure
This project also provides a Docker infrastructure (images, containers, networks, and volumes) in which the bwLehrpool-Server application can be embedded and executed for test purposes.
The infrastructure consists of the following services and is created and started automatically using docker-compose:


Service
Container
IPv4 Address
IPv6 Address


bwLehrpool-Server
dozmod-server
192.168.200.20
fd03:4b1d:5707:c8::14


MariaDB
dozmod-database
192.168.200.21
fd03:4b1d:5707:c8::15


phpMyAdmin
dozmod-phpmyadmin
192.168.200.22
fd03:4b1d:5707:c8::16


A Docker image of the bwLehrpool-Server application and its required infrastructure (images, containers, networks, and volumes) is created and started automatically with the following command line call:
mvn -P dozmod-server:start


The Docker infrastructure started with the above call uses the production default bwLehrpool-Master-Server of the University of Freiburg.
If the custom bwLehrpool-Master-Server of the Docker infrastructure from the masterserver repository should be used instead, the default configuration of the above command line call can be overwritten by using the following command line call instead:
mvn -P dozmod-server:start -P dozmod-server:config:custom-master-server


Note that the complete Docker infrastructure (images, containers, networks, and volumes) is created and started automatically after a start call.
To stop the bwLehrpool-Server container and its entire infrastructure, use the following command line call:
mvn -P dozmod-server:stop