New lab, "Hitchhiker's Guide for Upgrading to Oracle Database 23ai" (#…

…533) * Initial changes * Acknowledgements * Lab 10 - first edition * Start lab 11 plus lab 10 fixes * Lab 11, final changes * Lab 11 minor text changes * Lab 11 - restart source post-migration * Lab 12 * Small stuff * Lab 12 * Missing ``` * Lab 13 * Labs 3-5 update * Update autoupgrade.md * Labs 3-9 * Lab 15 downgrade * Lab 14 glitches * Changed release dates * Lab 14 - part 1 * Changing contributors * Trim spaces * Page changes * Update awr-compare.md * Update spa.md * Lab 14 * Update encrypted-db-upg-conv.md * Minor corrections * Lab 02 errors * Changes * Error fixing * Get rid of EXPORT and use env script * Lab 7 * More fixes * Missing exit in lab 14 * Image pptx * Fixing underscores * underscores * Small * Lab 8 finalize * Lab 9 * Lab 00 * Dummy change * Test change * Squashed commit of the following: commit 1d6978d Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 12:07:30 2024 -0300 Update migrate-using-ftex.md commit b71c67d Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 11:48:31 2024 -0300 Update upg-cdb-flashback.md commit 12a96a5 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 11:27:52 2024 -0300 Fix some details commit 637d577 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 10:32:57 2024 -0300 Update spm.md commit a1e191a Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 10:32:45 2024 -0300 Update spm.md commit 3e3cb76 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 10:16:14 2024 -0300 Update spm.md commit 8493933 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:54:26 2024 -0300 Update awr-compare.md commit 11c13cd Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:54:23 2024 -0300 Update explore-multitenant.md commit a891039 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:31:52 2024 -0300 Update awr-snapshot.md commit 6e3e57a Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:31:49 2024 -0300 Update explore-multitenant.md commit b4ee666 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:00:26 2024 -0300 Update explore-multitenant.md commit 8828c2b Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:00:23 2024 -0300 Update initialize-environment.md commit 3d94b33 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 08:53:52 2024 -0300 Update initialize-environment.md commit 5047abb Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 08:53:46 2024 -0300 Update introduction.md * Update explore-multitenant.md * Update upg-cdb-flashback.md * More stuff * f * Update initialize-environment.md * Delete ~$images.pptx * Squashed commit of the following: commit 87452a1 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Thu Jun 6 12:13:44 2024 -0300 Update migrate-using-ftex.md commit 2f89859 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Thu Jun 6 09:44:06 2024 -0300 Update upg-cdb-flashback.md commit e3da2b9 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Wed Jun 5 14:37:07 2024 -0300 Update explore-multitenant.md commit cfaa942 Merge: c1b40df f5ca582 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Wed Jun 5 11:40:22 2024 -0300 Merge branch 'main' into hammerdb-changes-doc commit c1b40df Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 16:07:15 2024 -0300 Fix typos commit 1d6978d Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 12:07:30 2024 -0300 Update migrate-using-ftex.md commit b71c67d Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 11:48:31 2024 -0300 Update upg-cdb-flashback.md commit 12a96a5 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 11:27:52 2024 -0300 Fix some details commit 637d577 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 10:32:57 2024 -0300 Update spm.md commit a1e191a Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 10:32:45 2024 -0300 Update spm.md commit 3e3cb76 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 10:16:14 2024 -0300 Update spm.md commit 8493933 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:54:26 2024 -0300 Update awr-compare.md commit 11c13cd Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:54:23 2024 -0300 Update explore-multitenant.md commit a891039 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:31:52 2024 -0300 Update awr-snapshot.md commit 6e3e57a Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:31:49 2024 -0300 Update explore-multitenant.md commit b4ee666 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:00:26 2024 -0300 Update explore-multitenant.md commit 8828c2b Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 09:00:23 2024 -0300 Update initialize-environment.md commit 3d94b33 Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 08:53:52 2024 -0300 Update initialize-environment.md commit 5047abb Author: Rodrigo Jorge <rodrigoaraujorge@hotmail.com> Date: Mon Jun 3 08:53:46 2024 -0300 Update introduction.md * Changes from Klaus + Alex * Klaus changes * Image error * Delete ~$images.pptx --------- Co-authored-by: Rodrigo Jorge <rodrigoaraujorge@hotmail.com>
oracle-livelabs · Jun 7, 2024 · 0be2bfb · 0be2bfb
1 parent f42f578
commit 0be2bfb
Show file tree

Hide file tree

Showing 56 changed files with 8,086 additions and 0 deletions.
diff --git a/hitchhikers-guide-upgrade-to-23ai/00-introduction/images/introduction-overview.png b/hitchhikers-guide-upgrade-to-23ai/00-introduction/images/introduction-overview.png
diff --git a/hitchhikers-guide-upgrade-to-23ai/00-introduction/images/lab-overview.png b/hitchhikers-guide-upgrade-to-23ai/00-introduction/images/lab-overview.png
diff --git a/hitchhikers-guide-upgrade-to-23ai/00-introduction/introduction.md b/hitchhikers-guide-upgrade-to-23ai/00-introduction/introduction.md
@@ -0,0 +1,56 @@
+# Introduction
+
+## About this Workshop
+
+Oracle Database 23ai is a *Long Term Support Release*. It is available or will be available on all popular on-prem platforms, Oracle Exadata Database Machine, Oracle Database Appliance, and in Oracle Cloud Infrastructure. As the latest Long Term Support Release, it offers customers the highest levels of stability and the longest error correction support. And, by upgrading to Oracle Database 23ai, customers will have Premier Support until the end of April 2029 and Extended Support until end of April 2032.  There is a direct upgrade path to Oracle Database 23ai from Oracle Database 19c and 21c, regardless of the Release Update applied.
+
+Estimated Workshop Time: 120 minutes
+
+### Objectives
+
+In this workshop, you will:
+
+* Upgrade databases
+* Use Performance Stability Perscription to ensure performance stability
+* Convert to multitenant architecture
+* Migrate databases using Data Pump and transportable tablespaces
+
+## About the workshop contents
+
+This workshop comes with pre-installed Oracle homes and pre-created databases.
+You can switch between environments with the shortcuts shown in the last column of the below diagram.
+
+![Overview of the Oracle Homes and databases in the lab](./images/introduction-overview.png " ")
+
+The lab contains 15 labs.
+
+![Overview of the labs](./images/lab-overview.png " ")
+
+* You start by completing labs 1 and 2.
+* Track 1 is the primary track. You should focus on labs 3 to 9.
+* When time allows, you can work on tracks 2 and 3.
+* In tracks 2 and 3, the order of the individual labs don't matter. You can perform the labs in any order, but only one lab from one track at a time.
+* As the last lab, you can perform lab 14.
+
+## Upgrade and data migration methods and processes
+
+### AutoUpgrade
+
+- AutoUpgrade is the only recommended tool to upgrade Oracle databases. Whether you want to upgrade only one or thousands of databases, AutoUpgrade performs not only the upgrade but also all the pre and post-upgrade tasks. It can upgrade many databases in parallel and allows all sorts of customizations needed in today's complex environments. Furthermore, AutoUpgrade can also plugin your database into a precreated CDB and does the conversion of a non-CDB into a PDB fully unattended. AutoUpgrade works on all supported platforms, for non-CDB and CDBs, for all or only selected pluggable databases.
+
+### Migrating data using Oracle Data Pump
+
+- Data Pump provides export and import capabilities. Oracle Data Pump can perform a full or partial export from your database, followed by a full or partial import into the new release of Oracle Database. Data Pump allows to migrate directly into PDBs as well and works independently of the source database version across versions and operating system platforms. In addition, Data Pump in conjunction with transportable tablespaces takes away the complexity of rebuilding all the metadata objects with just one command as Full Transportable Export/Import.
+
+You may now *proceed to the next lab*.
+
+## Learn More
+
+* Documentation, [Database Upgrade Guide](https://docs.oracle.com/en/database/oracle/oracle-database/23/upgrd/intro-to-upgrading-oracle-database.html#GUID-FA024F34-A61A-4C4B-AA60-C123A9191A16)
+* Blog, [Upgrade your Database - NOW!](https://MikeDietrichDE.com)
+* My Oracle Support, [Oracle Databases Release and Support Coverage](https://support.oracle.com/epmos/faces/DocumentDisplay?id=742060.1&displayIndex=1)
+
+## Acknowledgements
+* **Author** - Daniel Overby Hansen
+* **Contributors** - Klaus Gronau, Rodrigo Jorge, Alex Zaballa, Mike Dietrich
+* **Last Updated By/Date** - Daniel Overby Hansen, June 2024
diff --git a/hitchhikers-guide-upgrade-to-23ai/00-prepare-setup/00-prepare-setup.md b/hitchhikers-guide-upgrade-to-23ai/00-prepare-setup/00-prepare-setup.md
@@ -0,0 +1,65 @@
+# 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).
+
+Estimated Time: 15 minutes
+
+### Objectives
+
+-   Download ORM stack
+-   Configure an existing Virtual Cloud Network (VCN)
+
+### Prerequisites
+
+This lab assumes you have:
+
+- An Oracle Cloud account
+
+## 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: [upgr19c-23ai.zip](https://c4u04.objectstorage.us-ashburn-1.oci.customer-oci.com/p/EcTjWk2IuZPZeNnD_fYMcgUhdNDIDA6rt9gaFj_WZMiL7VvxPBNMY60837hu5hga/n/c4u04/b/livelabsfiles/o/data-management-library-files/upgrade-and-patching/upgr19c-23ai.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 *Step 3* to follow our recommendations. If you would rather use an exiting VCN then proceed to the next step as indicated below 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 the following ports should be added to Egress rules
+
+| Port | Description             |
+| :--- | :---------------------- |
+| 22   | SSH                     |
+| 6080 | Remote Desktop 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 compute
+
+Using the details from the two steps above, proceed to the lab *Environment Setup* to setup your workshop environment using Oracle Resource Manager (ORM) and one of the following options:
+  -  Create Stack:  *Compute + Networking*
+  -  Create Stack:  *Compute only* with an existing VCN where security lists have been updated as per *Step 2* above
+
+You may now *proceed to the next lab*.
+
+## Acknowledgements
+
+* **Author** - Rene Fontcha, LiveLabs Platform Lead, NA Technology
+* **Contributors** - Meghana Banka, Rene Fontcha, Narayanan Ramakrishnan
+* **Last Updated By/Date** - Rene Fontcha, LiveLabs Platform Lead, NA Technology, January 2021
diff --git a/...ai/01-initialize-environment/images/initialize-environment-click-activities.png b/...ai/01-initialize-environment/images/initialize-environment-click-activities.png
diff --git a/...3ai/01-initialize-environment/images/initialize-environment-click-terminal.jpeg b/...3ai/01-initialize-environment/images/initialize-environment-click-terminal.jpeg
diff --git a/...ade-to-23ai/01-initialize-environment/images/initialize-environment-new-tab.png b/...ade-to-23ai/01-initialize-environment/images/initialize-environment-new-tab.png
diff --git a/...ikers-guide-upgrade-to-23ai/01-initialize-environment/initialize-environment.md b/...ikers-guide-upgrade-to-23ai/01-initialize-environment/initialize-environment.md
@@ -0,0 +1,87 @@
+# Initialize Environment
+
+## Introduction
+
+In this lab, you will review and startup all components required to successfully run this workshop.
+
+Estimated Time: 5 Minutes.
+
+### Objectives
+
+In this lab, you will:
+
+* Familiarize yourself with the workshop environment
+* Initialize the workshop environment
+
+## Task 1: Familiarize yourself with the workshop environment
+
+1. The easiest way to complete the lab is to copy/paste the lab instructions directly into a terminal. Be sure to execute all commands in a code block. After pasting you must hit *RETURN*.
+
+2. Before copy/pasting take notice of the commands that you execute. It is important to understand what the commands will do.
+
+3. You can use any terminal to run the lab. The lab sets the environment when appropriate.
+
+4. In the upper-left corner, click *Activities*. 
+
+![Click Activities to start a terminal](./images/initialize-environment-click-activities.png " ")
+
+5. Then click on the *terminal* icon.
+
+![Click the terminal icon to start a new terminal](./images/initialize-environment-click-terminal.jpeg)    
+
+6. If you need another terminal, either start a brand new one, or open a new tab in the existing terminal.    
+
+![Open a new tab in the existing terminal](images/initialize-environment-new-tab.png)
+
+## Task 2: Initialize the workshop environment
+
+1. Open a terminal or use an existing one. When you start the lab, the following components should be started.
+
+    - Database Listener
+        - LISTENER
+    - Database Server Instances
+        - FTEX
+        - UPGR
+        - CDB23
+
+3. Ensure the listener is started.
+
+    ```
+    <copy>
+    ps -ef | grep LISTENER | grep -v grep
+    </copy>
+    ```
+
+    <details>
+    <summary>*click to see the output*</summary>
+    ``` text
+    $ ps -ef | grep LISTENER | grep -v grep
+    oracle    2333     1  0 11:40 ?        00:00:00 /u01/app/oracle/product/19/bin/tnslsnr LISTENER -inherit
+    ```
+    </details>
+
+4. Ensure that the databases (*FTEX*, *UPGR* and *CDB23*) are started.
+
+    ```
+    <copy>
+    ps -ef | grep ora_ | grep pmon | grep -v grep
+    </copy>
+    ```
+
+    <details>
+    <summary>*click to see the output*</summary>
+    ``` text
+    $ ps -ef | grep ora_ | grep pmon | grep -v grep
+    oracle      3851       1  0 20:19 ?        00:00:00 ora_pmon_UPGR
+    oracle      5110       1  0 20:19 ?        00:00:00 ora_pmon_FTEX
+    oracle      5345       1  0 20:19 ?        00:00:00 ora_pmon_CDB23
+    ```
+    </details>
+
+You may now *proceed to the next lab*.
+
+## Acknowledgements
+
+* **Author** - Daniel Overby Hansen
+* **Contributors** - Klaus Gronau, Rodrigo Jorge, Alex Zaballa, Mike Dietrich
+* **Last Updated By/Date** - Daniel Overby Hansen, June 2024