2 Migrating 14c (14.1.2.0.0) Oracle Fusion Middleware On-Premises Database to an Autonomous Transaction Processing-Dedicated Database
Migrate an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for the Oracle Fusion Middleware products, Oracle WebCenter Content, Oracle WebCenter Portal, Oracle WebCenter Sites, Oracle SOA Suite, including the components, Oracle Enterprise Scheduler Services and Oracle Managed File Transfer, Oracle Forms, and Oracle Reports only.
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 an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, you must meet the prerequisites and perform the premigration tasks that are described in this section. - Migration Tasks
Complete the steps in the following sections to migrate an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database: - Postmigration Tasks
After migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) 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 an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, you must meet the prerequisites and perform the premigration tasks that are described in this section.
- Prerequisites to Migrate an On-Premises Database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) Database
Perform the following prerequisites before you migrate an on-premises database to Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database. - Premigration Tasks
Perform the following premigration tasks before you migrate an on-premises database to Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database:
Prerequisites to Migrate an On-Premises Database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) Database
Perform the following prerequisites before you migrate an on-premises database to Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database.
Note:
The prerequisites for Oracle Reports is covered in Prerequisites to Migrate an On-Premises Database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) Database for Oracle Reports.
-
Install and configure Oracle Fusion Middleware version 14.1.2.0.0 domain on an on-premises database. If the Oracle Fusion Middleware version is 12c (12.2.1.4.0), perform an end-to-end upgrade to 14c (14.1.2.0.0) release version.
Note:
In case of Oracle Forms, perform an end-to-end upgrade to 14c (14.1.2.0.0) release version, if the Oracle Fusion Middleware version is 12c (12.2.1.4.0). -
Install the Oracle Instant Client with SQL*Plus and impdp tools on the Oracle Cloud Infrastructure (OCI) machine.
See Oracle Instant Client Downloads.
- Prerequisites to Migrate an On-Premises Database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) Database for Oracle Reports
Perform the following prerequisites before you migrate an on-premises database to Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database.
Parent topic: Prepare to Migrate
Prerequisites to Migrate an On-Premises Database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) Database for Oracle Reports
Perform the following prerequisites before you migrate an on-premises database to Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database.
Note:
The Oracle Cloud Infrastructure (OCI) VM should be in the same tenancy as your dedicated autonomous database.
-
Configure the OCI VM with at least 15 GB of memory (RAM) and 60 GB of disk space (total storage).
-
Install the environment group "Server with GUI" in the OCI VM to enable GUI after reboot:
sudo su - root yum groupinstall "Server with GUI" ln -sf '/lib/systemd/system/runlevel5.target' '/etc/systemd/system/default.target' exit
-
Install Tiger VNC using the following commands:
sudo su - root yum install tigervnc-server exit
You must manually start the VNC server after the machine reboots.
-
Resize the system disk partition to allocate more disk space to your volume as follows:
-
Determine the volume files system that should be increased:
lsblk
-
Extend the root partition, and reboot the machine:
sudo growpart /dev/sda 3 sudo reboot
-
-
Start the VNC server manually as current user with a screen resolution as follows:
vncserver -geometry 1280x1024
Note:
If you are starting the VNC server for the first time, you must create a password. The resolution should not be larger than the monitor size.
-
Check the currently installed Oracle Fusion Middleware OS packages and kernel are up to date:
sudo yum -y update
-
Determine if the Oracle Fusion Middleware OS packages are installed.
You can manually check the packages using information in Operating System Requirements in System Requirements and Specifications.
If any of the packages are not installed, for Oracle Linux 7, run the following command:
sudo yum install <PACKAGE_NAME_WITHOUT_VERSION>*.x86_64
Premigration Tasks
Perform the following premigration tasks before you migrate an on-premises database to Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database:
- Creating Credentials
Create a database credential to authenticate between the Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database and the Oracle Cloud Infrastructure (OCI) object storage. - Installing 14c (14.1.2.0.0) Product Binaries in Oracle Cloud Infrastructure VM
Ensure that the 14c (14.1.2.0.0) product binaries are installed in the newORACLE_HOME
. - 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.
Parent topic: Prepare to Migrate
Creating Credentials
Create a database credential to authenticate between the Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database and the Oracle Cloud Infrastructure (OCI) object storage.
Parent topic: Premigration Tasks
Installing 14c (14.1.2.0.0) Product Binaries in Oracle Cloud Infrastructure VM
Ensure that the 14c (14.1.2.0.0) product
binaries are installed in the new ORACLE_HOME
.
Copy the 14c (14.1.2.0.0) Oracle Fusion Middleware installers from the on-premises VM to the OCI VM. To copy the installer files from on-premises to the OCI host, you can also upload the file to Oracle Cloud Infrastructure (OCI) Object Storage and download this file to the OCI VM. See Using Oracle Autonomous Database on Dedicated Exadata Infrastructure.
After copying the installer files, install the products. See the Oracle Fusion Middleware library page.
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
Migration Tasks
Complete the steps in the following sections to migrate an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database:
Exporting an On-Premises Database and Creating a Domain Template steps are performed on an on-premises host and the remaining steps are performed on the OCI host.
- Exporting an On-Premises Database to a Data Dump File
Use Oracle Data Pump to export data from an on-premises database to your Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database. - Creating a Domain Template for an On-Premises Domain
Use the Domain Template Builder to create a custom domain template. - Uploading the Data Dump File and Template to Oracle Cloud Infrastructure Object Storage
Use this task to create a new storage bucket and upload the export files to it. - Creating Users and Tablespaces
Use Oracle Instant Client to create users and tablespaces. - Importing the Data Dump File to an Oracle Autonomous Transaction Processing-Dedicated Database
Use this task to import the data for the schemas. - Restoring the Schema Version Registry
To migrate schema version registry from an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, you must restore the schema version registry on your dedicated autonomous database. - Creating a New Domain Using the Configuration Wizard
Use the Configuration Wizard to create a new domain in your Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database Oracle Cloud Infrastructure (OCI) VM with the Domain Template you created for an on-premises domain. - Updating the Configuration Files in the Oracle Cloud Infrastructure Domain Host
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 (OCI) domain host.
Exporting an On-Premises Database to a Data Dump File
Use Oracle Data Pump to export data from an on-premises database to your Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database.
To export data from an on-premises database to a data dump file:
#Set the environment variables and connect to the database as SYS user using sqlplus,
and then select the users that are applicable to Oracle Forms product. Refer steps 1 to 4.
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_PWD>@<DB_SID> schemas=abc directory=test_dir dumpfile=abc_meta.dmp logfile=abc1.log
Parent topic: Migration Tasks
Creating a Domain Template for an On-Premises Domain
Use the Domain Template Builder to create a custom domain template.
To create a domain template for an on-premises domain using the Domain Template Builder:
Parent topic: Migration Tasks
Uploading the Data Dump File and Template to Oracle Cloud Infrastructure Object Storage
Use this task to create a new storage bucket and upload the export files to it.
To upload the data dump file and template to Oracle Cloud Infrastructure (OCI) Object Storage:
Parent topic: Migration Tasks
Creating Users and Tablespaces
Use Oracle Instant Client to create users and tablespaces.
Parent topic: Migration Tasks
Importing the Data Dump File to an Oracle Autonomous Transaction Processing-Dedicated Database
Use this task to import the data for the schemas.
To import the data dump file to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database database using data dump:
#Set the environment variables and navigate to the directory where Oracle Instant Client is installed, and then log into the database as an admin user using sqlplus. Refer steps 1
to 3.
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: Migration Tasks
Restoring the Schema Version Registry
To migrate schema version registry from an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, you must restore the schema version registry on your dedicated autonomous database.
Before you restore the schema version registry:
-
You must download or copy the registry from an on-premises host to the OCI host.
-
You must have applied OPatch for
ua restoreRegistry
. See 32089134 to apply the OPatch.Note:
If you do not apply OPatch, you might run into issues while creating the domain.
You can restore the schema version registry only for the schemas that are imported to the ATP-D database.
To restore the schema version registry to your dedicated autonomous database (ATP-D):
Parent topic: Migration Tasks
Creating a New Domain Using the Configuration Wizard
Use the Configuration Wizard to create a new domain in your Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database Oracle Cloud Infrastructure (OCI) VM with the Domain Template you created for an on-premises domain.
Note:
During migration, the source and targetprocess group
name of the domain must be the same,
else, you cannot view the imported source details for the OCI VM, if you need to
look for this information from the OCI VM.
To create a domain template, see Creating a Domain Template for an On-Premises Domain.
You must download or copy the domain template file from an on-premises host to the OCI host before you create a domain.
To create a domain using the Configuration Wizard:
Parent topic: Migration Tasks
Updating the Configuration Files in the Oracle Cloud Infrastructure Domain Host
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 (OCI) domain host.
Parent topic: Migration Tasks
Postmigration Tasks
After migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, perform the tasks described in this section. Some of these tasks apply to specific schemas.
If you run into any issues during post-migration, see Errors Postmigration to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) Database.
- Postmigration Tasks for Oracle WebCenter Sites
Perform the following steps after migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle WebCenter Sites: - Postmigration Tasks for Oracle Enterprise Content Management Suite
Perform the following steps after migrating on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle Enterprise Content Management Suite (ECM): - Postmigration Tasks for Oracle WebCenter Content
After migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle WebCenter Content, perform the steps described in Migrating Oracle WebCenter Content. - Postmigration Tasks for Oracle WebCenter Portal
Perform the following steps after migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle WebCenter Portal: - Postmigration Tasks for Oracle Forms and Oracle Reports
Perform the following steps after migrating on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle Forms and Oracle Reports. - Starting the Servers
After the migration of your on-premises to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, restart all processes and servers, including the Administration Server and any Managed Servers. - Performing Sanity Check
After the migration of your on-premises to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, verify the application URLs, and ensure that data is accessible from the application.
Postmigration Tasks for Oracle WebCenter Sites
Perform the following steps after migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle WebCenter Sites:
Parent topic: Postmigration Tasks
Postmigration Tasks for Oracle Enterprise Content Management Suite
Perform the following steps after migrating on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle Enterprise Content Management Suite (ECM):
Note:
These steps are applicable only to Oracle Universal Content Management (UCM), Oracle Inbound Refinery (IBR), Oracle Universal Records Management (URM), and Oracle Imaging and Process Management (IPM).
Parent topic: Postmigration Tasks
Postmigration Tasks for Oracle WebCenter Content
After migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle WebCenter Content, perform the steps described in Migrating Oracle WebCenter Content.
For more information, see Migrating Oracle WebCenter Content.
To configure full-text search, you must rebuild indexes using the Repository Manager. For more information, see Enable Full-Text Search in Administering Oracle WebCenter Content.
Parent topic: Postmigration Tasks
Postmigration Tasks for Oracle WebCenter Portal
Perform the following steps after migrating an on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle WebCenter Portal:
Parent topic: Postmigration Tasks
Postmigration Tasks for Oracle Forms and Oracle Reports
Perform the following steps after migrating on-premises database to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database for Oracle Forms and Oracle Reports.
-
For Oracle Forms, take a backup of your
Domain_Home
, and create a configuration file for postmigration of Oracle Forms.Note:
Ensure that you have execute permissions for thePostmigrationformsconfig.sh
file../Postmigrationformsconfig.sh #!/bin/sh # OLD_DOMAIN_HOME=<ON_PREMISE_DOMAIN_HOME> NEW_DOMAIN_HOME=<OCI_DOMAIN_HOME> OLD_ORACLE_HOME=<ON_PREMISE_ORACLE_HOME> NEW_ORACLE_HOME=<OCI_ORACLE_HOME> DEFAULT_ENV=$NEW_DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_12.2.1/config/default.env BACKUP_DEFAULT_ENV=$NEW_DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_12.2.1/config/default.env.pre_script FORMS_WEB_CFG=$NEW_DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_12.2.1/config/formsweb.cfg BACKUP_FORMS_WEB_CFG=$NEW_DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_12.2.1/config/formsweb.cfg.pre_script cp -rpf $DEFAULT_ENV $BACKUP_DEFAULT_ENV cp -rpf $FORMS_WEB_CFG $BACKUP_FORMS_WEB_CFG sed -i 's#'"$OLD_DOMAIN_HOME"'#'"$NEW_DOMAIN_HOME"'#g' $DEFAULT_ENV sed -i 's#'"$OLD_ORACLE_HOME"'#'"$NEW_ORACLE_HOME"'#g' $DEFAULT_ENV sed -i 's#'"$OLD_DOMAIN_HOME"'#'"$NEW_DOMAIN_HOME"'#g' $FORMS_WEB_CFG sed -i 's#'"$OLD_ORACLE_HOME"'#'"$NEW_ORACLE_HOME"'#g' $FORMS_WEB_CFG
-
For Oracle Reports, update the
tnsnames.ora
file located inDOMAIN_HOME/config/fmwconfig
with the ATP-D database details.For example:
-connectString description=(CONNECT_TIMEOUT=120)(RETRY_COUNT=20)(RETRY_DELAY=3) \ (TRANSPORT_CONNECT_TIMEOUT=3)(ADDRESS_LIST=(LOAD_BALANCE=on)(ADDRESS=(PROTOCOL=protocol_name) \ (HOST=host_name)(PORT=port_number)))(CONNECT_DATA=(SERVICE_NAME=service_name)))
Parent topic: Postmigration Tasks
Starting the Servers
After the migration of your on-premises to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, restart all processes and servers, including the Administration Server and any Managed Servers.
See Starting and Stopping Administration and Managed Servers and Node Manager in Administering Oracle Fusion Middleware.
Parent topic: Postmigration Tasks
Performing Sanity Check
After the migration of your on-premises to an Oracle Autonomous Transaction Processing-Dedicated (ATP-D) database, verify the application URLs, and ensure that data is accessible from the application.
Parent topic: Postmigration Tasks