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`
```