Merge pull request #533 from oracle-devrel/github-major-review-modernise

Initial implementation of the Modernise GitHub review

Author: AlexanderHodicke

data-platform/modernise/README.md

@@ -1,54 +1,35 @@
 # Data Platform - Modernise
 
 The Data Platform - Modernise Specialists team in Oracle EMEA provides dedicated specialist support to Oracle customers around our entire Oracle Database Migration & Upgrade technology portfolio. The topics we cover include Oracle Data Pump, OCI Database Migration, Zero Downtime Migration, Transportable Tablespaces, Database Patching, Cloud Pre-Migration Advisor Tool (CPAT), Oracle GoldenGate for Migrations, and Database Upgrades.
+
 Check out the links below to detailed videos, technical demonstrations, blog articles, and technical workshops, as well as the rest of the repository for additional documentation including technical guides, and detailed best practices, aimed to support anyone who is at a Database Migration or Upgrade project, either On-Premises or to Oracle Cloud Infrastructure.
 
-# Useful Links
+Also make sure to check the dedicated pages of the main technology areas of Database Migration, Upgrade & Patching:
+
+* [Zero Downtime Migration](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/modernise/zero-downtime-migration)
+* [OCI Database Migration](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/modernise/oci-database-migration)
+* [Oracle Data Pump](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/modernise/data-pump)
+* [Database Patching](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/modernise/database-patching)
+
+# Team Publications
 
