diff --git a/.tc-environment b/.tc-environment index a009303d..194e6d52 100644 --- a/.tc-environment +++ b/.tc-environment @@ -3,5 +3,6 @@ source .unset-environment export HSADMINNG_POSTGRES_RESTRICTED_USERNAME=restricted export HSADMINNG_POSTGRES_ADMIN_USERNAME=admin export HSADMINNG_SUPERUSER=import-superuser@hostsharing.net +export HSADMINNG_CAS_SERVER= export LANG=en_US.UTF-8 diff --git a/.unset-environment b/.unset-environment index 2be52333..69a50ee3 100644 --- a/.unset-environment +++ b/.unset-environment @@ -5,4 +5,5 @@ unset HSADMINNG_POSTGRES_RESTRICTED_USERNAME unset HSADMINNG_SUPERUSER unset HSADMINNG_MIGRATION_DATA_PATH unset HSADMINNG_OFFICE_DATA_SQL_FILE +unset HSADMINNG_CAS_SERVER= diff --git a/README.md b/README.md index b803dd3d..f41d0d0a 100644 --- a/README.md +++ b/README.md @@ -666,6 +666,29 @@ These profiles mean: - **without-test-data**: no test-data is inserted +### How to Run the Application in a Debugger + +Add `' --debug-jvm` to the command line: + + +```sh +gw bootRun --debug-jvm +``` + +At the very beginning, the application is going to wait for a debugger with a message like this: + +> Listening for transport dt_socket at address: 5005 + +As soon as a debugger connects to that port, the application will continue to run. + +In IntelliJ IDEA you need a 'Remote JVM Debug' run configuration like this: + +![IntelliJ IDEA JVM-Debug Run Config](./doc/.images/intellij-idea-jvm-debug-run-config.png) + +Now, to attach IntelliJ IDEA as a debugger, you just need to run that config in debug mode. +If it's selected, just hit the *bug*-symbol next to it. + + ### How to Do a Clean Run of the Application If you frequently need to run with a fresh database and a clean build, you can use this: diff --git a/doc/.images/intellij-idea-jvm-debug-run-config.png b/doc/.images/intellij-idea-jvm-debug-run-config.png new file mode 100644 index 00000000..479df9a2 Binary files /dev/null and b/doc/.images/intellij-idea-jvm-debug-run-config.png differ