Server

The Hawkular server is required to run the application.

At this point the application is associated with available releases. At the moment it is version Service 0.0.9.Final.

There are multiple ways to bootstrap the server. The server will be available in your network. The application will require address, port and credentials of the server.

Local

HAWKULAR_VERSION="0.0.9.Final"

HAWKULAR_URL="https://github.com/hawkular/hawkular-services/releases/download"
HAWKULAR_DIRECTORY="hawkular"
HAWKULAR_FILE="hawkular.tar.gz"

mkdir "${HAWKULAR_DIRECTORY}"
cd "${HAWKULAR_DIRECTORY}"

curl -L "${HAWKULAR_URL}/${HAWKULAR_VERSION}/hawkular-services-dist-${HAWKULAR_VERSION}.tar.gz" \
--output "${HAWKULAR_FILE}"
tar --extract --gzip --file "${HAWKULAR_FILE}"

export HAWKULAR_HOME="/path/to/hawkular-services"
export HAWKULAR_USERNAME="jdoe"
export HAWKULAR_PASSWORD="password"

cd "${HAWKULAR_HOME}"
"${HAWKULAR_HOME}/bin/add-user.sh" \
  -a \
  -u "${HAWKULAR_USERNAME}" \
  -p "${HAWKULAR_PASSWORD}" \
  -g read-write,read-only
"${HAWKULAR_HOME}/bin/standalone.sh" -b 0.0.0.0 \
-Dhawkular.rest.user="${HAWKULAR_USERNAME}" -Dhawkular.rest.password="${HAWKULAR_PASSWORD}"

Before starting the server, you need to have Cassandra 3.7 up and running with the RPC port enabled either via setting the env variable of CASSANDRA_START_RPC to true

or by editing cassandra.yml and setting it there:

# Whether to start the thrift rpc server.
start_rpc: true

Using ccm you can use this to update the config: ccm updateconf 'start_rpc: true'. Another option is via nodetool enablethrift.

Docker

There are inofficial Docker images of the release and also an instrumented WildFly available on DockerHub at https://hub.docker.com/r/pilhuhn/hawkular-services/[Hawkular services] and https://hub.docker.com/r/pilhuhn/hawkfly/[Instrumented WildFly].

Both images have been instrumented with the jdoe/password user for the Hawkular server and the agent.

See also http://pilhuhn.blogspot.de/2016/06/using-hawkular-services-via-docker.html on some more details about using those images.