Running Kapua on OpenShift

As I mentioned some time ago, I’m working on making Eclipse Kapua project runnable on OpenShift platform. The good news is that we are there! Starting from the very first GA release of Kapua (to be announced soon), the project will be supported in an OpenShift environment.

What kind of Kapua deployment should I choose for a start?

You can run Kapua as plain Docker containers, in Vagrant or using plain JVMs. However in my humble opinion running Kapua in OpenShift is the easiest way of getting started with this project. But hey, I might be a little bit biased here ;) .

Documentation

Here you can find instructions on how to start Kapua on OpenShift, but for those impatient, here is a quick tutorial…

Kapua on OpenShift in 3 minutes

First of all — clone Kapua Git repository:

git clone git@github.com:eclipse/kapua.git

Then download and start local OpenShift cluster using our magic script:

sudo kapua/dev-tools/src/main/openshift/openshift-start.sh

If you encounter some issues during an installation process (like OpenShift complaining about Docker versioning scheme), execute the same script, but with DOCKERIZED=FALSE option:

sudo DOCKERIZED=FALSE kapua/dev-tools/src/main/openshift/openshift-start.sh

Now open another console and initialize your local OpenShift instance:

kapua/dev-tools/src/main/openshift/openshift-initialize.sh

The next step is to deploy Kapua images into an OpenShift:

cd kapua/dev-tools/src/main/openshift
./openshift-deploy.sh

That’s it, Kapua is now up and running!

Accessing Kapua web UI

Now when Kapua is started, you probably would like to log into our fancy web UI. In order to do that, you need to obtain address assigned to web UI node by Kubernetes. You can do this using OpenShift client:

$ /tmp/openshift/openshift-origin-server-v1.4.1+3f9807a-linux-64bit/oc get service | grep kapua-console
kapua-console 172.30.97.136 <none> 8080/TCP 5d

So now just navigate your browser into address you retrieved using OpenShift client, for example -http://172.30.97.136:8080. Default username/password for Kapua is kapua-sys/kapua-password .

Kapua login screen

Here is what you can see after logging in into Kapua console:

Kapua device managementscreen