Skip to content

Commit

Permalink
Update common labs (#251)
Browse files Browse the repository at this point in the history
  • Loading branch information
carmenberdant1 authored Mar 25, 2024
1 parent 68a2716 commit 630c800
Show file tree
Hide file tree
Showing 35 changed files with 35 additions and 34 deletions.
2 changes: 1 addition & 1 deletion labs/cloud-login/cloud-login-livelabs-novnc.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,4 +64,4 @@ You may now **proceed to the next lab**.

- **Created By/Date** - Kay Malcolm, Database Product Management March 2020
- **Contributors** - Rene Fontcha, Kamryn Vinson, Anoosha Pilli, Arabella Yao
- **Last Updated By/Date** - Arabella Yao, Dec 2022
- **Last Updated By/Date** - Carmen Berdant, Mar 2024
Binary file modified labs/cloud-login/images/cloud-login-tenant.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/cloud-login/images/cloud-oracle.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/cloud-login/images/enable-secure-verification.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/cloud-login/images/username.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions labs/cloud-login/register-free-tier-account.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ If you've signed out of the Oracle Cloud, use these steps to sign back in.

4. You will be prompted to enable secure verification. Click **Enable Secure Verification**. For more details, refer the [Managing Multifactor Authentication documentation](https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/usingmfa.htm)

![Enable secure verification](./images/enable-secure-verification " ")
![Enable secure verification](./images/enable-secure-verification.png " ")

5. Select a method - **Mobile App** or **FIDO Authenticator** to enable secure verification.

Expand All @@ -89,4 +89,4 @@ You may now **proceed to the next lab**.

- **Created By/Date** - Kay Malcolm, Database Product Management, March 2020
- **Contributors** - John Peach, Madhusudhan Rao, Arabella Yao
- **Last Updated By/Date** - Anoosha Pilli, October 2023
- **Last Updated By/Date** - Carmen Berdant, Mar 2024
Original file line number Diff line number Diff line change
Expand Up @@ -87,4 +87,4 @@ You may now **proceed to the next lab**.
## Acknowledgements
* **Author** - Dan Kingsley, Enablement Specialist, OSPA
* **Contributors** - Arabella Yao, Database Product Management
* **Last Updated By/Date** - Arabella Yao, Dec 2022
* **Last Updated By/Date** - Carmen Berdant, Mar 2024
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ The Cloud Shell machine is a small virtual machine running a Bash shell which yo

>**Note:** If you get a *Policy Missing* error, make sure you have navigated first to the compartment assigned to you and then launched the cloud shell. Go to the *Need Help* lab -> *Cannot Access Cloud Shell?* to see how you can do that.
2. Once the cloud shell has started, enter the following commands. Choose the key name you can remember. This will be the key name you will use to connect to any compute instances you create. Press Enter twice for no passphrase.
3. Once the cloud shell has started, enter the following commands. Choose the key name you can remember. This will be the key name you will use to connect to any compute instances you create. Press Enter twice for no passphrase.

````text
<copy>mkdir .ssh</copy>
Expand All @@ -56,13 +56,14 @@ The Cloud Shell machine is a small virtual machine running a Bash shell which yo
````text
<copy>cd .ssh
ssh-keygen -b 2048 -t rsa -f cloudshellkey</copy>
ssh-keygen -b 2048 -t rsa -f <<sshkeyname>></copy>
````
*We recommend using the name cloudshellkey for your keyname but feel free to use the name of choice.*
>**Note:** The angle brackets <<>> should not appear in your code.
![Generate SSH key](./images/cloudshell-ssh.png " ")
3. Examine the two files that you just created.
4. Examine the two files that you just created.
````
<copy>ls</copy>
Expand All @@ -72,16 +73,16 @@ The Cloud Shell machine is a small virtual machine running a Bash shell which yo
>**Note:** In the output, there are two files, a *private key:* `cloudshellkey` and a *public key:* `cloudshellkey.pub`. Keep the private key safe and don't share its content with anyone. The public key will be needed for various activities and can be uploaded to certain systems as well as copied and pasted to facilitate secure communications in the cloud.
4. To list the contents of the public key, use the cat command:
5. To list the contents of the public key, use the cat command:
```text
<copy>cat cloudshellkey.pub</copy>
<copy>cat <<sshkeyname>>.pub</copy>
```
>**Note:** The angle brackets <<>> should not appear in your code.
![Cat in cloud shell](./images/cat.png " ")
5. Copy the contents of the public key and save it somewhere for later. When pasting the key into the compute instance in future labs, make sure that you remove any hard returns that may have been added when copying. *The .pub key should be one line.*
6. Copy the contents of the public key and save it somewhere for later. When pasting the key into the compute instance in future labs, make sure that you remove any hard returns that may have been added when copying. *The .pub key should be one line.*
![Copy public key](./images/copy-cat.png " ")
Expand All @@ -90,4 +91,4 @@ You may now **proceed to the next lab**.
## Acknowledgements
* **Author** - Dan Kingsley, Enablement Specialist, OSPA
* **Contributors** - Jaden McElvey, Kamryn Vinson, Arabella Yao
* **Last Updated By/Date** - Arabella Yao, Product Manager, Database Product Management, Dec 2022
* **Last Updated By/Date** - Carmen Berdant, Technical Project Manager, Database Product Management, Mar 2024
10 changes: 5 additions & 5 deletions labs/need-help/need-help-freetier.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ After reading those troubleshooting tips, if you still find yourself stuck or wo
For more about getting support using our email, click [here](#HowtoFormatYourSupportEmailRequest).

### Common Issues Table of Contents
- [Connectivity Issues? Unable to Upload Data or Connect to the Database? Hmmm... can't reach this page? What ports should I open to gain access to the workshop?](#ConnectivityIssues?UnabletoUploadDataorConnecttotheDatabase?Hmmm...can'treachthispage?WhatportsshouldIopentogainaccesstotheworkshop?)
- [Connectivity Issues?](#ConnectivityIssues?)
- [Cannot Create Passwords for Database Users?](#CannotCreatePasswordsforDatabaseUsers?)
- [Cannot find Groups under Identity & Security in my tenancy?](CannotfindGroupsunderIdentity&Securityinmytenancy?)
- [Cannot find Groups under Identity and Security in my tenancy?](#CannotfindGroupsunderIdentityandSecurityinmytenancy?)

## How to Format Your Support Email Request
This will construct an email in your default mail application that is auto-populated to address our LiveLabs support inbox and will also include your current workshop in the subject line. Follow the steps below to contact us and get a quick resolution to your issue.
Expand All @@ -26,7 +26,7 @@ This will construct an email in your default mail application that is auto-popul

4. Attach a **Screenshot** and **Any Troubleshooting Steps** you've tried, so that we can recreate the issue and provide a timely and accurate solution.

## Connectivity Issues? Unable to Upload Data or Connect to the Database? Hmmm... can't reach this page? What ports should I open to gain access to the workshop?
## Connectivity Issues?

Are you connected to a **VPN**, **Corporate Network**, or behind a strict **Firewall**?

Expand Down Expand Up @@ -56,7 +56,7 @@ Try these options to access the environment again:

1. Make sure the password you enter satisfies the following [restrictions](https://docs.oracle.com/en/cloud/saas/marketing/responsys-user/Account_PasswordRestrictions.htm).

## Cannot find Groups under Identity & Security in my tenancy?
## Cannot find Groups under Identity and Security in my tenancy?

1. From the navigation menu, click **Identity & Security** and select **Domains** under **Identity**.

Expand All @@ -73,4 +73,4 @@ Try these options to access the environment again:
## Acknowledgements
* **Author** - LiveLabs Team
* **Contributors** - LiveLabs Team, Arabella Yao
* **Last Updated By/Date** - Arabella Yao, Product Manager, Database Product Management, Dec 2022
* **Last Updated By/Date** - Carmen Berdant, Technical Project Manager, Database Product Management, Mar 2024
4 changes: 2 additions & 2 deletions labs/need-help/need-help-livelabs.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ For more about getting support using our email, click [here](#HowtoFormatYourSup
### Common Issues Table of Contents
- [Can't Log in to Oracle Cloud](#CantLogintoOracleCloud)
- [Can't Create An Oracle Database? Nothing In Your Compartment?](#CantCreateanOracleDatabase?NothinginYourCompartment?)
- [Connectivity Issues? Unable to Upload Data or Connect to the Database? Hmmm... can't reach this page? What ports should I open to gain access to the workshop?](#ConnectivityIssues?UnabletoUploadDataorConnecttotheDatabase?Hmmm...can'treachthispage?WhatportsshouldIopentogainaccesstotheworkshop?)
- [Connectivity Issues?](#ConnectivityIssues?)
- [Cannot Access Cloud Shell?](#CannotAccessCloudShell?)
- [Cannot Connect to the Marketplace Compute Instance Using a Private SSH Key?](#CannotConnecttotheMarketplaceComputeInstanceUsingaPrivateSSHKey?)
- [Cannot Create Passwords for Database Users?](#CannotCreatePasswordsforDatabaseUsers?)
Expand Down Expand Up @@ -49,7 +49,7 @@ This will construct an email in your default mail application that is auto-popul

![Set region](./images/compartment-select.png)

## Connectivity Issues? Unable to Upload Data or Connect to the Database? Hmmm... can't reach this page? What ports should I open to gain access to the workshop?
## Connectivity Issues?

Are you connected to a **VPN**, **Corporate Network**, or behind a strict **Firewall**?

Expand Down
Binary file modified labs/setup-compute/images/apply-livelabsvcn.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/create-stack.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/creating.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/livelabsvcn.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/paste-ssh-key.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/ssh.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/stack-ad.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/stack-apply.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/stack-next.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/stack-succeed.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/setup-compute/images/stack-vm.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 5 additions & 5 deletions labs/setup-compute/setup-19c-freetier.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ There are multiple ways to connect to your cloud instance. Choose the way to co

- Oracle Cloud Shell
- MAC or Windows CYCGWIN Emulator
- Windows Using Putty
- Windows Using PuTTY

### Oracle Cloud Shell

Expand Down Expand Up @@ -151,9 +151,9 @@ There are multiple ways to connect to your cloud instance. Choose the way to co
>**Note:** If you encounter any errors with this task, please see the Troubleshooting Tips in the appendix.
### Windows using Putty
### Windows using PuTTY
1. Open up putty and create a new connection.
1. Open up PuTTY and create a new connection.
2. Enter a name for the session and click **Save**.
Expand Down Expand Up @@ -280,7 +280,7 @@ The participant is unable to log in to instance
#### Tips for fixing Issue #1
There may be several reasons why you can't log in to the instance. Here are some common ones we've seen from workshop participants
- Incorrectly formatted ssh key
- The user chose to log in from MAC Terminal, Putty, etc and the instance is being blocked by the company VPN (shut down VPNs and try to access or use Cloud Shell)
- The user chose to log in from MAC Terminal, PuTTY, etc and the instance is being blocked by the company VPN (shut down VPNs and try to access or use Cloud Shell)
- Incorrect name supplied for ssh key (Do not use sshkeyname, use the key name you provided)
- @ placed before opc user (Remove @ sign and log in using the format above)
- Make sure you are the oracle user (type the command *whoami* to check, if not, type *sudo su - oracle* to switch to the oracle user)
Expand Down Expand Up @@ -348,4 +348,4 @@ Reload your browser
## Acknowledgements
- **Author** - LiveLabs Team
- **Contributors** - Sanjay Narvekar, Troy Anthony, Anoosha Pilli, Arabella Yao, Kamryn Vinson, Jeffrey Malcolm Jr.
- **Last Updated By/Date** - Arabella Yao, Dec 2022
- **Last Updated By/Date** - Carmen Berdant, Mar 2024
8 changes: 4 additions & 4 deletions labs/setup-compute/setup-linux-ol7.8-ft-compute-instance.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,9 +132,9 @@ There are multiple ways to connect to your cloud instance. Choose the way to co
>**Note:** The angle brackets <> should not appear in your code.
### Windows using Putty
### Windows using PuTTY
1. Open up putty and create a new connection.
1. Open up PuTTY and create a new connection.
2. Enter a name for the session and click **Save**.
Expand Down Expand Up @@ -173,7 +173,7 @@ The participant is unable to log in to instance
#### Tips for fixing Issue #1
There may be several reasons why you can't log in to the instance. Here are some common ones we've seen from workshop participants
- Incorrectly formatted ssh key
- The user chose to log in from MAC Terminal, Putty, etc and the instance is being blocked by the company VPN (shut down VPNs and try to access or use Cloud Shell)
- The user chose to log in from MAC Terminal, PuTTY, etc and the instance is being blocked by the company VPN (shut down VPNs and try to access or use Cloud Shell)
- Incorrect name supplied for ssh key (Do not use sshkeyname, use the key name you provided)
- @ placed before opc user (Remove @ sign and log in using the format above)
- Make sure you are the oracle user (type the command *whoami* to check, if not, type *sudo su - oracle* to switch to the oracle user)
Expand Down Expand Up @@ -231,4 +231,4 @@ Reload your browser
## Acknowledgements
- **Author** - LiveLabs Team, DB Product Management
- **Contributors** - Jaden McElvey, Anoosha Pilli, Sanjay Narvekar, David Start, Arabella Yao
- **Last Updated By/Date** - Arabella Yao, Dec 2022
- **Last Updated By/Date** - Carmen Berdant, Mar 2024
Binary file modified labs/terminate-adb/images/choose-compartment.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/terminate-adb/images/choose-state.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/terminate-adb/images/demoatp-terminate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/terminate-adb/images/demoatp.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/terminate-adb/images/more-actions.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/terminate-adb/images/terminate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/terminate-adb/images/terminated.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/terminate-adb/images/terminating.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions labs/terminate-adb/terminate-adb.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

You can permanently delete (terminate) instances that you no longer need. Terminating an Oracle Autonomous Database permanently deletes the database data. However, automatic backups are not deleted if you have chosen Recovery Appliance or NFS as a backup destination. You can delete automatic backups directly from the Recovery Appliance or NFS.

This lab walks you through the steps to terminate an available or stopped Oracle Autonomous Database instance. For the purpose of this lab, an Always Free demo Oracle Autonomous Transaction Processing database instance named DEMOATP is provisioned in a compartment.
This lab walks you through the steps to terminate an available or stopped Oracle Autonomous Database instance. For the purpose of this lab, an Always Free demo Oracle Autonomous Transaction Processing database instance named DEMOATP is provisioned in a compartment.
>**Note:** While this lab terminates an Oracle Autonomous Transaction Processing database, the steps are the same for terminating an Oracle Autonomous Data Warehouse database.
Estimated Time: 5 minutes
Expand Down Expand Up @@ -78,4 +78,4 @@ Watch the video below for a quick walk-through of the lab.

* **Author** - Anoosha Pilli, Oracle Database Product Management, Product Manager
* **Contributor** - Arabella Yao, Product Manager, Database Product Management
* **Last Updated By/Date** - Arabella Yao, Dec 2022
* **Last Updated By/Date** - Carmen Berdant, Mar 2024
Binary file modified labs/verify-compute/images/login-info.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified labs/verify-compute/images/ssh.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 5 additions & 5 deletions labs/verify-compute/verify-compute-ssh-and-novnc.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ For ease of execution of this workshop, your VM instance has been pre-configured

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

>**Note:** While rare, you may see an error titled **Deceptive Site Ahead** or similar depending on your browser type as shown below.
>**Note:** Although uncommon, you may see an error titled **Deceptive Site Ahead** or similar depending on your browser type as shown below.
Public IP addresses used for LiveLabs provisioning come from a pool of reusable addresses and this error is because the address was previously used by a compute instance long terminated, but that wasn't properly secured, got compromised, and was flagged.

Expand All @@ -65,7 +65,7 @@ Access to the compute instance by SSH protocol through the terminal is optional.
Your options are:
1. Appendix 1A: Connect using Cloud Shell *(recommended)*
2. Appendix 1B: Connect using MAC or a Windows CYGWIN Emulator
3. Appendix 1C: Connect using Putty *(Requires you to install applications on your machine)*
3. Appendix 1C: Connect using PuTTY *(Requires you to install applications on your machine)*

## Appendix 1A: Upload Key to Cloud Shell and Connect

Expand Down Expand Up @@ -183,7 +183,7 @@ The participant is unable to log in to the compute instance
There may be several reasons why you can't log in to the instance. Here are some common ones we've seen from workshop participants
- Permissions are too open for the private key - be sure to chmod the file using `chmod 600 ~/.ssh/<yourprivatekeyname>`
- Incorrectly formatted SSH key
- The user chose to log in from MAC Terminal, Putty, etc and the instance is being blocked by the company VPN (shut down VPNs and try to access or use Cloud Shell)
- The user chose to log in from MAC Terminal, PuTTY, etc and the instance is being blocked by the company VPN (shut down VPNs and try to access or use Cloud Shell)
- Incorrect name supplied for SSH key (Do not use sshkeyname, use the SSH key name you provided)
- @ placed before opc user (Remove @ sign and log in using the format above)
- Make sure you are the *oracle* user (type the command *whoami* to check, if not type *sudo su - oracle* to switch to the oracle user)
Expand All @@ -193,7 +193,7 @@ There may be several reasons why you can't log in to the instance. Here are som
The participant is running PuTTY on Windows and needs a private SSH key in *ppk* format
#### Tips for fixing Issue #2
If you want to use Putty to connect to your server, you must convert your SSH key into a format compatible with Putty. To convert your key into the required .ppk format, you can use PuTTYgen.
If you want to use PuTTY to connect to your server, you must convert your SSH key into a format compatible with PuTTY. To convert your key into the required .ppk format, you can use PuTTYgen.
[Download PuTTYgen](https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=&cad=rja&uact=8&ved=2ahUKEwigtZLx47DwAhUYKFkFHf99BmAQFjAAegQIAxAD&url=https%3A%2F%2Fwww.puttygen.com%2F&usg=AOvVaw1fagG6hM51oZWfQB_rqn2t)
Expand All @@ -209,4 +209,4 @@ To use PuTTYgen to convert a key into .ppk format, complete the following steps:
## Acknowledgements
* **Author** - Rene Fontcha, LiveLabs Platform Lead, NA Technology
* **Contributor** - Arabella Yao, Product Manager, Database Product Management
* **Last Updated By/Date** - Arabella Yao, Dec 2022
* **Last Updated By/Date** - Carmen Berdant, Mar 2024

0 comments on commit 630c800

Please sign in to comment.