To get started with Hawkular Services, download the latest release, unzip it,
add a user and set the Agent to use the credentials for the user just added.
It can be accomplished with the following commands:
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" -Dhawkular.rest.user="${HAWKULAR_USERNAME}" -Dhawkular.rest.password="${HAWKULAR_PASSWORD}"
Before starting the server, you need to have Cassandra 3.0.9 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.
Using Postgres
To use Postgres as backend you need to pass additional properties to the standalone.sh command
above:
"${HAWKULAR_HOME}/bin/standalone.sh" -Dhawkular.rest.user="${HAWKULAR_USERNAME}" \
-Dhawkular.rest.password="${HAWKULAR_PASSWORD} \
-Dhawkular.inventory.sql.jdbc.url=jdbc:postgresql://1.2.3.4:5432/hawkular \
-Dhawkular.inventory.sql.jdbc.username=jdoe \
-Dhawkular.inventory.sql.jdbc.password=password
To use a postgres database called hawkular on host 1.2.3.4 owned by a user jdoe with a
password of password.
Build from master and Cassandra
If you build from master, you can pass -Pembeddedc to get a distribution with embedded Cassandra for local development.
Similarly if you build via -Pdev a default user of jdoe/password will be installed and also be used with the agent.