WingsArc1st Connector Document

wingarc1st/wingarc1st-connector-guide.md

@@ -0,0 +1,92 @@
+**Introduction**
+
+|Validation Matrix |Version |
+| ---- | ----- |
+|MotionBoard |6\.0.00.0020 (and higher) |
+|Oracle Client |Oracle JDBC 18.3 (and higher) |
+
+### **Prerequisites**
+
+- The  connection  destination  must  be  in  an  environment  where  it  can  communicate  with MotionBoard and runs correctly. It’s necessary that user have knowledge about network and server environment.
+- This document assumes that the Autonomous Data Warehouse has been provisioned and the corresponding wallet zip file has been downloaded to the system.
+
+## **Configure the Connection**
+
+### Step 1: Install MotionBoard
+
+If there is a pre-existing Motionboard installed jump to Step 3 which describes the steps to configure ADWC as a target.
+
+To install Motionboard software please refer to the Install[ Documentation.](https://manual.wingarc-support.com/en-us/manual/mb/mb60/)
+
+### Step 2: Install Oracle driver on MotionBoard (ONLY for “on premises” version)**
+
+1. Open installer file and select “MotionBoard60 - extra”.
+2. Copy  “oracle\_autonomous.zip”  to “[InstallDir]\system\resources\communicator\drivers\extra”.
+3. Restart “Motionboard 6.0” service.
+  ![](images/download_file.jpeg)
+
+### Step 3: How to configure MotionBoard on a Windows environment
+
+1. Select the type of data source to connect to
+    1. Log in to MotionBoard as a user with administrator privileges.
+    2. Select Management of the board menu - System Settings - Connection/Authentication - External Connection.
+
+  ![](images/console_menu.jpeg)
+
+    3. Click the New button on the External Connection screen.
+    4. Enter the name of the external connection settings in External Connection Name on the Create New External Connection screen.
+    5. In Connection Type, select the connection destination (data source name).
+    6. In Relay Service, select a connection method for connecting with the destination. If Relay Service does not appear, proceed to the next step.
+    7. To connect directly to the connection destination, select Disable. Usually, you select this option.
+    8. To use the Bridge Service, select Bridge Service and select the Bridge group to use for Bridge Group Name.
+    9. To use the Federation Service, select Federation Service and select the Bridge group to use for Federation Name.
+    10. Click the New button.
+    11. Click the OK button on the message to confirm saving the settings.
+
+
+2. Specify information necessary for connection with Oracle Autonomous Data Warehouse
+
+    1. Click the Basic Information tab in the External Connection screen.
+    2. Specify Driver Type. Select to connect to “Oracle Autonomous(JDBC)”.
+    3. Check the settings for Relay Service and change them as necessary.
+    4. In Service Name, specify the name of the Oracle Autonomous Data Warehouse Service.
+    5. Click “Select” button of Wallet and select corresponding wallet zip file.
+    6. In  User  Name,  specify  the  user  ID  equivalent  to  the  server  administrator  of  Oracle Autonomous Data Warehouse.
+    7. Click the Password setting button of Password, and specify the password for User Name.
+
+      ![](images/external_connection.jpeg)
+
+3. Confirm you can connect to the connection destination
+
+    1. Click the Connection Test button.
+    2. If a message indicating connection succeeded is displayed, proceed to the next step.
+    3. If a message indicating connection failed is displayed, return to the previous step and review the setting.
+    4. Click the Save button.
+    5. Click the OK button on the message to confirm saving the settings.
+
+### Step 4: Check connectivity between MotionBoard and Oracle
+
+1. Create New dashboard to check the connectivity.
+    1. Click the New and create new dashboard.
+    2. Create new data source of charts or spreadsheet.
+    3. Select the data source type you made in Step 2(for example “Oracle\_ADW”) from connect type.
+
+      ![](images/data_source_editior.jpeg)
+
+    4. Choose table or view in table and view list.
+
+      ![](images/data_sources_table_view.jpeg)
+
+    5. Drag and drop items from Item List to column, row and summary item field in Data Source Editor.
+    6. Click OK and save data source definition.
+
+2. When a chart or spreadsheet is deployed and show its data from Oracle, then you’re now ready to  read  data  from  Oracle  Autonomous  Data  Warehouse.  And  analyze,  visualize  the  with MotionBoard.
+
+    ![](images/wingarc1st_chart_view.jpeg)
+
+
+
+## **Acknowledgements**
+* **Author(s)** - Milton Wan
+* **Contributor(s)** -
+* **Last Updated By/Date** -  23/Jul/2019

wingarc1st/wingarc1st-motionboard.md

@@ -0,0 +1,88 @@
+**Creating a connection from MotionBoard to   Oracle Autonomous Data Warehouse (ADW)**
+
+**Author:** **WingArc1st Inc.**
+
+**23/Jul/2019**
+
+
+
+
+
+**Prerequisites**
+
+- The  connection  destination  must  be  in  an  environment  where  it  can  communicate  with MotionBoard and runs correctly. It’s necessary that user have knowledge about network and server environment.
+- This document assumes that the Autonomous Data Warehouse has been provisioned and the corresponding wallet zip file has been downloaded to the system.
+
+**Step 1. Install MotionBoard**
+
+If there is a pre-existing Motionboard installed jump to Step 3 which describes the steps to configure ADWC as a target.
+
+To install Motionboard software please refer to the Install[ Documentation.](https://manual.wingarc-support.com/en-us/manual/mb/mb60/)
+
+**Step 2. Install Oracle driver on MotionBoard (ONLY for “on premises” version)**
+
+1. Open installer file and select “MotionBoard60 - extra”.
+2. Copy  “oracle\_autonomous.zip”  to “[InstallDir]\system\resources\communicator\drivers\extra”. 
+3. Restart “Motionboard 6.0” service.
+
+![](Aspose.Words.3c89a675-007c-4ae5-840c-ff3e31b899dc.001.jpeg)
+
+**Step 3. How to configure MotionBoard on a Windows environment**
+
+1  Select the type of data source to connect to
+
+1. Log in to MotionBoard as a user with administrator privileges.
+1. Select Management of the board menu - System Settings - Connection/Authentication - External Connection.
+
+![](Aspose.Words.3c89a675-007c-4ae5-840c-ff3e31b899dc.002.jpeg)
+
+3. Click the New button on the External Connection screen.
+3. Enter the name of the external connection settings in External Connection Name on the Create New External Connection screen.
+3. In Connection Type, select the connection destination (data source name).
+3. In Relay Service, select a connection method for connecting with the destination. If Relay Service does not appear, proceed to the next step.
+3. To connect directly to the connection destination, select Disable. Usually, you select this option.
+3. To use the Bridge Service, select Bridge Service and select the Bridge group to use for Bridge Group Name.
+3. To use the Federation Service, select Federation Service and select the Bridge group to use for Federation Name.
+3. Click the New button.
+3. Click the OK button on the message to confirm saving the settings.
+
+2  Specify information necessary for connection with Oracle Autonomous Data Warehouse
+
+1. Click the Basic Information tab in the External Connection screen.
+1. Specify Driver Type. Select to connect to “Oracle Autonomous(JDBC)”.
+1. Check the settings for Relay Service and change them as necessary.
+1. In Service Name, specify the name of the Oracle Autonomous Data Warehouse Service.
+1. Click “Select” button of Wallet and select corresponding wallet zip file.
+6. In  User  Name,  specify  the  user  ID  equivalent  to  the  server  administrator  of  Oracle Autonomous Data Warehouse.
+6. Click the Password setting button of Password, and specify the password for User Name.
+
+![](Aspose.Words.3c89a675-007c-4ae5-840c-ff3e31b899dc.003.jpeg)
+
+3  Confirm you can connect to the connection destination
+
+1. Click the Connection Test button.
+1. If a message indicating connection succeeded is displayed, proceed to the next step.
+1. If a message indicating connection failed is displayed, return to the previous step and review the setting.
+1. Click the Save button.
+1. Click the OK button on the message to confirm saving the settings.
+
+**Step 4. Check connectivity between MotionBoard and Oracle** 1  Create New dashboard to check the connectivity.
+
+1. Click the New and create new dashboard.
+1. Create new data source of charts or spreadsheet.
+3. Select the data source type you made in Step 2(for example “Oracle\_ADW”) from connect type.
+
+![](Aspose.Words.3c89a675-007c-4ae5-840c-ff3e31b899dc.004.jpeg)
+
+4. Choose table or view in table and view list.
+
+![](Aspose.Words.3c89a675-007c-4ae5-840c-ff3e31b899dc.005.jpeg)
+
+5. Drag and drop items from Item List to column, row and summary item field in Data Source Editor.
+5. Click OK and save data source definition.
+
+2  When a chart or spreadsheet is deployed and show its data from Oracle, then you’re now ready
+
+to  read  data  from  Oracle  Autonomous  Data  Warehouse.  And  analyze,  visualize  the  with MotionBoard.
+
+![](Aspose.Words.3c89a675-007c-4ae5-840c-ff3e31b899dc.006.jpeg)

wingarc1st/workshops/freetier/index.html

@@ -0,0 +1,62 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="description" content="Oracle LiveLabs gives you access to Oracle's products to run a wide variety of labs and workshops; allowing you to experience our best technology, live!">
+    <title>Oracle LiveLabs</title>
+
+    <script src="https://oracle-livelabs.github.io/common/redwood-hol/js/jquery-1.11.0.min.js"></script>
+    <script src="https://oracle-livelabs.github.io/common/redwood-hol/js/jquery-ui-1.10.4.custom.js"></script>
+    <script src="https://oracle-livelabs.github.io/common/redwood-hol/js/main.min.js"></script>
+
+    <link rel="stylesheet" href="https://oracle-livelabs.github.io/common/redwood-hol/css/style.min.css" />
+    <link rel="shortcut icon" href="https://oracle-livelabs.github.io/common/redwood-hol/img/favicon.ico" />
+</head>
+
+<body>
+    <header class="hol-Header" role="banner">
+        <div class="hol-Header-wrap">
+            <div class="hol-Header-logo"><span>Oracle LiveLabs</span></div>
+            <a href="https://developer.oracle.com/livelabs" target="_blank" id="livelabs" title="Oracle LiveLabs"></a>
+            <div class="hol-Header-actions">
+                <button id="openNav" class="hol-Header-button hol-Header-button--menu rightNav" aria-label="Open Menu"
+                    title="Open Menu">
+                    <span class="hol-Header-toggleIcon"></span>
+                </button>
+            </div>
+        </div>
+    </header>
+
+    <div id="container">
+        <div id="leftNav">
+            <div id="toc"></div>
+        </div>
+        <div id="contentBox">
+            <main class="hol-Content" id="module-content"></main>
+        </div>
+    </div>
+
+      <footer class="hol-Footer">
+        <a class="hol-Footer-topLink" href="#top">Return to Top</a>
+        <div id="footer-banner"><div class="footer-row">
+          <div class="footer-content"><ul class="footer-links">
+              <li><a href="https://docs.oracle.com/pls/topic/lookup?ctx=en/legal&id=cpyr" target="_blank" aria-label="Open a new window to Oracle legal notices" data-lbl="copyright">© Oracle</a></li>
+              <li><a href="https://www.oracle.com/corporate/index.html" target="_blank" aria-label="Open a new window to learn more about oracle" data-lbl="about-oracle">About Oracle</a></li>
+              <li><a href="https://www.oracle.com/corporate/contact/" target="_blank" aria-label="Open a new window to contact oracle" data-lbl="contact-us">Contact Us</a></li>
+              <li class="footer-links-break"></li>
+              <li><a href="https://docs.oracle.com/en/browseall.html" target="_blank" aria-label="Open a new window to products a-z" data-lbl="products-a-z">Products A-Z</a></li>
+              <li><a href="https://www.oracle.com/legal/privacy/" target="_blank" aria-label="Open a new window to read more about Oracle terms of use and privacy" data-lbl="terms-of-use-and-privacy">Terms of Use & Privacy</a></li>
+              <li><a href="https://www.oracle.com/legal/privacy/privacy-policy.html#11" target="_blank" aria-label="Open a new window to read more about managing  Oracle cookie preferences" data-lbl="cookie-preferences">Cookie Preferences</a></li>
+              <li><a href="https://www.oracle.com/legal/privacy/marketing-cloud-data-cloud-privacy-policy.html#adchoices" target="_blank" aria-label="Open a new window to ad choices" data-lbl="ad-choices">Ad Choices</a></li>
+              <li class="footer-links-break"></li><li class="last"><a href="https://docs.oracle.com/pls/topic/lookup?ctx=en/legal&id=cpyr" target="_blank" aria-label="Open a new window to Oracle legal notices" data-lbl="copyright">© Oracle</a></li>
+            </ul>
+          </div>
+        </div>
+      </div>
+    </footer>
+</body>
+
+</html>

wingarc1st/workshops/freetier/manifest.json

@@ -0,0 +1,26 @@
+{
+  "workshoptitle": "Connecting ........... to Oracle Autonomous Database",
+  "help": "[email protected]",
+  "tutorials": [
+    {
+      "title": "Connection Guide",
+      "description": "Connection Guide",
+      "filename": "../../wingarc1st-connector-guide.md"
+    },
+    {
+      "title": "Connecting with Wallet",
+      "description": "Connecting with Wallet",
+      "filename": "../../../common/wallet/wallet.md"
+    },
+    {
+      "title": "Connecting without Wallet",
+      "description": "Connecting without Wallet",
+      "filename": "../../../common/tls-no-wallet/no-wallet.md"
+    },
+    {
+      "title": "JDBC Configuration",
+      "description": "JDBC Configuration",
+      "filename": "../../../common/jdbc/jdbc-thin-wallet.md"
+    }
+  ]
+}