training documentation - solution overview

redhat-iot · jsenegal · Jun 8, 2018 · Jun 8, 2018 · Jun 8, 2018 · Jun 11, 2018
commit 9f6a86512e2b7eaa90665b6b649e8e357eee6dea
diff --git a/documentation/images/Industry-4.0-demo-SA-training-10.jpg b/documentation/images/Industry-4.0-demo-SA-training-10.jpg
diff --git a/documentation/images/Industry-4.0-demo-SA-training-11.jpg b/documentation/images/Industry-4.0-demo-SA-training-11.jpg
diff --git a/documentation/images/Industry-4.0-demo-SA-training-4.jpg b/documentation/images/Industry-4.0-demo-SA-training-4.jpg
diff --git a/documentation/images/Industry-4.0-demo-SA-training-5.jpg b/documentation/images/Industry-4.0-demo-SA-training-5.jpg
diff --git a/documentation/images/Industry-4.0-demo-SA-training-6.jpg b/documentation/images/Industry-4.0-demo-SA-training-6.jpg
diff --git a/documentation/images/Industry-4.0-demo-SA-training-7.jpg b/documentation/images/Industry-4.0-demo-SA-training-7.jpg
diff --git a/documentation/images/Industry-4.0-demo-SA-training-8.jpg b/documentation/images/Industry-4.0-demo-SA-training-8.jpg
diff --git a/documentation/images/Industry-4.0-demo-SA-training-9.jpg b/documentation/images/Industry-4.0-demo-SA-training-9.jpg
diff --git a/documentation/solution-overview.adoc b/documentation/solution-overview.adoc
@@ -0,0 +1,51 @@
+:imagesdir: images
+:icons: font
+:source-highlighter: prettify
+
+ifdef::env-github[]
+:tip-caption: :bulb:
+:note-caption: :information_source:
+:important-caption: :heavy_exclamation_mark:
+:caution-caption: :fire:
+:warning-caption: :warning:
+:imagesdir: images
+:icons: font
+:source-highlighter: prettify
+endif::[]
+
+= Solution Overview
+
+== Addressing enterprise IoT needs
+Today the businesses are looking to integrate IoT operating technology,  data management, analytics, and applications in an
+open end-to-end IoT architecture
+
+image::Industry-4.0-demo-SA-training-4.jpg[Solution overview-4]
+
+=== Industry 4.0 Demo
+
+Using the multi-tier IoT architecture, Industry 4.0 demo addresses the needs of businesses by integrating operating technology,  data management, analytics, and applications in an
+open end-to-end IoT architecture
+
+image::Industry-4.0-demo-SA-training-5.jpg[Solution overview-5]
+
+=== Industry 4.0 Use case
+
+image::Industry-4.0-demo-SA-training-7.jpg[Solution overview-7]
+
+=== Solution and Benefits
+
+Here are some of the benefits of this Industry 4.0 solution:
+
+image::Industry-4.0-demo-SA-training-8.jpg[Solution overview-8]
+
+=== Demo Architecture
+
+image::Industry-4.0-demo-SA-training-9.jpg[Solution overview-9]
+
+=== Demo Architecture with Products
+
+image::Industry-4.0-demo-SA-training-10.jpg[Solution overview-10]
+
+=== Demo Architecture with Upstream Projects
+
+image::Industry-4.0-demo-SA-training-11.jpg[Solution overview-11]
diff --git a/images/Industry-4.0-demo-SA-training-10.jpg b/images/Industry-4.0-demo-SA-training-10.jpg
diff --git a/images/Industry-4.0-demo-SA-training-11.jpg b/images/Industry-4.0-demo-SA-training-11.jpg
diff --git a/images/Industry-4.0-demo-SA-training-4.jpg b/images/Industry-4.0-demo-SA-training-4.jpg
diff --git a/images/Industry-4.0-demo-SA-training-5.jpg b/images/Industry-4.0-demo-SA-training-5.jpg
diff --git a/images/Industry-4.0-demo-SA-training-6.jpg b/images/Industry-4.0-demo-SA-training-6.jpg
diff --git a/images/Industry-4.0-demo-SA-training-7.jpg b/images/Industry-4.0-demo-SA-training-7.jpg
diff --git a/images/Industry-4.0-demo-SA-training-8.jpg b/images/Industry-4.0-demo-SA-training-8.jpg
diff --git a/images/Industry-4.0-demo-SA-training-9.jpg b/images/Industry-4.0-demo-SA-training-9.jpg
diff --git a/documentation/demo_setup.html → solution-overview.html b/documentation/demo_setup.html → solution-overview.html
@@ -5,7 +5,7 @@
 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="Asciidoctor 1.5.7">
