This example showcases an Intelligent Internet-of-Things (IoT) Gateway on Red Hat’s OpenShift Container Platform. The Gateway enables real-time decision making at the edge, and demonstrates the ease with which you can deploy a secure and scalable microservices application on the enterprise-grade OpenShift application platform.
The application is deployed as a set of microservices inside containers on OpenShift:
-
JBoss Fuse Integration Services (FIS): Tools that facilitate integration, routing, and transformation of messages and protocols, by leveraging Apache Camel technology.
-
JBoss A-MQ: Apache ActiveMQ-based message broker container image for receiving and storing telemetry from the Sensor via MQTT
-
JBoss BRMS Decision Server: Real-time execution of business rules for processing telemetry
-
Apache Zeppelin: Interactive data visualization and analytics
-
PostgreSQL: Provides persistence for sensor data
-
Simulated Software Sensor: A simple Spring Boot application that simulates temperature, vibration, and GPS sensor data
-
OpenShift command-line tools for your platform
-
Access to an OpenShift environment
-
Two (2) available Persistent Volumes
Step 1: Login to your OpenShift environment using the command-line tools
Note: If you don’t have an environment handy, the Red Hat Container Development Kit provides a fully-functional preconfigured OpenShift environment, including Red Hat Enterprise Linux (RHEL) and JBoss, delivered as a Virtual Machine image. The VM should be enabled with minimum of 4 CPU and 6144MB memory (i.e. Vagrant file for CDK should be updated with this VM configuration)
Step 2: Download the iot-ocp project in the OpenShift instance:
$ git clone https://github.com/sabre1041/iot-ocp.git
Step 3: Execute the init script
$ cd iot-ocp $ ./init.sh
The script automatically builds, deploys, and wires the necessary application components together. Once the process is complete, you can see a graphical visualization of the application architecture using the OpenShift Web Console.
Step 4: Login to the OpenShift web console using a web browser
Username: admin
Password: admin
Project: iot-ocp
The data visualization is stored in Notebooks. The interpreters allow Zeppelin to connect to PostgreSQL.
Step 5: Locate the Zeppelin service on the overview page and click on its url to launch the Zeppelin web console
Step 6: Under notebook, select Import note to import the pre-configured iot-ocp notebook
Step 7: Execute all visualizations by hitting the "Play" button on the top lefthand corner of the page next to the name of the note
Step 8: Periodically refresh the note data through cron scheduler
To bring the project back up, the components should be started in the following order:
-
PostgreSQL
-
JBoss A-MQ
-
Kie
-
JBoss Fuse Integration Services (FIS)
-
Simulated Software Sensor
-
Apache Zeppelin
Copyright 2016 by Red Hat, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this package except in compliance with the License (see the LICENSE
file
included in this distribution). You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.