WMS ID: 11079 - Merge of workshop content ready for review (#7)

* TimesTen: Initial population

* Work in progress

* Finalising workshop instructions etc.

* QA fixes #1

* QA fixes #2

Author: ChrisJ60

timesten/README.md

@@ -0,0 +1,57 @@
+# TimesTen LiveLabs on GitHub - Welcome!
+[![](../../common/images/livelabs-banner-formarketplace.png)](https://bit.ly/golivelabs)
+
+Oracle TimesTen In-Memory Database (TimesTen) delivers real time application performance (low response time and high throughput) by changing the assumptions around where data resides at runtime. By managing data in memory, and optimizing data structures and access algorithms accordingly, database operations execute with maximum efficiency achieving dramatic gains in responsiveness and throughput.
+
+TimesTen is a relational database, with SQL as its access language and PL/SQL as its procedural language, so you can leverage your existing Oracle Database skills. TimesTen supports a wide range of database APIs such as JDBC, ODBC, ODP.NET and Oracle Call Interface (OCI). Several Open Source languages, such as Python and Node.js, are supported via Open Source APIs.
+
+TimesTen Scaleout, a shared nothing scale-out architecture based on the existing TimesTen in-memory technology, allows databases to transparently scale across dozens of hosts, reach hundreds of terabytes in size and support hundreds of millions of transactions per second without the need for manual database sharding or workload partitioning. 
+
+TimesTen can be deployed in two distinct ways:
+
+_TimesTen Classic_
+
+A single node database for applications that require the lowest and most consistent response time. High availability is provided via active-standby pair replication to another node, and also supports multiple read-only subscribers for scaling read heavy workloads.
+
+TimesTen Classic can also be deployed as a cache for Oracle Database. By caching a subset of your Oracle Database data in a TimesTen cache, you can dramatically improve the performance of data access. TimesTen provides a declarative caching mechanism which suports both readonly caching and read-write caching. Data change synchronistion, a standard feature of TimesTen cache, ensures that the cache and the backend database are always in sync.
+
+_TimesTen Scaleout_
+
+A shared nothing distributed database based on the existing TimesTen in-memory technology. TimesTen Scaleout allows databases to transparently scale across dozens of hosts, reach hundreds of terabytes in size and support hundreds of millions of transactions per second without the need for manual database sharding or workload partitioning. Scaleout features include concurrent parallel cross-node processing, transparent data distribution (with single database image) and elastic scaleout and scalein. High availability and fault tolerance are automatically provided through use of Scaleout's K-safety feature. TimesTen Scaleout supports most of the same features and APIs as TimesTen Classic.
+
+TimesTen Scaleout can also be deployed as a cache for Oracle Database, supporting a subset of the cache features of Timesten Classic.
+
+
+## How do I get started with TimesTen LiveLabs?
+
+Before attempting any of the workshops listed below you need to determine which type of environment you are going to utilize. You have the choice of running the workshops in your own Oracle Cloud tenancy or in a LiveLabs provided tenancy. If you want to use your own tenancy it can either be via an existing Oracle Cloud account to which you have access or you can register for an Oracle Cloud Trial Account.
+
+## Get an Oracle Cloud Trial Account for Free!
+If you don't have an Oracle Cloud account then you can quickly and easily sign up for a free trial account that provides:
+- $300 of free credits good for up to 3500 hours of Oracle Cloud usage
+- Credits can be used on all eligible Cloud Platform and Infrastructure services for the next 30 days
+- Your credit card will only be used for verification purposes and will not be charged unless you 'Upgrade to Paid' in My Services
+
+Click here to request your trial account: [https://www.oracle.com/cloud/free](https://www.oracle.com/cloud/free)
+
+## TimesTen Workshop Pre-requisites
+
+The TimesTen workshops have the following pre-requisites:
+  
+- A basic familiarity with relational databases and SQL
+
+## Available TimesTen Workshops
+- [Accelerate your Applications: Achieve Blazing Fast SQL With an Oracle TimesTen Cache](https://apexapps.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?p180_id=613)
+
+## TimesTen Related Pages
+- [TimesTen Product Home](https://www.oracle.com/au/application-development/)
+- [TimesTen Samples on GitHub](https://github.com/oracle-samples/oracle-timesten-samples)
+- [TimesTen Blogs](https://blogs.oracle.com/timesten/)
+
+## Documentation
+- [TimesTen Documentation](https://docs.oracle.com/en/database/other-databases/timesten/)
+ 
+## Need Help?
+Please first consult the "Need Help?" lab located at the bottom of your workshop to see if our FAQ can solve your problem.  If you have an issue that is specific to the contents of the workshop, please reach out to the author located in the "Acknowledgements" section at the bottom of each lab via email. Please include your workshop name and lab name. You can also include screenshots and attach files. If you have a more general issue, or would like to reach out to the LiveLabs management team, email us [here](mailto:livelabs-help_us@oracle.com).   
+
+If you do not have an Oracle Account, click [here](https://profile.oracle.com/myprofile/account/create-account.jspx) to create one.

timesten/cache-introduction/01-introduction/images/tt-cache-architecture.png

@@ -0,0 +1,70 @@
+# Introduction
+
+## About this Workshop
+
+In this workshop you will discover how deploying Oracle TimesTen In-Memory Database as an in-memory relational cache for Oracle Database can dramatically improve the response times for SQL queries, typically by an order of magnitude.
+
+Setting up a TimesTen cache is quick and easy. This workshop leads you through the process step by step and uses a simple OLTP application and some example queries to demonstrate the incredibly low query latencies provided by TimesTen.
+
+Estimated Workshop Time: **60 minutes**
+
+### About Oracle TimesTen In-Memory Database
+
+Oracle TimesTen In-Memory Database (TimesTen) delivers real time application performance (low response time and high throughput) by changing the assumptions around where data resides at runtime. By managing data in memory, and optimizing data structures and access algorithms accordingly, database operations execute with maximum efficiency achieving dramatic gains in responsiveness and throughput.
+
+TimesTen is a relational database, with SQL as its access language and PL/SQL as its procedural language, so you can leverage your existing Oracle Database skills. It supports a wide range of database APIs such as JDBC, ODBC, ODP.NET and Oracle Call Interface (OCI) and several Open Source languages, such as Python and Node.js, are supported via Open Source APIs. TimesTen provides full persistence and has built in high-availability.
+
+TimesTen can be deployed both as a database of record or as a high performance relational cache in front of an Oracle database to acceleratae Oracle database applications. This lab focuses on the cache deployment mode.
+
+![TimesTen Cache Architecture Diagram](./images/tt-cache-architecture.png " ")
+
+### Objectives
+
+In this workshop you will:
+
+* Start up the components required for the labs
+* Create a TimesTen instance
+* Execute some basic TimesTen commands
+* Prepare the Oracle database for TimesTen caching
+* Prepare a TimesTen datbase and set it up as a cache
+* Load data from the Oracle database into the cached tables and activate cache refresh
+* Verify cache refresh
+* Run a simple OLTP benchmark to see the performance benefit of TimesTen
+* Run some queries to see the speedup provided by TimesTen
+* Use dynamic cache groups
+* Shutdown the TimesTen cache and instance
+
+### Prerequisites
+
+This workshop assumes that you have:
+
+* Some familiarity with Oracle Database
+* A basic understanding of SQL
+
+In order to run this workshop you need:
+
+* An active Oracle Cloud account
+
+You can run this workshop:
+
+* In the LiveLabs sandbox
+* In your own tenancy using a paid Oracle Cloud account
+* Using a free-trial Oracle Cloud account
+
+This workshop does _not_ support the Oracle Cloud 'Always Free' tier due to that tier's resource restrictions.
+
+**IMPORTANT:** If you choose to run this workshop in your own tenancy, or using a free-trial Cloud account, please be sure to provision at least **4 CPUs** and **32 GB RAM** for the cloud instance used for the workshop.
+
+You may now ***proceed to the next lab***.
+
+## Learn More
+
+* [TimesTen Product Home](https://www.oracle.com/database/technologies/related/timesten.html)
+* [TimesTen Samples on GitHub](https://github.com/oracle-samples/oracle-timesten-samples)
+* [TimesTen Documentation](https://docs.oracle.com/en/database/other-databases/timesten/)
+
+## Acknowledgements
+
+* **Author** - Chris Jenkins, Senior Director, TimesTen Product Management
+* **Contributors** -  Doug Hood & Jenny Bloom, TimesTen Product Management
+* **Last Updated By/Date** - Chris Jenkins, July 2022

timesten/cache-introduction/01-introduction/introduction.md

@@ -0,0 +1,71 @@
+# Prepare Setup
+
+## Introduction
+
+In this lab, you will download the Oracle Resource Manager (ORM) stack zip file needed to setup the resource needed to run this workshop. This workshop requires a compute instance and a Virtual Cloud Network (VCN) and subnet.
+
+Estimated Time: **15 minutes**
+
+### Objectives
+
+-   Download the workshop's ORM stack
+-   Configure an existing Virtual Cloud Network (VCN) - optional
+
+### Prerequisites
+
+This lab assumes you have:
+
+- An Oracle Cloud account with enough resources to run this workshop. The minimum requirements are **4 CPUs, 32 GB RAM, 100 GB storage and one VCN/subnet**.
+
+## Task 1: Download Oracle Resource Manager (ORM) stack zip file
+
+1.  Click on the link below to download the Resource Manager zip file you need to build your environment:
+
+ [ll-timesten-cache-intro.zip](https://objectstorage.uk-london-1.oraclecloud.com/p/puzLjtCV8NbFGkuRWo1lVsdeFqS5E91KZ1Rfa7fkidhPEGVxuFTbtT32zkXOXtl0/n/intdouglashood/b/stacks/o/ll-timesten-cache-intro.zip)
+
+2.  Save in your downloads folder.
+
+We strongly recommend using this stack to create a self-contained/dedicated VCN with your instance(s). Skip to *Task 3* to follow our recommendations. If you would rather use an exiting VCN then proceed to the next task to update your existing VCN with the required Egress rules.
+
+## Task 2: Adding security rules to an existing VCN
+
+This workshop requires a certain number of ports to be available, a requirement that can be met by using the default ORM stack execution that creates a dedicated VCN. In order to use an existing VCN/subnet the following ports should be added to the Ingress rules.
+
+| Port           |Description                            |
+| :------------- | :------------------------------------ |
+| 22             | SSH                                   |
+| 80             | Remote Desktiop using noVNC           |
+| 6080           | Remote Desktop using noVNC            |
+
+1.  Go to *Networking >> Virtual Cloud Networks*
+
+2.  Choose your network
+
+3.  Under Resources, select *Security Lists*
+
+4.  Click on *Default Security Lists *under the Create Security List button
+
+5.  Click *Add Ingress Rule* button
+
+6.  Enter the following:
+    - Source CIDR: 0.0.0.0/0
+    - Destination Port Range: *Refer to above table*
+
+7.  Click the Add Ingress Rules button
+
+## Task 3: Setup your OCI compute instance
+
+Using the details from the two steps above, proceed to the lab *Environment Setup* to setup your workshop environment using Oracle Resource Manager (ORM) using one of the following options:
+
+  -  Create Stack:  *Compute + Networking*
+  -  Create Stack:  *Compute only* using an existing VCN where security lists have been updated as per *Task 2* above
+
+**IMPORTANT:** When deploying the workshop compute instance via the ORM stack, it is strongly recommended that you enable the optional SSH access using either your own SSH public key or a generated SSH key pair. SSH connectivity offers a better user experience, especially for copy/paste, than noVNC connectivity.
+
+You may now *proceed to the next lab (Environment setup)*.
+
+## Acknowledgements
+
+* **Author** - Chris Jenkins, Senior Director, TimesTen Product Management
+* **Contributors** -  Doug Hood & Jenny Bloom, TimesTen Product Management
+* **Last Updated By/Date** - Chris Jenkins, July 2022

timesten/cache-introduction/02-prepare-setup/prepare-setup.md

@@ -0,0 +1,82 @@
+# Connect to the workshop compute instance
+
+## Introduction
+
+In this lab you will learn the different ways to connect to the OCI compute instance that hosts the workshop.
+
+The workshop requires you to use a terminal session to run various commands and observe their output. Often you may need to copy and paste commands or text from the workshop instructions into the terminal session.
+
+If you chose to run the workshop in the LiveLabs sandbox then the only connection method available to you by default is a GUI session using the browser based VNC mechanism. It is possible to setup SSH connectivity by adding your own SSH key into the instance (follow the instructions provided in the noVNC lab).
+
+If you chose to run the workshop in your own tenancy, or in a free-trial Cloud account, then you can use the same browser based GUI connection method. Also, if you selected the option during deploymemnt via the ORM stack, you also have the option to use SSH connectivity (**strongly recommended)**. 
+
+Estimated Time: **5 minutes**
+
+### Objectives
+
+- Connect to the compute instance using noVNC
+- Connect to the compute instance using SSH (optional)
+
+### Prerequisites
+
+This lab assumes that you have:
+
+- Completed all the previous labs in this workshop, in sequence.
+
+## Task 1: Connect using noVNC
+
+_LiveLabs sandbox_
+
+In the LiveLabs reservation page for your active reservation you will see the URL to use for a noVNC connection to the workshop instance.
+
+_Own tenancy or free-trial Cloud account_
+
+At the end of the ORM stack apply job execution report you will see the noVNC connection URL.
+
+Copy / paste the URL into your browser and you should then see the workshop desktop.
+
+![Workshp noVNC Desktop](./images/novnc-desktop.png " ")
+
+You can use the *Activities* menu, or double click the *Terminal* icon on the desktop to open a terminal session.
+
+## Task 2: Connect using SSH (optional but recommended)
+
+You can connect to the instance as the oracle user using an SSH private key.
+
+_LiveLabs sandbox_
+
+You can follow the instructions in the noVNC lab to add an SSH poublic key to the oracle user's SSH **authorized_keys** file. You then connect using the corresponding SSH private key.
+
+_Own tenancy or free-trial Cloud account - user provided public key_
+
+If you provided your own SSH public key as part of the ORM stack deployment process then you can connect using the corresponding SSH private key.
+
+_Own tenancy or free-trial Cloud account - system generated key pair_
+
+The SSH private key needed to connect is displayed at the end of the ORM stack apply job log. Copy/paste the key into a file on your client computer, or import into into your SSH client, and use that file to connect.
+
+**NOTE:** On Linux and macOS systems, SSH private keys should be stored in your user's .ssh directory (**~/.ssh**) and must have permissions of **600 (rw-------)**.
+
+Assuming that the SSH private key is **~/.ssh/id_livelabs** and the oublic IP address of the workshop compiute instance is **123.123.123.123** then you can connect using:
+
+**ssh -i ~/.ssh/id_livelabs oracle@123.123.123.123**
+
+```
+$ ssh -i ~/.ssh/id_livelabs oracle@123.123.123.123                                                      11:55:17
+The authenticity of host '123.123.123.123 (123.123.123.123)' can't be established.
+ED25519 key fingerprint is SHA256:bm2wv3HgyBIhIRov6+EtId10rQHyq1LXpXglQMpqhqA.
+This key is not known by any other names
+Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
+Warning: Permanently added '140.238.69.118' (ED25519) to the list of known hosts.
+Last login: Mon Jun 27 09:12:52 2022 from aa.bb.cc.dd
+[oracle@ttlivelabvm ~]$
+```
+
+You can now *proceed to the next lab*. You can keep your terminal session open for use in the next lab.
+
+## Acknowledgements
+
+* **Author** - Chris Jenkins, Senior Director, TimesTen Product Management
+* **Contributors** -  Doug Hood & Jenny Bloom, TimesTen Product Management
+* **Last Updated By/Date** - Chris Jenkins, July 2022
+

timesten/cache-introduction/03-connect-to-instance/connect-to-instance.md

@@ -0,0 +1,58 @@
+# Initialize the workshop environment
+
+## Introduction
+
+In this lab you will start up all the components required to run the labs making up this workshop.
+
+The workshop uses an Oracle database which runs in its own container (**dbhost**). A second container (**tthost1**) provides the TimesTen environment. These containers, and the host system (**ttlivelabvm**), are all connected using a custom Docker network. This setup provides a realistic multi-host environment with the convenience of just a single compute instance.
+
+Estimated Time: 10 minutes.
+
+### Objectives
+
+- Initialize the workshop environment.
+
+### Prerequisites
+
+This lab assumes that you have:
+
+- Completed all the previous labs in this workshop, in sequence.
+
+### Starting over from the beginning
+
+Once you have successfully completed this lab, if at any point you want to start the whole workshop again from the beginning, just go the the **~/lab** directory and run the script **labReset.sh**. That script will take 5-8 minutes to run and it will reset everything back to the way it was after this lab completed.
+
+## Task 1: Connect to the environment
+
+Connect to the OCI compute instance and open a terminal session, as the user **oracle**,  using an appropriate method as discussed in the previous lab.
+
+## Task 2: Initialize and startup the lab components
+
+Change to the **lab** directory:
+
+**cd ~/lab**
+
+`[oracle@ttlivelabvm ~] cd ~/lab`
+
+Initialize the workshop:
+
+**labSetup.sh cache-intro**
+
+```
+[oracle@ttlivelabvm ~] labSetup.sh cache-intro
+info: setting up workshop 'cache-intro', this will take several minutes...
+info: starting hosts: OK
+info: host initialization: OK
+info: resetting Oracle Database state, please be patient...
+info: Oracle Database state successfully reset
+info: starting Oracle Database: OK
+```
+
+This command will take between 5 and 8 minutes to complete. Once the setup has completed successfully, *proceed to the next lab*. You can keep your terminal session open ready for the next lab.
+
+## Acknowledgements
+
+* **Author** - Chris Jenkins, Senior Director, TimesTen Product Management
+* **Contributors** -  Doug Hood & Jenny Bloom, TimesTen Product Management
+* **Last Updated By/Date** - Chris Jenkins, July 2022
+