Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
96d0154
TimesTen: Initial population
ChrisJ60 Jun 14, 2022
d54ba8d
Work in progress
ChrisJ60 Jun 22, 2022
3406dc6
Finalising workshop instructions etc.
ChrisJ60 Jun 27, 2022
45381cb
QA fixes #1
ChrisJ60 Jun 27, 2022
a7c4e4b
QA fixes #2
ChrisJ60 Jun 27, 2022
a4f9f58
Merge remote-tracking branch 'upstream/main'
ChrisJ60 Jun 27, 2022
98589af
Typo and grammar corrections
ChrisJ60 Jun 28, 2022
7fbb9cd
URL fixup, additional minor tweaks.
ChrisJ60 Jun 28, 2022
381b57d
Minor updates and fixes.
ChrisJ60 Jun 29, 2022
e46870a
Improve connection instructions.
ChrisJ60 Jun 30, 2022
e16ee6f
cleanup migration
klazarz Jul 2, 2022
3e60bcf
Merge remote-tracking branch 'upstream/main'
klazarz Jul 4, 2022
7e41934
clean up after migration
klazarz Jul 4, 2022
07917c6
Merge remote-tracking branch 'upstream/main'
klazarz Jul 4, 2022
ac863b6
Update to README file
ChrisJ60 Jul 5, 2022
56ab688
Various improvements based on feedback.
ChrisJ60 Jul 5, 2022
6c653a4
URL corrections
ChrisJ60 Jul 5, 2022
f33703f
Correcting e-mail address for 'help'
ChrisJ60 Jul 6, 2022
edf52ff
Merge branch 'main' into pr/22
klazarz Jul 6, 2022
eacb4a3
Merge remote-tracking branch 'upstream/main'
ChrisJ60 Jul 6, 2022
90e5e0b
Tiny changes
ChrisJ60 Jul 6, 2022
9afdd7b
Merge remote-tracking branch 'upstream/main'
ChrisJ60 Jul 6, 2022
d366431
Urgent fixes from first round review
ChrisJ60 Jul 6, 2022
10cb320
Merge remote-tracking branch 'upstream/main'
ChrisJ60 Jul 28, 2022
12dee89
Latest changes
ChrisJ60 Aug 22, 2022
f4b0c62
Merge remote-tracking branch 'upstream/main'
ChrisJ60 Aug 22, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
125 changes: 125 additions & 0 deletions timesten/cache-introduction/00-novnc/novnc-livelabs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,125 @@
# Using noVNC Remote Desktop and enabling SSH access

## 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.

**Estimated Lab 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
- Enable SSH access (optional but recommended)

### 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)

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).

## 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.

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

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

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

![](./images/novnc-fullscreen-2.png " ")
![](./images/novnc-fullscreen-3.png " ")

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

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

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

![](./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 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.

![](./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.

![](./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).

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 cloudshell, and other terminal emulators available on Windows.

*Notes:* In this section you are enabling SSH access to the OS user running the remote desktop, wich for this workshop is the **oracle** user.

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://docs.oracle.com/en/learn/generate_ssh_keys/index.html)

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

```
<copy>
cd $HOME/.ssh
vi authorized_keys
</copy>
```

![](./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.

![](./images/novnc-copy-pub-key-1.png " ")

If using Putty you must load the private key (*.ppk*) into *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.

![](./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

![](./images/novnc-copy-pub-key-3.png " ")

5. Save and exit *vi* editor

6. Set required permissions on *authorized_keys*

```
<copy>
chmod 0600 authorized_keys
</copy>
```

7. Test/Validate connectivity using the private key (for Unix/Linux/MacOS Terminal, OCI cloudshell, and Terminal emulators on Windows such as Cygwin and MobaXterm).

```
ssh -i [path to private key] remote-user@[instance-public-ip-address]
e.g.
<copy>
ssh -i /home/youruser/.ssh/livelabs_rsa oracle@150.136.123.105
</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, Database Product Management
* **Last Updated By/Date** - Chris Jenkins, July 2022
68 changes: 68 additions & 0 deletions timesten/cache-introduction/00-novnc/novnc-owntenancy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Using noVNC Remote Desktop

## 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 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.*

**Estimated Lab Time**: 5 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:

- Launched the workshop in your own tenancy (paid or free trial)

## 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.

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

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

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

![](./images/novnc-fullscreen-2.png " ")
![](./images/novnc-fullscreen-3.png " ")

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

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

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

![](./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 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.

![](./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.

![](./images/novnc-launch-get-started-2.png " ")
![](./images/novnc-launch-get-started-3.png " ")

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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading