2 Migrate Using DMS
Migrate data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database using Database Migration (DMS) service.
The topics covered in this section describe the preparation steps, the migration tasks, and the postmigration tasks.
- Prepare to Migrate
Before you begin with the migration of data an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, you must understand the high-level migration workflow, and meet the prerequisites and perform the premigration tasks that are described in this section. - Migrate Your Data
Register source (both PDB and CDB separately) and target databases to use with Oracle Cloud Infrastructure Database Migration by creating registered database resources. Registered database resources enable networking and connectivity for the source and target databases. - Restoring the Schema Version Registry
To migrate schema version registry from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, you must restore the schema version registry on your shared autonomous database. - Complete the Postmigration Tasks
After migrating data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, perform the tasks described in this section. Some of these tasks apply to specific schemas.
Prepare to Migrate
Before you begin with the migration of data an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, you must understand the high-level migration workflow, and meet the prerequisites and perform the premigration tasks that are described in this section.
- Roadmap for Migrating Data to an Oracle Autonomous Transaction Processing-Shared (ATP-S) Database
This roadmap provides the migration workflow for migrating data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database. - Prerequisites
The prerequisites to migrate data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database is described in the following sections. - Premigration Tasks
Perform the following premigration tasks before you migrate data from an on-premises database to Oracle Autonomous Transaction Processing-Shared (ATP-S) database
Parent topic: Migrate Using DMS
Roadmap for Migrating Data to an Oracle Autonomous Transaction Processing-Shared (ATP-S) Database
This roadmap provides the migration workflow for migrating data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database.
Table 2-1 provides the high-level steps required for migrating data to an ATP-S database, for all Oracle Fusion Middleware products that are certified with ATP-S database.
Table 2-1 Migration Roadmap
Product Name | Migration Workflow |
---|---|
All Oracle Fusion Middleware products except Oracle Identity and Access Management Suite of products Note: Before creating a backup of the schema version registry, perform the premigration tasks for Oracle Forms and Oracle GoldenGate Veridata. See Premigration Task for Oracle Forms and Premigration Task for Oracle GoldenGate Veridata. |
|
Parent topic: Prepare to Migrate
Prerequisites
The prerequisites to migrate data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database is described in the following sections.
Note:
Before you perform the prerequisite tasks, apply the latest bundle patches for the products, and the prerequisite patches needed for the bundle patches, if any.- Database Requirements
- Creating Resources
- Setting Oracle GoldenGate for Online Migrations
- Preparing the Database for Migration
Parent topic: Prepare to Migrate
Database Requirements
Your source and target database environment must meet these requirements to use Oracle Cloud Infrastructure Database Migration.
Table 2-2 Database requirements
Components | Supported versions |
---|---|
Source Database |
Oracle Database 19c |
Supported Target Database Versions |
Oracle Autonomous Database with Shared Exadata Infrastructure |
Source Platforms |
Linux-x86-64 |
Parent topic: Prerequisites
Creating Resources
To create the resources that Oracle Cloud Infrastructure Database Migration operations depends on, see Creating Resources in Using Oracle Cloud Infrastructure Database Migration Service.
Parent topic: Prerequisites
Setting Oracle GoldenGate for Online Migrations
Online migrations with Oracle Cloud Infrastructure Database Migration have a few additional prerequisite tasks because you must install Oracle GoldenGate Microservices, create GoldenGate users on the source database, and unlock the GoldenGate user on the target database.
- Installing Oracle GoldenGate Microservices
- Creating GoldenGate Users on the Source Database
You must create Goldengate users on the source database as aSYS
user withSYSDBA
privileges. - Creating or Unlocking the GoldenGate User on the Target Database
Parent topic: Prerequisites
Installing Oracle GoldenGate Microservices
- Deploy the "Oracle GoldenGate for Oracle - Database Migrations" image from
Oracle Cloud Marketplace as follows.
- Modify the wallet containing certificates for TLS authentication:
- Verify that the GoldenGate hub subnet allows ingress for port 443. See the security ingress rules in the example in Oracle Autonomous Database on Dedicated Exadata Infrastructure.
Parent topic: Setting Oracle GoldenGate for Online Migrations
Creating GoldenGate Users on the Source Database
You must create Goldengate users on the source database as a
SYS
user with SYSDBA
privileges.
Parent topic: Setting Oracle GoldenGate for Online Migrations
Creating or Unlocking the GoldenGate User on the Target Database
Run these commands on the GoldenGate marketplace target instance to
unlock the ggadmin
user on the target database.
Parent topic: Setting Oracle GoldenGate for Online Migrations
Preparing the Database for Migration
- Giving Permissions to Database Migration Users
Add the users in charge of database migrations to the specified group and provide required permissions. - Configuring SUDO Access
You may need to grant certain users authority to perform operations usingsudo
on the source database servers. - Preparing the Source Database for Migration
Ensure to configure your source database before you start migrating data. - Preparing the Target Database for Migration
Ensure to configure your target database before you start migrating data. - Accessing the Database Migration Service
You can access Oracle Cloud Infrastructure Database Migration using the Oracle Cloud Interface Console (a browser based interface), REST APIs, or Oracle Cloud Infrastructure Software Development Kits and Command Line Interface. - Registering Databases
You must register source and target databases to use with Oracle Cloud Infrastructure Database Migration by creating registered database resources.
Parent topic: Prerequisites
Giving Permissions to Database Migration Users
Add the users in charge of database migrations to the specified group and provide required permissions.
Allow group dmsGroup to manage odms-connection in compartment dmsCompartment
Allow group dmsGroup to manage odms-migration in compartment dmsCompartment
Allow group dmsGroup to manage odms-agent in compartment dmsCompartment
Allow group dmsGroup to manage odms-job in compartment dmsCompartment
Allow group dmsGroup to manage users in tenancy where all {target.user.id=‘ocid1.user.oc1..aaaaaaaaqutjpgdabhqd4p4jfoyrbu6n6ihjoqisucfqdljikengtlnlvnyq’, request.operation=/*AuthToken*/}
Allow group dmsGroup to inspect users in tenancy where all {target.user.id=‘ocid1.user.oc1..aaaaaaaaqutjpgdabhqd4p4jfoyrbu6n6ihjoqisucfqdljikengtlnlvnyq’}
Allow group dmsGroup to manage tag-namespaces in compartment dmsCompartment
Allow group dmsGroup to manage virtual-network-family in compartment Networks
Allow group dmsGroup to manage buckets in compartment dmsCompartment
Allow group dmsGroup to manage objects in compartment dmsCompartment
Allow group dmsGroup to manage autonomous-database-family in compartment dmsCompartment
Allow group dmsGroup to manage database-family in compartment dmsCompartment
Allow group dmsGroup to manage instance-family in compartment dmsCompartment
Allow group dmsGroup to manage volume-family in compartment dmsCompartment
Allow group dmsGroup to manage goldengate-family in compartment dmsCompartment
Allow service goldengate to manage vaults in tenancy
Allow service goldengate to manage keys in tenancy
Allow service goldengate to manage secret-family in tenancy
Allow service goldengate to manage objects in compartment dmsCompartment
Allow group dmsGroup to manage all-resources in compartment dmsCompartment
Allow group dmsGroup to inspect teanancies in tenancy
Parent topic: Preparing the Database for Migration
Configuring SUDO Access
You may need to grant certain users authority to perform operations
using sudo
on the source database servers.
sudo
access for source database
servers, see Configuring Sudo
Access in Using Oracle Cloud Infrastructure Database
Migration Service.
Parent topic: Preparing the Database for Migration
Preparing the Source Database for Migration
Ensure to configure your source database before you start migrating data.
Parent topic: Preparing the Database for Migration
Preparing the Target Database for Migration
Ensure to configure your target database before you start migrating data.
You must use only one of the database service
names,databasename_tpurgent
ordatabasename_tp
, specified in
tnsnames.ora
. For database service name details, see MDW Database Service Names for Autonomous Database in
Using Oracle Autonomous Database on Shared Exadata
Infrastructure.
Parent topic: Preparing the Database for Migration
Accessing the Database Migration Service
You can access Oracle Cloud Infrastructure Database Migration using the Oracle Cloud Interface Console (a browser based interface), REST APIs, or Oracle Cloud Infrastructure Software Development Kits and Command Line Interface.
For complete information, see Using Oracle Cloud Infrastructure Database Migration Service.
Parent topic: Preparing the Database for Migration
Registering Databases
You must register source and target databases to use with Oracle Cloud Infrastructure Database Migration by creating registered database resources.
Parent topic: Preparing the Database for Migration
Premigration Tasks
Perform the following premigration tasks before you migrate data from an on-premises database to Oracle Autonomous Transaction Processing-Shared (ATP-S) database
- Premigration Task for Oracle Forms
Perform the following premigration task before you migrate data to Oracle Autonomous Transaction Processing-Shared (ATP-S) database for Oracle Forms. - Premigration Task for Oracle GoldenGate Veridata
Perform the following premigration task before you migrate data to Oracle Autonomous Transaction Processing-Shared (ATP-S) databasefor Oracle GoldenGate Veridata. - Creating a Backup of the Schema Version Registry
Use the Upgrade Assistant on the on-premises host to create a backup of the existing schema version registry on the on-premises database. - Creating Migration
A migration contains the parameter settings for running a migration job with Oracle Cloud Infrastructure database migration. - Validating a Migration
Before you can run a job with a migration resource in Oracle Cloud Infrastructure Database Migration, the migration resource must be validated. - Excluding Unsupported Objects
You must specify objects to include or exclude from a migration job while you are creating a migration resource.
Parent topic: Prepare to Migrate
Premigration Task for Oracle Forms
Perform the following premigration task before you migrate data to Oracle Autonomous Transaction Processing-Shared (ATP-S) database for Oracle Forms.
If user has created their own user defined schemas, run the commands listed below on the source database as a SYS user:
ALTER USER abc identified by <Schema_Password> account unlock;
GRANT read,write on DIRECTORY test_dir to abc;
commit;
# Export the schemas using expdp
expdp system/<SYS_PASSWORD>@<DB_SID> schemas=abc directory=test_dir dumpfile=abc_meta.dmp logfile=abc1.log
If you exported your users from an on-premises database, run the commands listed below on the target database:
CREATE TABLESPACE "USERS";
Create user abc identified by <Schema_Password> DEFAULT TABLESPACE USERS TEMPORARY TABLESPACE TEMP;
GRANT UNLIMITED TABLESPACE to abc;
GRANT CONNECT, create view, create table, create procedure, create trigger, create synonym, create sequence, create type to abc;
commit;
#connect as abc user
connect abc/<password>@fmwatpdedic2_tp;
CREATE TABLE DEPT("DEPTNO" NUMBER(2,0),"DNAME" CHAR(14 BYTE),"LOC" CHAR(13 BYTE));
CREATE TABLE EMP("EMPNO" NUMBER(4,0),"ENAME" CHAR(10 BYTE), "JOB" CHAR(9 BYTE), "MGR" NUMBER(4,0),"HIREDATE" DATE,"SAL" NUMBER(7,2),"COMM" NUMBER(7,2), "DEPTNO" NUMBER(2,0));
commit;
# Drop the current table in the database and recreate the new table as in the dump file using impdp
impdp admin/<admin_password>@fmwatpdedic2_tp credential=DEF_CRED_NAME /
dumpfile=https://objectstorage.us-ashburn-1.oraclecloud.com/n/atpdpreview2/b/FormsInstallDBMigration/o/abc_meta.dmp /
TABLE_EXISTS_ACTION=REPLACE
Parent topic: Premigration Tasks
Premigration Task for Oracle GoldenGate Veridata
Perform the following premigration task before you migrate data to Oracle Autonomous Transaction Processing-Shared (ATP-S) databasefor Oracle GoldenGate Veridata.
For Oracle GoldenGate Veridata, create the following roles as a SYS user on the source database:
CREATE ROLE VERIDATA_ROLE;
GRANT CREATE SESSION, CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATE SYNONYM TO VERIDATA_ROLE;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_STB;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_IAU;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_IAU_APPEND;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_IAU_VIEWER;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_OPSS;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_VERIDATA;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_WLS;
GRANT VERIDATA_ROLE TO <PREFIX_GIVEN>_WLS_RUNTIME;
Parent topic: Premigration Tasks
Creating a Backup of the Schema Version Registry
Use the Upgrade Assistant on the on-premises host to create a backup of the existing schema version registry on the on-premises database.
To create a backup of the schema version registry:
Parent topic: Premigration Tasks
Creating Migration
A migration contains the parameter settings for running a migration job with Oracle Cloud Infrastructure database migration.
Parent topic: Premigration Tasks
Validating a Migration
Before you can run a job with a migration resource in Oracle Cloud Infrastructure Database Migration, the migration resource must be validated.
Parent topic: Premigration Tasks
Excluding Unsupported Objects
You must specify objects to include or exclude from a migration job while you are creating a migration resource.
Few data types are not supported by GoldenGate for replication purpose. These unsupported objects fail during validation phase. Few objects related to Oracle Text Search (OTS) are not supported on the Oracle Autonomous Transaction Processing-Shared (ATP-S) database. So, these unsupported objects must be excluded from online migration and later exported and imported manually using data pump. For more information, see Details of Support for Oracle Data Types and Objects in Using Oracle GoldenGate for Oracle Database.
Select ALL_OBJECTS view to display the correct OWNER and OBJECT_NAME values for any objects you want to exclude. For complete information, see Selecting Objects for Oracle Migration in Using Oracle Cloud Infrastructure Database Migration Service.
To exclude Oracle GoldenGate unsupported objects, see Table B-1, and to exclude the objects due to CPAT tool errors, see Objects To Be Excluded from the Migration Job due to CPAT Tool Errors.
Note:
After the migration is completed, for OTS, the excluded objects are regenerated dynamically.Parent topic: Premigration Tasks
Migrate Your Data
Register source (both PDB and CDB separately) and target databases to use with Oracle Cloud Infrastructure Database Migration by creating registered database resources. Registered database resources enable networking and connectivity for the source and target databases.
- Performing Migration
Perform the following steps to migrate data from an on-premises database, for all Oracle Fusion Middleware products except Oracle Identity and Access Management Suite of products.
Parent topic: Migrate Using DMS
Performing Migration
Perform the following steps to migrate data from an on-premises database, for all Oracle Fusion Middleware products except Oracle Identity and Access Management Suite of products.
Parent topic: Migrate Your Data
Restoring the Schema Version Registry
To migrate schema version registry from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, you must restore the schema version registry on your shared autonomous database.
Note:
The following topic is applicable when you migrate data from an on-premises database to ATP-S database using Database Migration (DMS) service.Parent topic: Migrate Using DMS
Complete the Postmigration Tasks
After migrating data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, perform the tasks described in this section. Some of these tasks apply to specific schemas.
Note:
The following topics are applicable when you migrate data from an on-premises database to ATP-S database using Database Migration (DMS) service.- Postmigration Tasks for Oracle Data Integrator
Perform the postmigration steps described in this section after migrating data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database for Oracle Data Integrator (ODI). - Rewiring the Domain with the ATP-S Target Database
You must rewire the datasources in the Oracle Fusion Middleware domain with the newly created ATP-S target database. - Updating the Configuration Files
Follow the steps in this section to update theconfig.xml
configuration file, and the Oracle Platform Security Services ( OPSS) configuration files,jps-config.xml
andjps-config-jse.xml
files in the Oracle Cloud Infrastructure Database Migration domain host. - Restarting the Servers
After the migration of your data from on-premises to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, restart all processes and servers, including the Administration Servers and any Managed Servers. - Performing Sanity Check
After the migration of data from your on-premises to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, verify the application URLs, and ensure that data is accessible from the application.
Parent topic: Migrate Using DMS
Postmigration Tasks for Oracle Data Integrator
Perform the postmigration steps described in this section after migrating data from an on-premises database to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database for Oracle Data Integrator (ODI).
Parent topic: Complete the Postmigration Tasks
Rewiring the Domain with the ATP-S Target Database
You must rewire the datasources in the Oracle Fusion Middleware domain with the newly created ATP-S target database.
Parent topic: Complete the Postmigration Tasks
Updating the Configuration Files
Follow the steps in this section to update the
config.xml
configuration file, and the Oracle Platform Security Services ( OPSS) configuration
files, jps-config.xml
and jps-config-jse.xml
files in the Oracle Cloud Infrastructure Database Migration
domain host.
- To update the
config.xml
file: - To update the
jps-config.xml
andjps-config-jse.xml
files: - Save the changes.
Parent topic: Complete the Postmigration Tasks
Restarting the Servers
After the migration of your data from on-premises to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, restart all processes and servers, including the Administration Servers and any Managed Servers.
See Starting and Stopping Administration and Managed Servers and Node Manager in Administering Oracle Fusion Middleware.
Parent topic: Complete the Postmigration Tasks
Performing Sanity Check
After the migration of data from your on-premises to an Oracle Autonomous Transaction Processing-Shared (ATP-S) database, verify the application URLs, and ensure that data is accessible from the application.
After you perform sanity check:
- For Oracle Fusion Middleware products - Resume the job at the Switchover phase, complete the Switchover phase and Cleanup phase, and complete migration.
Parent topic: Complete the Postmigration Tasks