oracle-livelabs
diff --git a/‎datapump-xtts-migration/00-introduction/images/introduction-overview.png
28.7 KB b/‎datapump-xtts-migration/00-introduction/images/introduction-overview.png
28.7 KB
diff --git a/‎datapump-xtts-migration/00-introduction/images/m5-overview.png
10.6 KB b/‎datapump-xtts-migration/00-introduction/images/m5-overview.png
10.6 KB
diff --git a/‎datapump-xtts-migration/00-introduction/introduction.md
Lines changed: 79 additions & 0 deletions b/‎datapump-xtts-migration/00-introduction/introduction.md
Lines changed: 79 additions & 0 deletions
diff --git a/‎datapump-xtts-migration/00-prepare-setup/00-prepare-setup.md
Lines changed: 64 additions & 0 deletions b/‎datapump-xtts-migration/00-prepare-setup/00-prepare-setup.md
Lines changed: 64 additions & 0 deletions
diff --git a/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-click-activities.png
52.2 KB b/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-click-activities.png
52.2 KB
diff --git a/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-click-terminal.jpeg
57.7 KB b/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-click-terminal.jpeg
57.7 KB
diff --git a/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-new-tab.png
48.9 KB b/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-new-tab.png
48.9 KB
diff --git a/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-zoom-in.png
18.7 KB b/‎datapump-xtts-migration/01-initialize-environment/images/initialize-environment-zoom-in.png
18.7 KB
diff --git a/‎datapump-xtts-migration/01-initialize-environment/initialize-environment.md
Lines changed: 94 additions & 0 deletions b/‎datapump-xtts-migration/01-initialize-environment/initialize-environment.md
Lines changed: 94 additions & 0 deletions
@@ -0,0 +1,79 @@
+# Introduction
+
+## About this Workshop
+
+In this lab, you will migrate a non-CDB database on Oracle Database 19c  directly into a PDB on Oracle Database 23ai using a combination of transportable tablespaces, full transportable export/import, and RMAN backups. For this purpose, Oracle delivers the M5 script, which automates the steps and makes such migrations easier. You will use the M5 script for the migration.
+
+Typically, the procedure is used for cross-platform migrations from big-endian platforms, like AIX and SPARC/Solaris, to little-endian platforms, like the Exadata Database Machine. It requires that the source and target databases are on Oracle Database 19c (Release Update 18) or later and uses the [Data Pump Bundle Patch](https://support.oracle.com/epmos/faces/DocumentDisplay?id=2819284.1).
+
+For simplicity, this lab teaches you to migrate a database from Linux to Linux, but the script and procedures are identical to those of a cross-platform migration.
+
+Estimated Workshop Time: 1 hour 45 minutes
+
+### Objectives
+
+In this workshop, you will:
+
+* Migrate a non-CDB database directly into a PDB
+* Migrate from Oracle Database 19c to Oracle Database 23ai
+* Use the M5 script
+* Use RMAN incremental backups to minimize downtime
+* Use full transportable export/import
+
+## About the workshop contents
+
+This workshop comes with pre-installed Oracle homes and pre-created databases.
+You can switch between environments using the shortcuts shown in the last column of the diagram below.
+
+![Overview of the Oracle Homes and databases in the lab](./images/introduction-overview.png " ")
+
+This lab uses only the *FTEX* and *CDB23* databases. You will create a new PDB, *VIOLET*, in *CDB23*. 
+
+The diagram shows the different phases of the migration.
+
+![Overview of the phases in an M5 migration](./images/m5-overview.png " ")
+* *Configure* - You download and configure the M5 script and create a new empty target database.
+* *Level 0* - You start the initial level 0 backup and restore the data files in the target database.
+* *Level 1* - You do incremental backup and restore. You repeat this process as many times as needed.
+* *Outage* - The maintenance window begins.
+* *Final backup* - You set tablespaces read-only and perform the final incremental backup. In addition, you perform a Data Pump full transportable export.
+* *Final restore* - You restore the final incremental backup.
+* *Import* - You start a full transportable import.
+
+## Migration methods and processes
+
+### TTS
+
+Transportable tablespaces transports data that resides in user-defined tablespaces. Use the transportable tablespaces feature to move a set of tablespaces between databases.
+
+### FTEX
+
+Full transportable export/import combines the ease of use familiar to users of original Export/Import and Data Pump export/import, with the speed of migration possible with transportable tablespaces.
+
+### RMAN 
+
+You can use RMAN to transport tablespaces across platforms with different endian formats. An incremental backup copies only those data blocks that have changed since a previous backup. You use incremental backups to minimize downtime while data files are copied to the new database.
+
+### M5
+
+M5 is an Oracle script that combines different existing methods to migrate a database. The result is a simple, reliable, and fast migration solution with minimal downtime.
+
+M5 procedure supports:
+* Encrypted tablespaces
+* Use of multisection backups (for bigfile tablespaces)
+* Compressed backup sets (requires appropriate license)
+* Better parallelism than previous methods
+
+You may now *proceed to the next lab*.
+
+## Learn More
+
+* [Webinar, Cross Platform Migration – Transportable Tablespaces to the Extreme](https://dohdatabase.com/webinars/)
+* [M5 Cross Endian Platform Migration using Full Transportable Data Pump Export/Import and RMAN Incremental Backups (Doc ID 2999157.1)](https://support.oracle.com/epmos/faces/DocumentDisplay?id=2999157.1)
+* [Blog post series](https://dohdatabase.com/xtts/)
+* [YouTube channel](https://www.youtube.com/@upgradenow/)
+
+## Acknowledgments
+* **Author** - Daniel Overby Hansen
+* **Contributors** - Rodrigo Jorge, Mike Dietrich, Klaus Gronau, Alex Zaballa
+* **Last Updated By/Date** - Daniel Overby Hansen, July 2024
@@ -0,0 +1,64 @@
+# Prepare Setup Daniel Was Here
+
+## 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: [xtts.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/xtts.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*.
+
+## Acknowledgments
+* **Author** - Daniel Overby Hansen
+* **Contributors** - Klaus Gronau, Rodrigo Jorge, Mike Dietrich
+* **Last Updated By/Date** - Daniel Overby Hansen, July 2024
@@ -0,0 +1,94 @@
+# Initialize Environment
+
+## Introduction
+
+In this lab, you will review and start-up all components required to run this workshop successfully.
+
+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. When the terminal opens, it says *Database ENV is not set*. You can disregard that message. All labs start by setting the appropriate environment.
+
+7. In the terminal, you can zoom in to make the text larger. Press *CTRL* and *+* or select *Zoom In*.
+
+![Zoom in to make the text larger in the terminal](./images/initialize-environment-zoom-in.png)    
+
+8. 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
+        - CDB23
+
+2. 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     11158       1  0 04:57 ?        00:00:00 /u01/app/oracle/product/23/bin/tnslsnr LISTENER -inherit
+    ```
+    </details>
+
+3. Ensure that the databases (*FTEX* and *CDB23*) are started.
+
+    ```
+    <copy>
+    ps -ef | grep ora_ | grep pmon | grep -v grep
+    </copy>
+    ```
+
+    * You might see other databases started as well. It doesn't matter.
+
+    <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*.
+
+## Acknowledgments
+
+* **Author** - Daniel Overby Hansen
+* **Contributors** - Rodrigo Jorge, Mike Dietrich, Klaus Gronau, Alex Zaballa
+* **Last Updated By/Date** - Daniel Overby Hansen, July 2024