Ready for next review cycle (#65)

* TimesTen: Initial population

* Work in progress

* Finalising workshop instructions etc.

* QA fixes #1

* QA fixes #2

* Typo and grammar corrections

* URL fixup, additional minor tweaks.

* Minor updates and fixes.

* Improve connection instructions.

* cleanup migration

cleanup migration

* clean up after migration

clean up after migration

* Update to README file

* Various improvements based on feedback.

* URL corrections

* Correcting e-mail address for 'help'

* Tiny changes

* Urgent fixes from first round review

* Latest changes

* Various edits

* More changes

* Final changes before next review cycle

Co-authored-by: Kevin Lazarz <kevin.lazarz@oracle.com>

Author: ChrisJ60

timesten/cache-introduction/00-novnc/images/novnc-launch-get-started-2.png

@@ -2,9 +2,7 @@
 
 ## Introduction
 
-This workshop can be accessed using a browser based graphical remote desktop (noVNC). It can also be accessed using SSH. You are free to use either method but we recommend SSH as for this workshop it provides a superior experience.
-
-This lab will show you how to get started with your workshop with a remote desktop session and how to enable SSH access. 
+This workshop can be accessed using a browser based graphical remote desktop (noVNC). It can also be accessed using SSH. This lab will show you how to get started with your workshop with a remote desktop session, and how to enable SSH access. 
 
 **Estimated Lab Time**: 10 minutes
 
@@ -15,14 +13,14 @@ In this lab, you will:
 - Enable fullscreen display of remote desktop session
 - Enable remote clipboard integration
 - Open the workshop guide from the remote desktop
-- Enable SSH access (optional but recommended)
+- Enable SSH access (optional)
 
 ### Prerequisites
 
 This lab assumes you have:
 
 - Launched the workshop in the LiveLabs environment
-- An RSA format SSH private/public key pair to use to access the OCI instance (optional)
+- An RSA format SSH private/public key pair to use to access the OCI instance using SSH (optional)
 
 If you need help in generating a suitable SSH key pair, please consult [this tutorial](https://docs.oracle.com/en/learn/generate_ssh_keys/index.html).
 
@@ -50,19 +48,19 @@ During the execution of your labs you may need to copy text from your local PC/M
     ![](./images/novnc-clipboard-2.png " ")
 
     *Note:* Please make sure you initialize your clipboard with step [1] shown in the screenshot above before opening the target application in which you intend to paste the text. Otherwise will find the *paste* function in the context menu grayed out when attempting to paste for the first time.
+    
+    **IMPORTANT:** Due to the slightly cumbesome nature of copying between your host system and the NoVNC session, we recommend that you perform all of the copy/paste actiosn within the NoVNC session. Alternatively, access the workshop's OCI instance via SSH and copy/paste between your host and your SSH session.
 
 ## Task 3: Open Your Workshop Guide
 
-1. If the *Web* browser window(s) is(are) not already open side-by-side, double-click on the *Get Started with your Workshop* icon from the remote desktop. This will launch one or two windows depending on the workshop.
+1. If the *Web* browser window is not already open, double-click on the *Get Started with your Workshop* icon from the remote desktop. This will open the workshop instructions within the NoVNC session (ideal for copy/paste).
 
     ![](./images/novnc-launch-get-started-1.png " ")
 
-2. On the left windows is your workshop guide and depending on your workshop, you may also one or two browser tabs loaded with webapps. e.g. Weblogic console, Enterprise Manager Cloud Console, or a relevant application to your workshop such as SQL Developer, JDeveloper, etc.
+2. On the left is the browser window with your workshop guide
 
     ![](./images/novnc-launch-get-started-2.png " ")
-    ![](./images/novnc-launch-get-started-3.png " ")
 
-You may now proceed to the next lab.
 
 ## Task 4: Configure SSH access (optional).
 
@@ -118,6 +116,8 @@ This assumes that you already have an RSA type SSH key-pair available on the loc
     ```
 
     For Putty, please refer to the guide [Generate SSH Keys](https://oracle-livelabs.github.io/common/labs/generate-ssh-key) on how to establish the connection using the *.ppk* private key.
+    
+You can now *proceed to the next lab*.
 
 ## Acknowledgements
 * **Author** - Rene Fontcha, LiveLabs Platform Lead, NA Technology

timesten/cache-introduction/00-novnc/novnc-livelabs.md

@@ -1,12 +1,10 @@
-# Using noVNC Remote Desktop
+# Using noVNC Remote Desktop and enabling SSH access
 
 ## Introduction
 
-This workshop can be accessed using a browser based graphical remote desktop (noVNC) or via SSH. You are free to use either method, but we recommend SSH as for this workshop it provides a superior experience.
+This workshop can be accessed using a browser based graphical remote desktop (noVNC). It can also be accessed using SSH. This lab will show you how to get started with your workshop with a remote desktop session. 
 
-This lab will show you how to get started with your workshop with a remote desktop session. SSH access was (optionally) provisioned when you created the OCI instance using the provided ORM stack file.
-
-If you prefer to use SSH access (recommended), and do not plan to use the graphical desktop, then you can skip the rest of this lab and *proceed to the next lab.*
+If you plan to only use SSH access then you can *proceed to the next lab*.
 
 **Estimated Lab Time**: 5 minutes
 
@@ -22,7 +20,7 @@ In this lab, you will:
 
 This lab assumes you have:
 
-- Launched the workshop in your own tenancy (paid or free trial)
+- Launched the workshop in your own tenancy using via the provided ORM stack
 
 ## Task 1: Enable Full-screen Display
 For seamless desktop integration and to make the best use of your display, perform the following tasks to render your remote desktop session in fullscreen mode.
@@ -48,21 +46,22 @@ During the execution of your labs you may need to copy text from your local PC/M
     ![](./images/novnc-clipboard-2.png " ")
 
     *Note:* Please make sure you initialize your clipboard with step [1] shown in the screenshot above before opening the target application in which you intend to paste the text. Otherwise will find the *paste* function in the context menu grayed out when attempting to paste for the first time.
+    
+    **IMPORTANT:** Due to the slightly cumbesome nature of copying between your host system and the NoVNC session, we recommend that you perform all of the copy/paste actions within the NoVNC session rather than between your host and the NoVNC session.
 
 ## Task 3: Open Your Workshop Guide
 
-1. If the *Web* browser window(s) is(are) not already open side-by-side, double-click on the *Get Started with your Workshop* icon from the remote desktop. This will launch one or two windows depending on the workshop.
+1. If the *Web* browser window is not already open, double-click on the *Get Started with your Workshop* icon from the remote desktop. This will open the workshop instructions within the NoVNC session (ideal for copy/paste).
 
     ![](./images/novnc-launch-get-started-1.png " ")
 
-2. On the left windows is your workshop guide and depending on your workshop, you may also one or two browser tabs loaded with webapps. e.g. Weblogic console, Enterprise Manager Cloud Console, or a relevant application to your workshop such as SQL Developer, JDeveloper, etc.
+2. On the left is the browser window with your workshop guide
 
     ![](./images/novnc-launch-get-started-2.png " ")
-    ![](./images/novnc-launch-get-started-3.png " ")
 
-You may now *proceed to the next lab*.
+*You may now proceed to the next lab.*
 
 ## Acknowledgements
 * **Author** - Rene Fontcha, LiveLabs Platform Lead, NA Technology
 * **Contributors** - Arabella Yao, Database Product Management
-* **Last Updated By/Date** - Chris Jenkins, July 2022
+* **Last Updated By/Date** - Chris Jenkins, August 2022

timesten/cache-introduction/00-novnc/novnc-owntenancy.md

@@ -4,7 +4,7 @@
 
 This lab will show you how to setup a Resource Manager stack that will generate the Oracle Cloud objects needed to run your workshop.
 
-*Estimated Lab Time:* 15 minutes
+**Estimated Lab Time:** 15 minutes
 
 ### About Terraform and Oracle Cloud Resource Manager
 
@@ -27,10 +27,13 @@ This lab assumes you have:
 
 When using the downloaded ORM stack file to deploy the required OCI resources you have two options:
 
-- Allow the stack to create and configure a private, dedicated network (VNC and subnet) for you
+- Allow the stack to create and configure a private, dedicated network (VNC and subnet) for you (recommended)
+
 - Specify an existing, suitably configured, network (VCN and subnet) to be used
 
-The rest of thi lab assumes that you will allow the stack to create the network for you. If you wish to use an existing network (see *Lab: Prepare Setup *for details of required Ingress rules) then consult the Appendix below for instructions.
+The rest of this lab assumes that you will allow the stack to create the network for you.
+
+If you wish to use an existing network (see *Lab: Prepare Setup* for details of required **Ingress** rules) then consult **Appendix 3** below for instructions.
 
 ## Task 2: Create Stack:  Compute + Networking
 
@@ -58,81 +61,27 @@ The rest of thi lab assumes that you will allow the stack to create the network
 7. Depending on the quota you have in your tenancy you can choose from standard Compute shapes or Flex shapes. Please visit the Appendix: Troubleshooting Tips for instructions on checking your quota
     - **Use Flexible Instance Shape with Adjustable OCPU Count?:** Keep the default as checked (unless you plan on using a fixed shape)
     - **Instance Shape:** Keep the default or select from the list of Flex shapes in the dropdown menu (e.g *VM.Standard.E4.Flex*).
-    - **Instance OCPUS:** Accept the default shown. e.g. (**4**) will provision 4 OCPUs and 64GB of memory. You may also elect to reduce or increase the count by selecting from the dropdown. e.g. `[2-24]`. Please ensure you have the capacity available before increasing.
+    - **Instance OCPUS:** Accept the default shown. e.g. **4** will provision 4 OCPUs and 64GB of memory, which is the minimum for this workshop. Please ensure you have the capacity available before increasing the resources.
 8.  If don't have quota for Flex Shapes or you prefer to use fixed shapes, follow the instructions below.  Otherwise skip to the next step.
     - **Use Flexible Instance Shape with Adjustable OCPU Count?:** Unchecked
-    - **Instance Shape:** Accept the default shown or select from the dropdown. e.g. VM.Standard2.2
+    - **Instance Shape:** Accept the default shown or select from the dropdown. e.g. VM.Standard2.4
 
   ![](./images/create-stack-novnc-3.png " ")
 
-10. For this section we will provision a new VCN with all the appropriate ingress and egress rules needed to run this workshop.  If you already have a VCN, make sure it has all of the correct ingress and egress rules and skip to the next section.
+10. In this section we are provisioning a new VCN with all the appropriate ingress and egress rules needed to run this workshop (recommended).
     - **Use Existing VCN?:** Accept the default by leaving this unchecked. This will create a **new VCN**.
 
 11. Click **Next**.
+
 12. Select **Run Apply** and click **Create**.
 
   ![](./images/create-stack-novnc-4.png " ")
 
-13. Your stack has is now created and the *Apply* action triggered is running to deploy your environment!  
+13. Your stack has is now created and the *Apply* action is running to deploy your environment!  
 
   ![](./images/create-stack-novnc-5.png " ")
 
-You may now proceed to Task 2 (skip Task 1B).
-
-## Task 1B: Create Stack:  Compute only
-If you just completed Task 1A, please proceed to Task 2.  If you have an existing VCN and are comfortable updating VCN configurations, please ensure your VCN meets the minimum requirements. Refer to *Lab: Prepare Setup*       
-
-  *Note:* We recommend letting our stack create the VCN to reduce the potential for error.
-
-1.  Identify the ORM stack zip file downloaded in *Lab: Prepare Setup*
-2.  Login to Oracle Cloud
-3.  Open up the hamburger menu in the left hand corner.  Choose the compartment in which you would like to install.  Choose **Resource Manager > Stacks**.  
-
-  ![](https://oracle-livelabs.github.io/common/images/console/developer-resmgr-stacks.png " ")
-
-  ![](./images/create-stack.png " ")
-
-4. Select **My Configuration**, click the **Browse** link and select the zip file (dbsec-lab-mkplc-freetier.zip) that you downloaded. Click **Select**.
-
-  ![](./images/create-stack-novnc-1.png " ")
-
-  Enter the following information:
-    - **Name**:  Enter a name  or keep the prefilled default (*DO NOT ENTER ANY SPECIAL CHARACTERS HERE*, including periods, underscores, exclamation etc, it will mess up the configuration and you will get an error during the apply process)
-    - **Description**:  Same as above
-    - **Create in compartment**:  Select the correct compartment if not already selected
-
-  *Note:* If this is a newly provisioned tenant such as freetier with no user created compartment, stop here and first create it before proceeding.
-
-5. Click **Next**.
-
-  ![](./images/create-stack-novnc-6.png " ")
-
-  Enter or select the following:
-    - **Instance Count:** Keep the default to **1** to create only one instance. You may also choose to a higher number if you need more than one instance created.
-    - **Select Availability Domain:** Select an availability domain from the dropdown list.
-    - **Use Flexible Instance Shape with Adjustable OCPU Count?:** Keep the default as checked (unless you plan on using a fixed shape)
-    - **Instance Shape:** Keep the default or select from the list of Flex shapes in the dropdown menu (e.g *VM.Standard.E4.Flex*).
-    - **Instance OCPUS:** Accept the default shown. e.g. (**4**) will provision 4 OCPUs and 64GB of memory. You may also elect to reduce or increase the count by selecting from the dropdown. e.g. `[2-24]`. Please ensure you have the capacity available before increasing.
-    - **Use Existing VCN?:** Check to select.
-    - **Select Existing VCN?:** Select existing VCN with regional public subnet and required security list.
-
-  *Note:* For an existing VCN Option to be used successful, review the details at the bottom of this section
-
-6. If you prefer to use fixed shapes, follow the instructions below.  Otherwise skip to the next step.
-    - **Use Flexible Instance Shape with Adjustable OCPU Count?:** Unchecked
-    - **Instance Shape:** Accept the default shown or select from the dropdown. e.g. VM.Standard.E2.2
-
-  ![](./images/create-stack-novnc-7.png " ")
-
-7. Review and click **Create**.
-
-  ![](./images/create-stack-novnc-8.png " ")
-
-8. Your stack has is now created and the *Apply* action triggered is running to deploy your environment!
-
-  ![](./images/create-stack-novnc-5.png " ")
-
-## Task 2: Terraform Apply
+## Task 3: Terraform Apply
 In the prior steps we elected to trigger the *terraform apply action* on stack creation.
 
 1.  Review the job output.
@@ -143,7 +92,7 @@ In the prior steps we elected to trigger the *terraform apply action* on stack c
 3.  Your public IP address(es), instance name(s), and remote desktop URL are displayed.
 
 
-## Task 3: Access the Graphical Remote Desktop
+## Task 4: Access the Graphical Remote Desktop
 For ease of execution of this workshop, your VM instance has been pre-configured with a remote graphical desktop accessible using any modern browser on your laptop or workstation. Proceed as detailed below to login.
 
 1. Navigate to **Stack Details**, **Application Information** tab, and click on the remote desktop URL
@@ -161,6 +110,8 @@ For ease of execution of this workshop, your VM instance has been pre-configured
     Public IP addresses used for LiveLabs provisioning comes from a pool of reusable addresses and this error is due to the fact that the address was previously used by a compute instance long terminated, but that wasn't properly secured, got bridged and was flagged. You can safely ignore and proceed by clicking on *Details*, and finally on *Visit this unsafe site*.
 
   ![](images/novnc-deceptive-site-error.png " ")
+  
+You can now *proceed to the next lab*.
 
 ## Appendix 1:  Terraform and Resource Manager
 Terraform is a tool for building, changing, and versioning infrastructure safely and efficiently.  Configuration files describe to Terraform the components needed to run a single application or your entire datacenter.  In this lab a configuration file has been created for you to build network and compute components.  The compute component you will build creates an image out of Oracle's Cloud Marketplace.  This image is running Oracle Linux 7.
@@ -251,7 +202,62 @@ Modify your stack to use fixed shapes instead.
 1. Uncheck the option *"Use Flexible Instance Shape with Adjustable OCPU Count"* to use fixed shape instead
 ![](./images/standardshape.png " ")
 
+## Appendix 3: Create Stack using an existing VCN
+
+If you have an existing VCN which you wish to use, and are comfortable updating VCN configurations, please ensure your VCN meets the minimum requirements. Refer to *Lab: Prepare Setup*
+
+*Note:* We recommend letting our stack create the VCN to reduce the potential for error.
+
+1.  Identify the ORM stack zip file downloaded in *Lab: Prepare Setup*
+2.  Login to Oracle Cloud
+3.  Open up the hamburger menu in the left hand corner.  Choose the compartment in which you would like to install.  Choose **Resource Manager > Stacks**.  
+
+  ![](https://oracle-livelabs.github.io/common/images/console/developer-resmgr-stacks.png " ")
+
+  ![](./images/create-stack.png " ")
+
+4. Select **My Configuration**, click the **Browse** link and select the zip file (dbsec-lab-mkplc-freetier.zip) that you downloaded. Click **Select**.
+
+  ![](./images/create-stack-novnc-1.png " ")
+
+  Enter the following information:
+    - **Name**:  Enter a name  or keep the prefilled default (*DO NOT ENTER ANY SPECIAL CHARACTERS HERE*, including periods, underscores, exclamation etc, it will mess up the configuration and you will get an error during the apply process)
+    - **Description**:  Same as above
+    - **Create in compartment**:  Select the correct compartment if not already selected
+
+  *Note:* If this is a newly provisioned tenant such as freetier with no user created compartment, stop here and first create it before proceeding.
+
+5. Click **Next**.
+
+  ![](./images/create-stack-novnc-6.png " ")
+
+  Enter or select the following:
+    - **Instance Count:** Keep the default to **1** to create only one instance. You may also choose to a higher number if you need more than one instance created.
+    - **Select Availability Domain:** Select an availability domain from the dropdown list.
+    - **Use Flexible Instance Shape with Adjustable OCPU Count?:** Keep the default as checked (unless you plan on using a fixed shape)
+    - **Instance Shape:** Keep the default or select from the list of Flex shapes in the dropdown menu (e.g *VM.Standard.E4.Flex*).
+    - **Instance OCPUS:** Accept the default shown. e.g. **4** will provision 4 OCPUs and 64GB of memory, which is the minimum for this workshop. Please ensure you have the capacity available before increasing the resources.
+    - **Use Existing VCN?:** Check to select.
+    - **Select Existing VCN?:** Select existing VCN with regional public subnet and required security list.
+
+  *Note:* For an existing VCN Option to be used successful, review the details at the bottom of this section
+
+6. If you prefer to use fixed shapes, follow the instructions below.  Otherwise skip to the next step.
+    - **Use Flexible Instance Shape with Adjustable OCPU Count?:** Unchecked
+    - **Instance Shape:** Accept the default shown or select from the dropdown. e.g. VM.Standard.E2.4
+
+  ![](./images/create-stack-novnc-7.png " ")
+
+7. Review and click **Create**.
+
+  ![](./images/create-stack-novnc-8.png " ")
+
+8. Your stack has is now created and the *Apply* action is running to deploy your environment!
+
+  ![](./images/create-stack-novnc-5.png " ")
+
+You may now return to **Task 3: Terraform Apply** above.
 
 ## Acknowledgements
 * **Author** - Rene Fontcha, LiveLabs Platform Lead, NA Technology
-* **Last Updated By/Date** - Rene Fontcha, LiveLabs Platform Lead, NA Technology, August 2021
+* **Last Updated By/Date** - Chris Jenkins, August 2022