QA + Improvements to examples-nosql-cluster-deployment + support for demo at ENBW (#128)

* QA - updating versions and correcting some bug found

* draft version for demo-event ENBW

* QA + adding primary-secondary-rf3 support

* Quick fix arbiters

* missing admin in secondary

* Update single-node-rf1.kvs

* Update primary-secondary-cap1.jpg

* improving pri/sec

* Update scenario-9.md

* Modifying script maintenance

* Update scenario-9.md

Author: dario-vega

demo-events/enbw/serverless-with-nosql-database-and-functions/baggage-tracking-demo/baggage-tracking-demo.md

@@ -0,0 +1,133 @@
+# Baggage Tracking Demo
+
+## Introduction
+
+This lab walks you through a live baggage tracking demo that was created by the Oracle NoSQL development team.   
+
+Estimated Time: 7 minutes
+
+
+### Serverless Logic Tier
+
+We selected this demo because it solves real world business problems.  Many of those are listed on the slide.
+
+  ![](images/business-problem.png)
+
+This application is running in all the OCI regions.
+
+  ![](images/demo-region.png)
+
+The application behind the demo uses a three-tier architecture, representing the brains of the application. Integrating these components: an API Gateway, Streams, and Functions; in your logic tier can be revolutionary.  The features of these services allow you to build a serverless production application that is highly available, scalable, and secure. Your application can use thousands of servers, however, by leveraging this pattern you do not have to manage a single one.
+
+In addition, by using these managed services together you gain the following benefits:
+*	No operating systems to choose, secure, patch, or manage.
+*	No servers to size, monitor, or scale out.
+*	No risk to your cost by over-provisioning.
+*	No risk to your performance by under-provisioning.
+
+Here is a diagram of architecture behind the demo.
+
+  ![](images/arch-diagram.png)
+
+Here is an architecture diagram at the component level.
+
+  ![](images/component-arch.png)
+
+
+### Objectives
+
+* Explore the baggage tracking demo  
+
+### Prerequisites
+
+*  Connection to the internet
+*  Personal cellphone
+
+
+## Task 1: The "Traveling User" Problem!
+
+This particular application came to the NoSQL team from Emirates airlines.  When we thought about this for a little bit, we realized that this was a perfect use case for NoSQL.  Many airlines, like United, Delta, American are now offering real time baggage tracking.  You have to install their application, and you get close to a real time feed of where your bag is at as it moves along its journey.  This is a really good example of companies offloading queries from the operational data store.   In the Emirates case, this data was already collected in their operational database and they didn’t want to put consumer level queries on that data store.   The second thing in this example is the involvement of an active/active configuration.  You write data locally in closest data center as that bag travels, but you want to read it from anywhere.  For the best latency, you want the RFID bag scans to be immediately written to the local data center and then let the system take care of propagating that data to the other data centers in an active/active set up.   If you took a trip from the US to Europe for example, the last thing you would want to do is force all the writes back to the US.   Hundreds of bags get scanned per flight segment and you need the best possible latency.   
+
+What are some of the goals of this application:
+
+  - Predictable low latency
+  - Scalable to your user base
+  - Highly available
+  - Auto-expiry of the data - baggage location data has a limited lifespan
+  - Offload consumer queries from operation data store
+
+
+## Task 2: Grab your Personal Cell Phone
+
+1. In a browser window, enter ndcsdemo.com
+
+    ![](images/ndcs-google.png)
+
+  This brings you to the welcome screen for Blue Mist airways.
+
+      ![](images/blue-mist.png)
+
+## Task 3: Track a Bag
+
+1. Tap on the 'Track Your Baggage' button.
+
+      ![](images/blue-mist-track.png)
+
+  After doing so, you will get random baggage information for a traveler.  Scroll through the information.  In an application from a real airlines, a variety of different information can be displayed.   
+
+      ![](images/ferry-trip.png)
+
+## Task 3: Select New Traveler
+
+1. Tap on the 'hamburger' button on the top right, and then hit ‘Track Your Baggage’ again.  A new random traveler will be shown.
+
+      ![](images/hamburger-menu.png)
+
+      ![](images/track-bag.png)
+
+## Task 4:  Explore the JSON data record
+
+1. The data record is a JSON document with several nested arrays.  Oracle NoSQL makes it easy to handle nested arrays.
+
+      ![](images/json-record.png)
+
+
+## Task 5: Key takeaways
+
+1. While this was a simple demo, it used many components that are available in OCI today.
+
+  * Application is running live in all OCI Regions
+  * Application uses OCI traffic Management for Geo-Steering to steer network requests to closest OCI region
+  * OCI API gateway is used
+  * UI development done with Visual Builder Cloud Service
+  * Tomcat Server for REST calls
+  * Data stored in Oracle NoSQL Cloud Service as JSON documents
+
+
+2. The benefits to customers are shown in this slide.
+
+      ![](images/benefits.png)
+
+You may now **proceed to the next lab.**
+
+## Learn More
+
+* [About Architecting Microservices-based applications](https://docs.oracle.com/en/solutions/learn-architect-microservice/index.html)
+* [Speed Matters! Why Choosing the Right Database is Critical for Best Customer Experience?](https://blogs.oracle.com/nosql/post/speed-matters-why-choosing-the-right-database-is-critical-for-best-customer-experience)
+* [Oracle NoSQL Database Multi-Region](https://blogs.oracle.com/nosql/post/oracle-nosql-database-multi-region-table-part1)
+* [About Security, Identity, and Compliance](https://www.oracle.com/security/)
+* [Application Development](https://www.oracle.com/application-development/)
+
+### Services
+
+* [Oracle NoSQL Database Cloud Service page](https://www.oracle.com/database/nosql-cloud.html)
+* [About API Gateway](https://docs.oracle.com/en-us/iaas/Content/APIGateway/Concepts/apigatewayoverview.htm)
+* [About Streaming](https://docs.oracle.com/en-us/iaas/Content/Streaming/Concepts/streamingoverview.htm)
+* [About Connector Hub](https://docs.oracle.com/en-us/iaas/Content/service-connector-hub/overview.htm)
+* [About Functions](https://docs.oracle.com/en-us/iaas/Content/Functions/Concepts/functionsoverview.htm)
+
+
+
+## Acknowledgements
+* **Author** - Dario Vega, Product Manager, NoSQL Product Management and Michael Brey, Director, NoSQL Product Development
+* **Last Updated By/Date** - Michael Brey, Director, NoSQL Product Development, September 2021

demo-events/enbw/serverless-with-nosql-database-and-functions/baggage-tracking-demo/images/arch-diagram.png

@@ -0,0 +1,213 @@
+# Create Tables and Load Tables
+
+## Introduction
+
+This lab walks you through creating and loading NoSQL tables.   This can be done a variety of different ways including using the OCI console, writing an application program, or triggering actions via a function.  This lab will walk you through a couple of different approaches.   Oracle NoSQL Database Cloud Service supports both schema-based and schema-less (JSON) modeling so we will create examples of both tables.
+
+Estimated Time: 25 minutes
+
+### Objectives
+
+* Create 3 tables with provisioned reads/sec, writes/sec, and GB storage
+* Write data to the table and read data from the table
+* Look at the data in the tables via the OCI console
+
+### Prerequisites
+
+* An Oracle Free Tier, Always Free, or Paid Cloud Account
+* Connection to the Oracle NoSQL Database Cloud Service
+* Working knowledge of bash shell
+
+## Task 1: Create an Oracle NoSQL Table With the Console
+
+1. On the OCI menu drop down on the left, go to Databases and then hit 'Tables' under Oracle NoSQL Database.  This brings you to the 'Table' screen where you can create a table from the console.
+
+    ![](./images/nosql-tables.png)
+
+2. Click on 'Create Table' and the 'Create Table' screen appears.
+
+    ![](./images/create-tables.png)
+
+  This screen allows you to create tables in one of two different ways, either using simple input or using DDL input.  For this Lab we are going to use the simple input method.  
+
+3. The first thing you want to do is click the 'Always Free Configuration' toggle button.  This will create an always free table.   Each tenancy is allowed 3 always free tables.  Always free tables have fixed provisioning at 50 read units, 50 write units and 25 GB of storage.  We have mentioned several times in this workshop that you want to be in the Phoenix region.  NoSQL always free tables are only available in the Phoenix region and you need to be in the correct region to use them.
+
+    ![](./images/always-free.png)
+
+  Clicking on the 'Always Free Configuration' button grays out the boxes to input provisioning.  Next enter a name for your table, a primary key and column. For this example, we used freeTest as the name, pkey with a type of integer as the primary key, and name with a type string as an additional column.  Click 'Set as a Shard Key'.
+
+4. When done with inputs click on 'Create Table' at the bottom.
+
+   ![](./images/create-myfree-table.png)
+
+  In summary, this screen allows to create a table with multiple columns for the primary key, as well as adding multiple additional columns.  You can easily create simple or more complex tables with this interface.  
+
+5. After clicking on 'Create Table' you will be brought to the Tables screen.  This screen shows you a list of tables you have created, as well as basic information about the table.  One important thing to notice is that our table has a status of 'Active' which means we are ready to load data into our table.  Another thing to notice is the 'Always free' tag that is attached to the table.   This lets you know it is an always free table.
+
+    ![](./images/freetest-table.png)
+
+
+## Task 2: NoSQL Tables Deployment
+
+In this task we are going to create tables using the Cloud Shell, and OCI CLI interface.   The OCI CLI commands issued from the Cloud Shell make REST calls to the Oracle NoSQL Database Cloud Service (NDCS).  OCI offers several SDKs in different languages that you can use to make REST calls to NDCS.   To make things a little simpler, we have created some shell scripts and files that will assist you in this Task.  We need to download those to the Cloud Shell first.
+
+1. Start the Cloud Shell.
+
+    ![Cloud Shell](https://oracle-livelabs.github.io/common/images/console/cloud-shell.png)
+
+2. Execute the following environment setup shell script in the Cloud Shell. If you close/open the Cloud Shell Console, please re-execute it.
+
+    ```
+    <copy>
+    source ~/serverless-with-nosql-database/env.sh
+    </copy>
+    ```
+
+3. Let's create NoSQL tables using the OCI CLI. The CLI command for Oracle NoSQl is 'oci nosql <command>'.  We will create two different tables and  echo the DDL statements so you can see what is being created.  One of the tables is a fixed schema table and the other is a JSON document table.  To create the always free table using the OCI CLI, you specify the --is-auto-reclaimable flag, as shown in the code below.
+
+    ```
+    <copy>
+    cd ~/serverless-with-nosql-database/objects
+    DDL_TABLE=$(cat demo.nosql)
+    echo $DDL_TABLE
+    </copy>
+    ```
+
+    ```
+    <copy>
+    oci nosql table create --compartment-id "$COMP_ID"   \
+    --name demo --ddl-statement "$DDL_TABLE" \
+    --is-auto-reclaimable false \
+    --table-limits="{\"maxReadUnits\": 50,  \"maxStorageInGBs\": 25,  \"maxWriteUnits\": 50 }" \
+    --wait-for-state SUCCEEDED --wait-for-state FAILED
+    </copy>
+    ```
+    ```
+    <copy>
+    DDL_TABLE=$(cat demoKeyVal.nosql)
+    echo $DDL_TABLE
+    </copy>
+    ```
+    ```
+    <copy>
+    oci nosql table create --compartment-id "$COMP_ID"   \
+    --name demoKeyVal  --ddl-statement "$DDL_TABLE" \
+    --is-auto-reclaimable false \
+    --table-limits="{\"maxReadUnits\": 50,  \"maxStorageInGBs\": 25,  \"maxWriteUnits\": 50 }" \
+    --wait-for-state SUCCEEDED --wait-for-state FAILED
+    </copy>
+    ```
+
+4. Minimize the Cloud Shell by clicking on the minimization button.
+
+    ![](./images/cloud-shell-small.png)
+
+
+## Task 3:  Adding Data From the OCI Console
+
+1. Make sure you are 'Table' screen.  You should see 3 tables listed.  Your compartment should be demonosql.
+
+    ![](./images/table-screen.png)
+
+2. Click on demo table
+
+    ![](./images/capturenosql.png)
+
+3. Click on 'Insert Row'. This opens up a new window. This time, choose Advanced Json Input.
+
+  Copy/Paste the json Baggage document in JSON input text box.  Because this Json document is complex, it is easiest to copy/paste into the field.  However, you could have typed it all in.
+
+    ````
+    <copy>
+    {
+      "fullName" : "Abram Falls",
+      "contactPhone" : "921-284-5378",
+      "ticketNo" : "176233524485",
+      "confNo" : "HP1D4H",
+      "gender" : "F",
+      "bagInfo" : [ {
+        "id" : "79039899127071",
+        "tagNum" : "17657806285185",
+        "routing" : "SYD/SIN/LHR",
+        "lastActionCode" : "OFFLOAD",
+        "lastActionDesc" : "OFFLOAD",
+        "lastSeenStation" : "LHR",
+        "flightLegs" : [ {
+          "flightNo" : "BM254",
+          "flightDate" : "2019.02.28 at 22:00:00 AEDT",
+          "fltRouteSrc" : "SYD",
+          "fltRouteDest" : "SIN",
+          "estimatedArrival" : "2019.03.01 at 03:00:00 SGT",
+          "actions" : [ {
+            "actionAt" : "SYD",
+            "actionCode" : "ONLOAD to SIN",
+            "actionTime" : "2019.02.28 at 22:09:00 AEDT"
+          }, {
+            "actionAt" : "SYD",
+            "actionCode" : "BagTag Scan at SYD",
+            "actionTime" : "2019.02.28 at 21:51:00 AEDT"
+          }, {
+            "actionAt" : "SYD",
+            "actionCode" : "Checkin at SYD",
+            "actionTime" : "2019.02.28 at 20:06:00 AEDT"
+          } ]
+        }, {
+          "flightNo" : "BM272",
+          "flightDate" : "2019.02.28 at 19:09:00 SGT",
+          "fltRouteSrc" : "SIN",
+          "fltRouteDest" : "LHR",
+          "estimatedArrival" : "2019.03.01 at 03:10:00 GMT",
+          "actions" : [ {
+            "actionAt" : "LHR",
+            "actionCode" : "Offload to Carousel at LHR",
+            "actionTime" : "2019.03.01 at 03:01:00 GMT"
+          }, {
+            "actionAt" : "SIN",
+            "actionCode" : "ONLOAD to LHR",
+            "actionTime" : "2019.03.01 at 11:20:00 SGT"
+          }, {
+            "actionAt" : "SIN",
+            "actionCode" : "OFFLOAD from SIN",
+            "actionTime" : "2019.03.01 at 11:10:00 SGT"
+          } ]
+        } ],
+        "lastSeenTimeGmt" : "2019.03.01 at 03:06:00 GMT",
+        "bagArrivalDate" : "2019.03.01 at 03:06:00 GMT"
+      } ]
+    }
+    </copy>
+    ````
+
+
+4. Click on 'Insert Row' at bottom left of screen.
+
+You have seen two different ways to insert data into a table.  
+
+## Task 4:  Show Data From the Console
+
+Starting with the demo table, we can go and look at the data we inserted for each of the tables.
+
+1. On the left Click on Explore Data
+
+    ![](./images/table-row-select.png)
+
+2. In the textbox Query, keep the text `SELECT * FROM demo`.  This will select all the rows from our table.  Click on Run query
+
+    ![](./images/run-query.png)
+
+  You will see in the bottom of the screen the row that we inserted.
+
+3. Go to the top left, hit 'Tables', select the freeTest table, and look at the row inserted into that table.
+
+You may now **proceed to the next lab.**
+
+## Learn More
+
+* [Oracle NoSQL Database Cloud Service page](https://www.oracle.com/database/nosql-cloud.html)
+* [About Oracle NoSQL Database Cloud Service](https://docs.oracle.com/pls/topic/lookup?ctx=cloud&id=CSNSD-GUID-88373C12-018E-4628-B241-2DFCB7B16DE8)
+* [About Cloud Shell](https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cloudshellintro.htm)
+
+
+## Acknowledgements
+* **Author** - Dario Vega, Product Manager, NoSQL Product Management and Michael Brey, Director, NoSQL Product Development
+* **Last Updated By/Date** - Michael Brey, Director, NoSQL Product Development, September 2021