Mercurial > hg > thermostat-ng > web-gateway
view README.md @ 298:36a5f2fed6d3
Update README with https URLs.
Reviewed-by: clessard
Review-thread: http://icedtea.classpath.org/pipermail/thermostat/2017-October/025544.html
author | Severin Gehwolf <sgehwolf@redhat.com> |
---|---|
date | Thu, 26 Oct 2017 16:15:46 +0200 |
parents | abcc0226b293 |
children |
line wrap: on
line source
# Thermostat Web Gateway This is a HTTP API server for [Thermostat](http://icedtea.classpath.org/thermostat). # Build Dependencies * JDK 7+ * Maven # Runtime Dependencies * JRE 7+ * Mongodb 3.x+ # How to Build ``` $ mvn clean verify ``` # How to Run ## How to Start ``` $ ./distribution/target/image/bin/thermostat-mongodb.sh start $ ./distribution/target/image/bin/thermostat-web-gateway.sh ``` This will run the Web Gateway with default configuration, listening on http://127.0.0.1:30000 Additional Java options can be passed to the Java command that launches the Web Gateway using the `THERMOSTAT_GATEWAY_EXT_JAVA_OPTS` environment variable. ## How to Stop `Ctrl-C` to stop `thermostat-web-gateway.sh` ``` $ ./distribution/target/image/bin/thermostat-mongodb.sh stop ``` # API: For API see the Swagger YAML specifications in `./services/*/src/main/resources` Alternatively, visit the Swagger UI hosted by the Web Gateway at `https://127.0.0.1:30000/doc/index.html` and load specifications provided by the services. For example: `https://127.0.0.1:30000/doc/index.html?url=https://127.0.0.1:30000/jvm-gc/0.0.2/doc/jvm-gc-swagger.yaml` # How to debug after building ## Run debug script This runs Thermostat Web Gateway listening on socket 5005 for a debugger to connect. ``` $ ./distribution/target/image/bin/thermostat-web-gateway-debug.sh ``` ## Run IdeLauncher class This class is meant to run from IDE (Eclipse, Intellij, etc.) with configuration setting the environment variable `THERMOSTAT_GATEWAY_HOME` to `distribution/target/image` ```