summaryrefslogtreecommitdiffstats
path: root/dozentenmodulserver
diff options
context:
space:
mode:
authorManuel Bentele2021-05-25 07:59:56 +0200
committerManuel Bentele2021-05-25 07:59:56 +0200
commit448efdb25558d1b53109a442db94ae6b3844d9a2 (patch)
tree1bdb760154dd6f2634142fdebdb2161355f09697 /dozentenmodulserver
parent[client,server] Add doc about how to build and configure server and client (diff)
downloadtutor-module-448efdb25558d1b53109a442db94ae6b3844d9a2.tar.gz
tutor-module-448efdb25558d1b53109a442db94ae6b3844d9a2.tar.xz
tutor-module-448efdb25558d1b53109a442db94ae6b3844d9a2.zip
[client,server] Add a newline after each sentence in the documentation
Diffstat (limited to 'dozentenmodulserver')
-rw-r--r--dozentenmodulserver/README.md21
1 files changed, 15 insertions, 6 deletions
diff --git a/dozentenmodulserver/README.md b/dozentenmodulserver/README.md
index 1a224197..2e2da57c 100644
--- a/dozentenmodulserver/README.md
+++ b/dozentenmodulserver/README.md
@@ -1,6 +1,8 @@
# bwLehrpool-Server - Management Server for Virtual Machines and Events
-The bwLehrpool-Server is a [bwLehrpool](https://www.bwlehrpool.de) 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 a customization of virtual machines locally for your purposes.
+The bwLehrpool-Server is a [bwLehrpool](https://www.bwlehrpool.de) 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 a customization of virtual machines locally for your purposes.
## Build
@@ -27,7 +29,8 @@ A docker image of the bwLehrpool-Server and its required infrastructure can be b
mvn -P dozmod-server:start
```
-Note that a complete Docker infrastructure (images, containers, networks and volumes) is created and started automatically after this call using [docker-compose](https://docs.docker.com/compose). To stop the bwLehrpool-Server container and its entire infrastructure, use the following command line call:
+Note that a complete Docker infrastructure (images, containers, networks and volumes) is created and started automatically after this call using [docker-compose](https://docs.docker.com/compose).
+To stop the bwLehrpool-Server container and its entire infrastructure, use the following command line call:
```shell
mvn -P dozmod-server:stop
@@ -37,7 +40,9 @@ mvn -P dozmod-server:stop
## 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](https://github.com/jwilder/dockerize) utility using the following command line call where `DOZMOD_*` are environment variables to finalize the content of the configuration file:
+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](https://github.com/jwilder/dockerize) utility using the following command line call where `DOZMOD_*` are environment variables to finalize the content of the configuration file:
```shell
export DOZMOD_DATABASE_HOST="192.168.200.20"
@@ -55,17 +60,21 @@ dockerize -template setup/config.properties.tmpl:config.properties
The logging of the bwLehrpool-Server application to the console is implemented with [log4j](https://logging.apache.org/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.
+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 specifiying 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 a an absolute path to the custom configuration file and `<APP>` is a path to the built bwLehrpool-Server application (Java archive file):
+If logging configurations other than the defaults are required, the configuration file packaged into the bwLehrpool-Server application can be overwritten by specifiying 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 a an absolute path to the custom configuration file and `<APP>` is a path to the built bwLehrpool-Server application (Java archive file):
```shell
java -Dlog4j.configuration=file:<CONFIG> -jar <APP>
```
## Execution
-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):
+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):
```shell
java -jar <APP>