Skip to content

Commit

Permalink
LL ID #4004: DB Collective Changes 2 (#632)
Browse files Browse the repository at this point in the history
* Self-QA Updates

Adding workshop changes to further align with the Self-QA checklist.

* Update adb-free-container-setup.md

* Post-Testing Edits V1

* Update adb-free-container-setup.md

* Post-Testing Changes V2

* Updating Screenshots

* WMSID# 11693: Adding the initial workshop structure.

* Update adb-free-container-setup.md

* Update adb-free-container-setup.md

* [WMS ID #11029] DB Collective - JSON Duality Search

* WMS ID #11029: Minor fix

* Update manifest.json

* LL ID #4004: Add JSON Duality Intro

* LL ID# 4004: Minor Updates

* LL ID #4004: Minor updates.

* WMS ID #11693: Revising the workshop structure.

* WMS ID# 11693

* HOL 46

* DB Collective - JSON Updates

* LL ID #4004: DB Collective Changes
  • Loading branch information
Brianna-Ambler authored Aug 19, 2024
1 parent 543aaa5 commit 13fbdc2
Show file tree
Hide file tree
Showing 4 changed files with 189 additions and 75 deletions.
125 changes: 125 additions & 0 deletions 23aifree/introduction/using-novnc-remote-desktop.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,125 @@
# Use noVNC remote desktop

## Introduction
This lab will show you how to get started with your workshop with a remote desktop session.

Estimated Time: 10 minutes

### Objectives
In this lab, you will:
- Enable fullscreen display of remote desktop session
- Enable remote clipboard integration
- Open the workshop guide from the remote desktop

### Prerequisites

This lab assumes you have:
- Provisioned VM Instance configured with noVNC

## Task 1: Launch noVNC from LiveLabs

1. In your reservation tab, select "View Login Info".

2. Select "Launch Remote Desktop".

## Task 2: 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.

1. Click on the small gray tab on the middle-left side of your screen to open the control bar.

![Open control bar](./images/novnc-fullscreen-1.png " ")

2. Select *Fullscreen* to render the session on your entire screen.

![Click full screen](./images/novnc-fullscreen-2.png " ")
![Open full screen](./images/novnc-fullscreen-3.png " ")

## Task 3: Enable Copy/Paste from Local to Remote Desktop
During the execution of your labs, you may need to copy text from your *local PC/Mac* to the *remote desktop*, such as commands from the lab guide. While such direct copy/paste isn't supported as you will realize, you may proceed as indicated below to enable an alternative *local-to-remote clipboard* with Input Text Field.

1. Continuing from the last task above, Select the *clipboard* icon

![Click clipboard](./images/novnc-clipboard-1.png " ")

2. Copy some text from your local computer as illustrated below and paste it into the clipboard widget, then finally open up the desired application (e.g. Terminal) and paste accordingly using *mouse controls*

![Copy text](./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.
## Task 4: Open Your Workshop Guide

1. If the *Web* browser window(s) is(are) not already open side-by-side, double-click the *Get Started with your Workshop* icon from the remote desktop. This will launch one or two windows depending on the workshop.

![Get Started with your Workshop](./images/novnc-launch-get-started-1.png " ")

2. On the left window is your workshop guide and depending on your workshop, you may also have one or two browser tabs loaded with web apps. e.g. Weblogic console, Enterprise Manager Cloud Console, or a relevant application to your workshop such as SQL Developer, JDeveloper, etc.

![Workshop guide and sample webapp](./images/novnc-launch-get-started-2.png " ")
![Workshop guide and Oracle SQL Developer](./images/novnc-launch-get-started-3.png " ")

You may now **proceed to the next lab**.

## Appendix: Connect Remotely Using SSH

While your workshop can be executed end-to-end from the remote desktop, follow the steps provided below if you need to access the instance remotely using an SSH client such as Putty, Unix/Linux/MacOS Terminal, OCI cloud shell, and other terminal emulators available on Windows.

>**Note:** In this section you are enabling SSH access to the OS user running the remote desktop. This could be oracle, opc, or any other OS user for which the noVNC remote desktop has been configured.
This assumes that you already have an RSA-type SSH key-pair available on the local system where you will be connecting from. If you don't and for more info on creating and using SSH keys for your specific platform and client, please refer to the guide [Generate SSH Keys](https://oracle-livelabs.github.io/common/labs/generate-ssh-key)

1. Open the remote clipboard on the remote desktop as shown in *Task 2* and launch a terminal session

2. Paste the block below onto the remote clipboard first, then onto the terminal to create or update the file *$HOME/.ssh/authorized_keys* with the *Vi* editor

```text
<copy>
cd $HOME; mkdir .ssh; cd .ssh
vi authorized_keys
</copy>
```
![Update authorized keys](./images/novnc-copy-pub-key-4.png " ")
3. From the local system (e.g. your laptop) and with the exception of *Putty* users, locate the SSH public key from the key-pair, open it, and copy the entire content to the clipboard.
![Copy SSH public key](./images/novnc-copy-pub-key-1.png " ")
If using Putty you must load the private key (*.ppk*) into the *Puttygen* utility to see the relevant public key block to copy. Do not copy the content of the public key file directly as it will not work.
![Copy SSH public key using Putty](./images/novnc-copy-pub-key-2.png " ")
4. Paste the copied public key onto the remote clipboard first, then onto the terminal where you opened *authorized_keys* for edit
![Paste SSH key to authorized keys in remote desktop](./images/novnc-copy-pub-key-3.png " ")
5. Save and exit the *Vi* editor
6. Set required permissions on *$HOME/.ssh* and *authorized_keys*
```
<copy>
chmod 0700 $HOME/.ssh
chmod 0600 $HOME/.ssh/authorized_keys
</copy>
```
7. Test/Validate connectivity using the private key (for Unix/Linux/MacOS Terminal, OCI cloud shell, and Terminal emulators on Windows such as Cygwin and MobaXterm).
```text
ssh -i [path to private key] remote-user@[instance-public-ip-address]
```
e.g.
```text
<copy>
ssh -i /home/appuser1/.ssh/livelabs_rsa_priv [email protected]
</copy>
```
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.
## Acknowledgements
* **Author** - Rene Fontcha, LiveLabs Platform Lead, NA Technology
* **Contributors** - Arabella Yao, Product Manager, Database Product Management
* **Last Updated By/Date** - Ramona Magadan, March 2024
4 changes: 2 additions & 2 deletions 23aifree/workshops/sandbox-aivs-adb/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@
"filename": "../../introduction/intro-aivs-adb.md"
},
{
"title": "Get Started",
"title": "Get Started with NoVNC Remote Desktop",
"description": "Using noVNC Remote Desktop",
"filename": "https://oracle-livelabs.github.io/common/labs/remote-desktop/using-novnc-remote-desktop.md"
"filename": "../../introduction/using-novnc-remote-desktop.md"
},
{
"title": "Lab 1: Launch the Oracle ADB Free Container Image",
Expand Down
2 changes: 1 addition & 1 deletion db-23ai-fundamentals/intro/json-dv-intro-15.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Key benefits of JSON Relational Duality:
- Duality Views eliminate the inherent problem of data duplication and data inconsistency in document databases. Duality Views are fully ACID (atomicity, consistency, isolation, durability) transactions across multiple documents and tables. It eliminates data duplication across documents data, whereas consistency is maintained automatically.
- Build apps that support high concurrency access and updates. Traditional locks don’t work well for modern apps. A new lock-free concurrency control provided with Duality View supports high concurrency updates. The new-lock free concurrency control also works efficiently for interactive applications since the data is not locked during human thinking time.

Estimated Time: 20 minutes
**_Estimated Time: 20 minutes_**

### **Objectives**

Expand Down
Loading

0 comments on commit 13fbdc2

Please sign in to comment.