-- [Setup your Oracle Database Migration to OCI in the blink of an eye - Cloud Coaching Webinar](https://www.youtube.com/watch?v=jEJ30lona7g)
-    - Cloud Coaching Webinar, including a technical demonstration, delivered by Amalraj Puthenchira around the use of OCI Database Migration for simplified and effective Database Migrations into OCI
-- [Migrate your Oracle Database to OCI using ZDM (Zero-Downtime Migration) - Cloud Coaching Webinar](https://www.youtube.com/watch?v=SXb7KVZjpV8)
-    - Cloud Coaching Webinar, including a technical demonstration, delivered by Amalraj Puthenchira & Bilegt Bat Ochir, around the use of Zero Downtime Migration for automated and flexible Database Migrations into OCI
-- [How to survive an Oracle Database failure without your users ever noticing - Cloud Coaching Webinar]( https://www.youtube.com/watch?v=dsUbi5dO_PU)
-    - Cloud Coaching Webinar, including a technical demonstration, delivered by Amalraj Puthenchira around the use of Application Continuity to avoid unplanned application outages.
-- [Oracle Learning - Red Hot Webinar - OCI Database Migration on YouTube](https://www.youtube.com/watch?v=oLpah0TlmFE)
-    - Red Hot Webinar delivered by Marcus Doeringer capturing an in-depth description of OCI Database Migration - features, functionality, use-cases and technical demonstration
-- [Red Hot Universally Speaking - Zero Downtime Migration session on YouTube](https://www.youtube.com/watch?v=1jQ9GtAKDF0)
-    - Red Hot Webinar delivered by Amalraj Puthenchira and Carlos Álvarez capturing an in-depth description of Zero Downtime Migration - features, functionality, use-cases and technical demonstration
-- [Zero Downtime Migration : Physical Offline Migration to Co-Managed Databases in OCI](https://apexapps.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?wid=3568)
-    - Technical Hands-On workshop around Zero Downtime Migration Physical Offline Migration (RMAN) to Oracle Database in OCI
-- [Zero Downtime Migration: Physical Online Migration with Backup Location to Co-Managed Databases in OCI](https://apexapps.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?wid=3618)
-    - Technical Hands-On workshop around Zero Downtime Migration Physical Online Migration with Backup location (RMAN & DataGuard) to Oracle Database in OCI
-- [Zero Downtime Migration: Physical Online Migration with Direct Data Transfer to Co-Managed Databases in OCI](https://apexapps.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?wid=3669)
-    - Technical Hands-On workshop around Zero Downtime Migration Physical Online Migration with direct data transfer (RMAN & DataGuard) to Oracle Database in OCI
 - [ZDM/DMS Comparison](https://macsdata.netlify.app/oradb/migration/zdm-dms-comparison/)
     - Technical Comparison of Zero Downtime Migration and OCI Database Migration service, available on Marcus Doeringer's public platform
-- [ZDM: Installation Guide](https://macsdata.netlify.app/oradb/migration/zdm/installation/)
-    - Detailed, step-by-step installation guide for Zero Downtime Migration, available on Marcus Doeringer's public platform
-- [ZDM: Patching Guide](https://macsdata.netlify.app/oradb/migration/zdm/patching/)
-    - Detailed, step-by-step patching guide for Zero Downtime Migration, available on Marcus Doeringer's public platform
-- [ZDM: Wallet Setup Guide](https://macsdata.netlify.app/oradb/migration/zdm/wallet/)
-    - Detailed, step-by-step wallet setup guide for Zero Downtime Migration, available on Marcus Doeringer's public platform
-- [Data Pump: Export Best Practices](https://macsdata.netlify.app/oradb/migration/datapump/expdp/bestpractices/)
-    - Detailed best practices guide around Oracle Data Pump export (expdp), available on Marcus Doeringer's public platform
-- [Data Pump: Import Best Practices](https://macsdata.netlify.app/oradb/migration/datapump/impdp/bestpractices/)
-    - Detailed best practices guide around Oracle Data Pump import (impdp), available on Marcus Doeringer's public platform
-- [GoldenGate: Marketplace Image Installation Guide](https://macsdata.netlify.app/oradb/migration/goldengate/marketplace/install/)
-    - Detailed, step-by-step GoldenGate Marketplace Image installation guide for database migrations, available on Marcus Doeringer's public platform
-- [GoldenGate: Marketplace Image Docker Setup Guide](https://macsdata.netlify.app/oradb/migration/goldengate/marketplace/docker/)
-    - Detailed, step-by-step GoldenGate Marketplace Image Docker setup guide for database migrations, available on Marcus Doeringer's public platform
-- [OCI Migration Hub](https://www.oracle.com/cloud/oci-migration-hub/#rc30p2)
-    - Go-to portal for Migrations to OCI
-- [How to Automate DB System Patching of Oracle Base Database in OCI](https://youtu.be/o_0KdVY631Y)
-    - Step by step Video demo on automating the DB System Patching of Oracle Base Database in OCI
-- [How to Automate Database Patching of Oracle Base Database in OCI](https://youtu.be/lzGQ0IgVbBE)
-    - Step by step Video Demo on automating the Database Patching of Oracle Base Database in OCI
 - [CLONE PDB options as a Migration Method for Windows Databases to Oracle Cloud Infrastructure](https://carlosal.wordpress.com/2023/07/14/clone-pdb-options-as-a-migration-method-for-windows-databases-to-oracle-cloud-infrastructure/)
     - Blog technical article about migrating Windows Oracle Databases to OCI using Oracle REMOTE CLONE PDB and REFRESHABLE PDB functionalities, available on Carlos Álvarez's public platform
-- [Ace your Database Migration to Oracle Exadata Database Service on Dedicated Infrastructure](https://www.youtube.com/watch?v=luBezgN7sa0)
-     - Cloud Customer Connect session delivered by Amalraj Puthenchira explaining how to use the Oracle Zero Downtime Migration(ZDM) tool to migrate Oracle Database on Linux to Exadata Database Service on Dedicated Infrastructure.
+- [How to survive an Oracle Database failure without your users ever noticing - Cloud Coaching Webinar]( https://www.youtube.com/watch?v=dsUbi5dO_PU)
+    - Cloud Coaching Webinar, including a technical demonstration, delivered by Amalraj Puthenchira around the use of Application Continuity to avoid unplanned application outages.
+- [Teradata to Autonomous Data Warehouse on OCI Migration Guide](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/modernise/teradata-to-autonomous-data-warehouse-migration-guide)
 
-     
+# Useful Links
+
+- [OCI Migration Hub - Migrate Oracle Databases to OCI](https://www.oracle.com/database/cloud-migration/)
+- [Database Upgrades and Migrations on oracle.com](https://www.oracle.com/database/upgrades/)
+- [AutoUpgrade tool for Oracle Database](https://www.oracle.com/database/upgrades/#rc30p1)
+- [Cloud Migration Advisor](https://www.oracle.com/database/upgrades/#rc30p2)
+- [More Database Migration Resources](https://www.oracle.com/database/upgrades/#rc30p3)
+- [Load Data into Oracle Database](https://www.oracle.com/database/upgrades/#rc30p4)
+
 # License
 
 Copyright (c) 2023 Oracle and/or its affiliates.

data-platform/modernise/data-pump/README.md

@@ -0,0 +1,36 @@
+# Oracle Data Pump
+ 
+Oracle Data Pump technology enables very high-speed movement of data and metadata from one database to another. Oracle Data Pump is available only on Oracle Database 10g release 1 (10.1) and later. Data Pump consists of two command-line clients and two PL/SQL packages. The command-line clients, expdp and impdp, provide an easy-to-use interface to the Data Pump export and import utilities. You can use expdp and impdp to export and import entire schemas or databases.
+
+The Data Pump export utility writes the schema objects, including the tables and metadata that constitute mining models, to a dump file set. The Data Pump import utility retrieves the schema objects, including the model tables and metadata, from the dump file set and restores them in the target database.
+
+A set of best practices and other useful assets/links can be found in this page.
+ 
+# Table of Contents
+ 
+1. [Team Publications](#team-publications)
+2. [Useful Links](#useful-links)
+ 
+# Team Publications
+ 
+- [Data Pump: Export Best Practices](https://macsdata.netlify.app/oradb/migration/datapump/expdp/bestpractices/)
+    - Detailed best practices guide around Oracle Data Pump export (expdp), available on Marcus Doeringer's public platform
+- [Data Pump: Import Best Practices](https://macsdata.netlify.app/oradb/migration/datapump/impdp/bestpractices/)
+    - Detailed best practices guide around Oracle Data Pump import (impdp), available on Marcus Doeringer's public platform
+- [Upload Large Data Pump Files to OCI - using OCI CLI Multipart Uploads](https://www.youtube.com/watch?v=9100uKXquic)
+    - YouTube Video by Austine Ouma explaining how to use multipart uploads for large data pump files that need to be uploaded to Oracle Cloud Infrastructure
+ 
+# Useful Links
+- [Data Pump in Database 21c LiveLabs Workshop](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=742&clear=RR,180&session=1384894897131)
+- [Data Pump Best Practices Whitepaper](https://www.oracle.com/a/ocom/docs/oracle-data-pump-best-practices.pdf)
+- [Data Pump Basics - YouTube Video](https://www.youtube.com/watch?v=5uLDxPDErsw)
+- [Data Pump Best Practices & Real World Scenarios - YouTube Video](https://www.youtube.com/watch?v=960ToLE-ZE8)
+- [Data Pump & SQL Developer Web for Oracle Autonomous Database](https://www.thatjeffsmith.com/archive/2023/02/data-pump-sql-developer-web-for-oracle-autonomous-database/)
+
+# License
+ 
+Copyright (c) 2023 Oracle and/or its affiliates.
+ 
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+ 
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

data-platform/modernise/database-patching/README.md

@@ -0,0 +1,22 @@
+# Database Patching
+ 
+Oracle regularly makes patches available to upgrade features, enhance security or fix problems with the Oracle database software version which is under Support. Oracle Database Patching is the process of updating the binaries and database with newly released patches.
+
+In Oracle Cloud Infrastructure the customer owns and manages patching of OS and Database components for Co-Managed Database Services (Oracle Base Database and Exadata Database Service - Dedicated) with the help of powerful automation available. OCI follows Release Update(RU) Patching Strategy (from 12.2 version) for Grid Infrastructure and Database Home of Co-Managed Database Services. For Autonomous Databases, Oracle owns and Manages Patching.
+
+Best practices & other useful resources around how to patch Oracle Databases on premises or on Oracle Cloud Infrastructure can be found on this page.
+ 
+# Team Publications
+ 
+- [How to Automate DB System Patching of Oracle Base Database in OCI](https://youtu.be/o_0KdVY631Y)
+    - Step by step Video demo on automating the DB System Patching of Oracle Base Database in OCI
+- [How to Automate Database Patching of Oracle Base Database in OCI](https://youtu.be/lzGQ0IgVbBE)
+    - Step by step Video Demo on automating the Database Patching of Oracle Base Database in OCI
+
+# License
+ 
+Copyright (c) 2023 Oracle and/or its affiliates.
+ 
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+ 
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

data-platform/modernise/oci-database-migration/README.md

@@ -13,12 +13,6 @@ Oracle Cloud Infrastructure Database Migration (DMS) is a fully managed cloud se
     - Red Hot Webinar delivered by Marcus Doeringer capturing an in-depth description of OCI Database Migration - features, functionality, use-cases and technical demonstration
 - [Setup your Oracle Database Migration to OCI in the blink of an eye - Cloud Coaching Webinar](https://www.youtube.com/watch?v=jEJ30lona7g)
     - Cloud Coaching Webinar, including a technical demonstration, delivered by Amalraj Puthenchira around the use of OCI Database Migration for simplified and effective Database Migrations into OCI
-- [ZDM/DMS Comparison](https://macsdata.netlify.app/oradb/migration/zdm-dms-comparison/)
-    - Technical Comparison of Zero Downtime Migration and OCI Database Migration service, available on Marcus Doeringer's public platform
-- [GoldenGate: Marketplace Image Installation Guide](https://macsdata.netlify.app/oradb/migration/goldengate/marketplace/install/)
-    - Detailed, step-by-step GoldenGate Marketplace Image installation guide for database migrations, available on Marcus Doeringer's public platform
-- [GoldenGate: Marketplace Image Docker Setup Guide](https://macsdata.netlify.app/oradb/migration/goldengate/marketplace/docker/)
-    - Detailed, step-by-step GoldenGate Marketplace Image Docker setup guide for database migrations, available on Marcus Doeringer's public platform
 
 ## Useful Links
 
@@ -39,4 +33,4 @@ Copyright (c) 2023 Oracle and/or its affiliates.
 
 Licensed under the Universal Permissive License (UPL), Version 1.0.
 
-See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/folder-structure/LICENSE) for more details.
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

data-platform/modernise/teradata-to-autonomous-data-warehouse-migration-guide/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2023 Oracle and/or its affiliates.
+ 
+The Universal Permissive License (UPL), Version 1.0
+ 
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+ 
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+ 
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+ 
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data-platform/modernise/migrating-Teradata-to-Autonomous-Data-Warehouse/README.md renamed to data-platform/modernise/teradata-to-autonomous-data-warehouse-migration-guide/README.md

@@ -1,26 +1,31 @@
-# Migrating Teradata to Autonomous Data Warehouse on OCI
- 
-Why move Teradata to Autonomous Data Warehouse on OCI
+# Teradata to Autonomous Data Warehouse on OCI Migration Guide
+
+## Why move Teradata to Autonomous Data Warehouse on OCI?
 
 Legacy Data Warehouses, like Teradata, present a lot of inconveniences nowadays. The monolithic architecture implies high costs both in terms of hosting and management. Also, legacy Data Warehouses are difficult to scale (up/down, out/in) and require very skilled personnel to operate. The capex model associated costs and the costs associated to this expert personnel, among others, are making the companies to move the legacy database systems to the cloud rapidly. 
 
 On the other hand, the Scalability and Elasticity, inherent in OCI, allows companies to scale the databases up or down based on the business needs and changing workloads.
 
 Oracle Autonomous Data Warehouse (ADW) offers a flexible, scalable, highest performing, highly available, and secure data warehouse solution that fulfills all these operational and costs challenges. Easy management and automation and built-in disaster recovery tools are other advantages that ADW provides.
 
-Potential challenges & migration tool
+## Potential challenges & migration tool
+
 The process of migrating from Teradata to OCI Autonomous Databases (like Autonomous Data Warehouses - ADW) presents a number of challenges that users will have to deal with, like differences in the implementation of structures, objects and data types, data extraction methods, data transformation requirements between the two platforms, data consistency and integrity, the final data loading, and more...
 
 SQL Developer can assist this process by using its built-in functionalities and tools. Using SQL Developer in a migration can help to reduce the efforts, accelerate the whole process and reduce human errors.
 
+# When to use this asset?
 
-A comprehensive guide to migrate a Teradata database to Autonomous Data Warehouse on OCI using SQL Developer is available here. 
+Once a decision has been taken to migrate a Teradata database to Autonomous Data Warehouse on OCI, this step-by-step guide can help Data Engineers, Developers and Oracle Database Administrators with the data migration process.
+
+# How to use this asset?
+
+A comprehensive guide to migrate a Teradata database to Autonomous Data Warehouse on OCI using SQL Developer is available in this GitHub folder, named "Teradata to ADW Migration with SQL Developer_v1.1.pdf". Follow the steps to prepare for your Teradata to Autonomous Data Warehouse migration.
 
 # License
 
 Copyright (c) 2023 Oracle and/or its affiliates.
 
 Licensed under the Universal Permissive License (UPL), Version 1.0.
 
-See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/folder-structure/LICENSE) for more details.
- 
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.