-<title>Lab Environment &amp; Resources</title>
+<title>Solution Overview</title>
 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
 <style>
 /* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
@@ -433,268 +433,82 @@
 </head>
 <body class="article">
 <div id="header">
-<h1>Lab Environment &amp; Resources</h1>
+<h1>Solution Overview</h1>
 </div>
 <div id="content">
 <div class="sect1">
-<h2 id="_lab_environment">Lab Environment</h2>
+<h2 id="_addressing_enterprise_iot_needs">Addressing enterprise IoT needs</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>This lab utilizes Red Hat Product Demo System (RHPDS) to provision the lab environment.
-RHPDS  uses Red Hat CloudForms to deploy infrastructure needed for our lab.<br></p>
-</div>
-<div class="paragraph">
-<p>The infrastructure consists of 5 VMs as well as the overall network configuration. Red Hat OpenShift Container Platform 3.9 has already been deployed for this lab.</p>
-</div>
-<div class="paragraph">
-<p>OpenShift environment for this lab consists of the following systems:</p>
-</div>
-<table class="tableblock frame-all grid-all stretch">
-<colgroup>
-<col style="width: 33.3333%;">
-<col style="width: 33.3333%;">
-<col style="width: 33.3334%;">
-</colgroup>
-<thead>
-<tr>
-<th class="tableblock halign-left valign-top">Hostname</th>
-<th class="tableblock halign-left valign-top">Internal IP</th>
-<th class="tableblock halign-left valign-top">Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bastion.example.com</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192.168.0.5</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Bastion host</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>master.example.com</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192.168.0.10</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Master</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>node01.example.com</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192.168.0.11</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Node 01</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>node02.example.com</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192.168.0.12</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Node 02</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>node03.example.com</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192.168.0.13</code></p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Node 03</p></td>
-</tr>
-</tbody>
-</table>
-<div class="sect2">
-<h3 id="_access_your_lab_environment">Access Your Lab Environment</h3>
-<div class="paragraph">
-<p><strong>Request an OPENTLC Account</strong><br>
-Get access to filling the form at: <a href="https://account.opentlc.com/account/requestAccessForm.php" class="bare">https://account.opentlc.com/account/requestAccessForm.php</a></p>
-</div>
-<div class="paragraph">
-<p><strong>Set Password</strong><br>
-After you have been notified by email that your account has been created, set your password using the temporary password provided in the email at: <a href="https://account.opentlc.com/account/setPasswordForm.php" class="bare">https://account.opentlc.com/account/setPasswordForm.php</a></p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-Your username will be your Red Hat email address with "@" replaced by "-"
-(E.g if your Red Hat email address is <a href="mailto:jdoe@redhat.com">jdoe@redhat.com</a>, your login will be jdoe-redhat.com)
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_provision_your_demo_environment">Provision Your Demo Environment</h3>
-<div class="paragraph">
-<p>Log in to the <a href="https://rhpds.redhat.com/">Red Hat Product Demo System</a> with your provided credentials.</p>
+<p>Today the businesses are looking to integrate IoT operating technology,  data management, analytics, and applications in an
+open end-to-end IoT architecture</p>
 </div>
 <div class="imageblock">
 <div class="content">
-<img src="images/RHPDS-Login.png" alt="RHPDS Login">
+<img src="images/Industry-4.0-demo-SA-training-4.jpg" alt="Solution overview-4">
 </div>
 </div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
-If you have problems with access to the lab environment, send an email to <a href="mailto:internal-enablement@redhat.com">internal-enablement@redhat.com</a>.
-</td>
-</tr>
-</table>
-</div>
+<div class="sect2">
+<h3 id="_industry_4_0_demo">Industry 4.0 Demo</h3>
 <div class="paragraph">
-<p>Click on the drop-down right beside your name, you should see a list of groups that your user belongs to:</p>
+<p>Using the multi-tier IoT architecture, Industry 4.0 demo addresses the needs of businesses by integrating operating technology,  data management, analytics, and applications in an
+open end-to-end IoT architecture</p>
 </div>
 <div class="imageblock">
 <div class="content">
-<img src="images/RHPDS-Change-Group.png" alt="Order Demo">
+<img src="images/Industry-4.0-demo-SA-training-5.jpg" alt="Solution overview-5">
 </div>
 </div>
-<div class="paragraph">
-<p>Choose the group "rhpds-iot-dev"</p>
-</div>
-<div class="paragraph">
-<p>Go to Services → Catalogs</p>
 </div>
+<div class="sect2">
+<h3 id="_industry_4_0_use_case">Industry 4.0 Use case</h3>
 <div class="imageblock">
 <div class="content">
-<img src="images/RHPDS-Choose-Catalog.png" alt="Choose Catalog">
+<img src="images/Industry-4.0-demo-SA-training-7.jpg" alt="Solution overview-7">
 </div>
 </div>
-<div class="paragraph">
-<p>Under Service Catalog , Click Order for DEV-IOT Enterprise 4.0 Demo</p>
-</div>
-<div class="imageblock">
-<div class="content">
-<img src="images/RHPDS-Choose-Demo.png" alt="Order Demo">
-</div>
 </div>
+<div class="sect2">
+<h3 id="_solution_and_benefits">Solution and Benefits</h3>
 <div class="paragraph">
-<p>Review the information about lifecycle of the lab environment and how to extend it. Check box to confirm, click Submit</p>
+<p>Here are some of the benefits of this Industry 4.0 solution:</p>
 </div>
 <div class="imageblock">
 <div class="content">
-<img src="images/RHPDS-Order-Demo.png" alt="Order Demo">
-</div>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-It takes a few minutes for demo to be provisioned and become accessible. You can get real-time status of the demo environment at <a href="https://www.opentlc.com/rhpds-status" class="bare">https://www.opentlc.com/rhpds-status</a>
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>You will be getting an email with information about how to access the demo environment.</p>
-</div>
-<div class="paragraph">
-<p>The email will also provide the unique GUID needed to access the demo environment.</p>
+<img src="images/Industry-4.0-demo-SA-training-8.jpg" alt="Solution overview-8">
 </div>
 </div>
 </div>
-</div>
-<div class="sect1">
-<h2 id="_access_demo_environment">Access Demo environment</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Interaction with the environment will be facilitated using several mechanisms listed below:</p>
-</div>
 <div class="sect2">
-<h3 id="_openshift_web_console">OpenShift Web Console</h3>
-<div class="paragraph">
-<p>OpenShift features a rich user interface for managing resources on the platform.</p>
-</div>
-<div class="paragraph">
-<p>Open a web browser and navigate to the following location</p>
-</div>
-<div class="paragraph">
-<p><a href="https://infranode-&lt;GUID&gt;.generic.opentlc.com:8443">https://infranode-&lt;GUID&gt;.generic.opentlc.com:8443</a></p>
-</div>
-<div class="paragraph">
-<p>A warning will appear stating that insecure certificates are being utilized. Ignore the certificate warning and continue on to the login page.</p>
-</div>
+<h3 id="_demo_architecture">Demo Architecture</h3>
 <div class="imageblock">
 <div class="content">
-<img src="images/OpenShift-Console-Login.png" alt="OpenShift Login">
+<img src="images/Industry-4.0-demo-SA-training-9.jpg" alt="Solution overview-9">
 </div>
 </div>
-<div class="paragraph">
-<p>Once again, use the following credentials at the login page</p>
-</div>
-<div class="paragraph">
-<p>User: <strong>admin</strong><br>
-Password: <strong>r3dh4t1!</strong></p>
-</div>
-<div class="paragraph">
-<p>The OpenShift catalog should be shown upon successful authentication</p>
 </div>
+<div class="sect2">
+<h3 id="_demo_architecture_with_products">Demo Architecture with Products</h3>
 <div class="imageblock">
 <div class="content">
-<img src="images/OpenShift-Console-LoggedIn.png" alt="OpenShift Catalog">
-</div>
+<img src="images/Industry-4.0-demo-SA-training-10.jpg" alt="Solution overview-10">
 </div>
-<div class="paragraph">
-<p>click on the project IoT-Demo in the right panel</p>
 </div>
-<div class="paragraph">
-<p>The deployed project resources can now be seen in the OpenShift Console</p>
 </div>
+<div class="sect2">
+<h3 id="_demo_architecture_with_upstream_projects">Demo Architecture with Upstream Projects</h3>
 <div class="imageblock">
 <div class="content">
-<img src="images/OpenShift-Console-Project.png" alt="Demo Project">
-</div>
-</div>
-<div class="paragraph">
-<p>To Do: Add instructions for Dashboard app once its deployed</p>
-</div>
+<img src="images/Industry-4.0-demo-SA-training-11.jpg" alt="Solution overview-11">
 </div>
 </div>
 </div>
-<div class="sect1">
-<h2 id="_demo_resources">Demo Resources</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The primary source of content for this lab is the industry 4.0 demo project repository.</p>
-</div>
-<div class="paragraph">
-<p><strong>Project location:</strong> <a href="https://github.com/redhat-iot/cloudera-iot-demo">https://github.com/redhat-iot/cloudera-iot-demo</a></p>
-</div>
-<div class="paragraph">
-<p>The repository contains the following resources:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p><strong>Bridge</strong> (<code>imqtt-to-kafka-bridge</code>): Bridge between MQTT and Kafka, implemented using Camel MQTT and Kafka components. MQTT Topic names are mapped as message keys in Kafka.</p>
-</li>
-<li>
-<p><strong>Dashboard</strong> (<code>dashboard</code>): Dashboard is an Angular.js app running on a Node.js runtime, along with JBoss Data Grid and a Data Grid proxy component that properly handles browser-based REST requests and relays to JBoss Data Grid via the Hotrod protocol.</p>
-</li>
-<li>
-<p><strong>IoT Data</strong> (<code>iot_data</code>): Dataset of machine runtime</p>
-</li>
-<li>
-<p><strong>Gateway</strong> (<code>gateway</code>): xxx</p>
-</li>
-<li>
-<p><strong>OpenShift</strong> (<code>openshift-templates</code>): Templates for deploying the following applications on OpenShift: dashboard, kapua, xxx</p>
-</li>
-<li>
-<p><strong>Simulator</strong> (<code>software-sensor-simulator</code>): Simulated software sensor generating IoT Data</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>[</p>
-</div>
-<div class="paragraph text-center">
-<p><span class="image"><a class="image" href="introduction.html"><img src="images/icons/icon-home.png" alt="icon home" width="128"></a></span></p>
-</div>
 </div>
 </div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2018-08-15 12:45:52 MST
+Last updated 2018-08-16 20:08:04 MST
 </div>
 </div>
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prettify/r298/prettify.min.css">