Greetings,
Thanks for checking out this repository. You will find here an easy-to-use Docker image to launch a single-node Kaa server in just a few clicks. If you don't know about Kaa, check out their home page: http://www.kaaproject.org.
"Kaa is a feature-rich, open-source IoT middleware platform for rapid development of the Internet of Things solutions, IoT applications, and smart products."
We suggest you first checkout Kaa's official installation guide before using this image:
-> http://docs.kaaproject.org/display/KAA/Installation+guide
In order to use this image, you will need to provide the following:
- Zookeeper 3.4.5
- PostgreSQL 9.4 OR MariaDB 5.5 (0.9+ only!)
- MongoDB 2.6.9 OR Cassandra 2.2.5
Note that we have not tested this image with Cassandra, but environment variables are all available. Contributions via pull-requests are highly appreciated!
Docker hub ->
cburr25/kaa:0.9.0
Docker build ->
-
Download Kaa's debian packages at: http://www.kaaproject.org/download-kaa/ and place them inside 'install/deb/'
-
Build this image (build.sh for your convenience)
-
Run Zookeeper, MariaDB/PostgreSQL and MongoDB/Cassandra
-
Write up a Docker environment file to configure your server, see example-env.dockerenv. Some available environment variables are:
VARIABLE | DEFAULT |
---|---|
ZOOKEEPER_HOST | localhost |
ZOOKEEPER_PORT | 2181 |
JDBC_HOST | localhost |
JDBC_PORT | 3306 |
JDBC_USERNAME | sqladmin |
JDBC_PASSWORD | admin |
JDBC_DB_NAME | kaa |
|
| CASSANDRA_CLUSTER_NAME | Kaa Cluster | CASSANDRA_KEYSPACE_NAME | kaa | CASSANDRA_NODE_LIST | localhost:9042 | CASSANDRA_USE_SSL | false | CASSANDRA_USE_JMX | true | CASSANDRA_USE_CREDENTIALS | false | CASSANDRA_USERNAME | (empty) | CASSANDRA_PASSWORD | (empty) | | | MONGODB_NODE_LIST | localhost:27017 | MONGODB_DB_NAME | kaa | MONGODB_WRITE_CONCERN | acknowledged | | | NOSQL_DB_PROVIDER_NAME | mongodb
- Run this image, link the containers however you want. See 'docker-run-kaa-0.9.sh' for an example.
If you run your Docker container as a daemon, you won't see its output. That's okay, just run:
$ docker exec tail -f /var/log/kaa/kaa-node.log
Or simply run the shortcut script 'view-kaa-node-logs.sh' !
This image was originally written to ease deployment and testing. If you find any bugs or misplaced stuff, help us tidy-up with a pull request!
-- Maintainer: Christopher Burroughs, lead software engineer & architect at xMight Inc., an energy management IoT startup.