Commit 7946532c authored by Gerrit Hübbers's avatar Gerrit Hübbers 🃏
Browse files

Expand on debugging documentation.

parent e24d82ab
......@@ -34,6 +34,10 @@ mysql --user=root --password --host=localhost --port=3306 --protocol=TCP --verbo
mysql --user=root --password --host=localhost --port=3306 --protocol=TCP --verbose --execute="create user 'dda'@'localhost' identified by 'dda';"
mysql --user=root --password --host=localhost --port=3306 --protocol=TCP --verbose --execute="grant all privileges on dda.* to 'dda'@'localhost'; flush privileges;"
```
### Debugging staging environment
The staging environment is set up in such a way that it allows connecting a remote Java debugger (see file `etc/dda-wizard-staging.conf)`. You can connect to it like so:
* First, ssh tunnel port-forward the remote debugger port with `ssh -L 8002:localhost:8002 svko-dda-test.gesis.intra`.
* Then, from Eclipse, create a new debug configuration with parameters `localhost` and port `8002`. Click connect.
### Running DDA with the `staging` profile on a development machine
To build a staging version on your development machine, run `mvn package -Pstaging -DskipTests=true`. To run this staging version on your development machine, run `java -jar target/dda-wizard.war --spring.profiles.active=staging`.
......
......@@ -3,8 +3,8 @@
# See http://docs.spring.io/spring-boot/docs/current/reference/html/deployment-install.html#deployment-script-customization-conf-file
#
# What can you do in this .conf file? The dda-wizard.war is prepended with a SysV init.d script
# (yes, take a look into the war file with a text editor). As dda-wizard.war is symlinked in the init.d directory, this script
# is executed. One of its step is actually `source`ing this .conf file. Therefore we can do anything in this .conf file that
# (yes, take a look into the war file with a text editor). As dda-wizard.war is symlinked in the init.d directory, that init.d script
# gets executed. One of its step is actually `source`ing this .conf file. Therefore we can do anything in this .conf file that
# we can also do in a regular shell script.
export SPRING_PROFILES_ACTIVE=prod
......@@ -3,8 +3,8 @@
# See http://docs.spring.io/spring-boot/docs/current/reference/html/deployment-install.html#deployment-script-customization-conf-file
#
# What can you do in this .conf file? The dda-wizard.war is prepended with a SysV init.d script
# (yes, take a look into the war file with a text editor). As dda-wizard.war is symlinked in the init.d directory, this script
# is executed. One of its step is actually `source`ing this .conf file. Therefore we can do anything in this .conf file that
# (yes, take a look into the war file with a text editor). As dda-wizard.war is symlinked in the init.d directory, that init.d script
# gets executed. One of its step is actually `source`ing this .conf file. Therefore we can do anything in this .conf file that
# we can also do in a regular shell script.
JAVA_OPTS="-agentlib:jdwp=transport=dt_socket,address=localhost:8002,server=y,suspend=n"
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment