summaryrefslogblamecommitdiffstats
path: root/dozentenmodul/README.md
blob: 81b1e9c9a17a7f5df0578acdeb693c2e9df7d960 (plain) (tree)













































                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               

bwSuite - Administration Client for Virtual Machines and Events

The bwSuite (bwLehrpool-Suite) is a bwLehrpool client application to create and administrate virtual machines for study and coursework. With the help of the bwSuite it is possible to download ready-to-use virtual machine templates, which you can adapt locally for your purposes. Then, the bwSuite is capable to upload these personalized virtual machines to the bwLehrpool-Server, create new events and link the virtual machines to created events. Additionally, permissions can be set to grant selected or all users access to virtual machines.

Build

A build of the bwSuite 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:

Application

The bwSuite application can be built automatically by calling Maven with the following command line call:

mvn clean package

A build of the bwSuite application creates a Java archive file (*.jar) that can be found at target/dozmod-client-*-jar-with-dependencies.jar.

Configuration

Logging

The logging of the bwSuite 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 bwSuite application during a build.

Overwrite Logging Defaults

If logging configurations other than the defaults are required, the configuration file packaged into the bwSuite application can be overwritten by specifiying a custom configuration file. The custom configuration file is specified by execute the bwSuite 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 bwSuite application (Java archive file):

java -Dlog4j.configuration=file:<CONFIG> -jar <APP>

Execution

The bwSuite application can be executed with the following command line call where <APP> is a path to the built bwSuite application (Java archive file):

java -jar <APP>