Migrating Oracle GoldenGate Cloud Service to Oracle Cloud ... · Oracle GoldenGate on Oracle Cloud Marketplace simplifies the tasks of upgrading software versions or applying bundle

Oracle® CloudMigrating Oracle GoldenGate Cloud Serviceto Oracle Cloud Marketplace - ClassicArchitecture

F19441-03September 2019

Oracle Cloud Migrating Oracle GoldenGate Cloud Service to Oracle Cloud Marketplace - ClassicArchitecture,

F19441-03

Copyright © 2019, Oracle and/or its affiliates. All rights reserved.

Primary Author: Oracle Corporation

This software and related documentation are provided under a license agreement containing restrictions onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in yourlicense agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify,license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.Reverse engineering, disassembly, or decompilation of this software, unless required by law forinteroperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it onbehalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of theprograms, including any operating system, integrated software, any programs installed on the hardware,and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications.It is not developed or intended for use in any inherently dangerous applications, including applications thatmay create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure itssafe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of thissoftware or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks oftheir respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks areused under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron,the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced MicroDevices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products,and services from third parties. Oracle Corporation and its affiliates are not responsible for and expresslydisclaim all warranties of any kind with respect to third-party content, products, and services unless otherwiseset forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not beresponsible for any loss, costs, or damages incurred due to your access to or use of third-party content,products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

1 Learn About Migrating to Oracle Cloud Marketplace

About Oracle Cloud Marketplace 1-1

Why Migrate to Oracle Cloud Marketplace 1-1

About the Migration Scope 1-2

About the Migration Task Flow 1-2

2 Prepare to Migrate Oracle GoldenGate Cloud Instances to OracleCloud Marketplace

About Downtime Requirements 2-1

Select Oracle Cloud Marketplace Shapes 2-1

Deploy Oracle GoldenGate 19c on Oracle Cloud Marketplace 2-2

Configure Oracle GoldenGate 19c On Oracle Cloud Marketplace 2-2

Perform Pre-Migration Tasks 2-2

3 Migrate an Oracle GoldenGate Cloud Instance to Oracle CloudMarketplace

Stop Oracle GoldenGate Processes 3-1

Stop the Integrated Extract 3-1

Stop the Extract Data Pump 3-2

Stop the Integrated Replicat 3-2

Copy Oracle GoldenGate Configurations 3-3

Copy the GLOBALS File 3-6

Copy the Login Credentials 3-6

Copy the Integrated Extract 3-7

Copy the Integrated Replicat 3-8

Copy the Extract Data Pump 3-8

Copy the Checkpoint File 3-9

Copy the Trail File 3-10

Start the GoldenGate Processes 3-10

Start the Integrated Extract 3-10

Start the Extract Data Pump 3-10

iii

Alter Replicat 3-11

Start the Integrated Replicat 3-12

4 Complete Post-Migration Tasks

Test the Migrated GoldenGate Instance 4-1

Clean Up Resources in Oracle Cloud Infrastructure Classic 4-1

iv

1Learn About Migrating to Oracle CloudMarketplace

Learn about the advantages of using Oracle GoldenGate in Oracle Cloud Marketplace,and get an overview of the procedure for migrating your Oracle GoldenGate CloudService classic instances to Oracle Cloud Marketplace.

Topics:

• About Oracle Cloud Marketplace

• Why Migrate to Oracle Cloud Marketplace

• About the Migration Scope

• About the Migration Task Flow

About Oracle Cloud MarketplaceOracle Cloud Marketplace is an online store—a one-stop shop—selling hundreds ofbusiness apps and professional services that complement your existing Oracle Cloudimplementation.

Oracle Cloud Marketplace:

• Offers a large collection of trusted and innovative apps in many businesscategories, including marketing, sales, customer service, social, and talentmanagement.

Like add-on or plug-in software, these apps provide enhanced functions orcustomizations for your existing Oracle Cloud implementation.

• Offers an assortment of services, such as consulting, implementation, integration,and training, to help you transition to the cloud and improve the successfuloperation of your company.

Why Migrate to Oracle Cloud MarketplaceOracle encourages you to migrate your existing cloud resources from Oracle CloudInfrastructure Classic regions. You gain several advantages by doing so.

In Oracle Cloud, you provision resources in specific regions, which are localized togeographic locations. Certain regions support the Oracle Cloud Infrastructure platform.

Oracle Cloud Infrastructure is Oracle's modern cloud platform that's based on thelatest cloud technologies and standards. It provides more consistent performance andbetter features at lower costs. Oracle continues to invest in Oracle CloudInfrastructure, including the addition of new regions, services, and features. See DataRegions for Platform and Infrastructure Services.

1-1

https://cloud.oracle.com/data-regions

https://cloud.oracle.com/data-regions

Oracle GoldenGate on Oracle Cloud Marketplace simplifies the tasks of upgradingsoftware versions or applying bundle patches.

About the Migration ScopeUse this guide to migrate your Oracle GoldenGate Cloud Service classic instances toOracle Cloud Marketplace running Oracle GoldenGate 19c Microservices and Classic.

The migration steps are tested and verified for Oracle GoldenGate for Oracle ClassicArchitecture. All Oracle GoldenGate Cloud supported Oracle GoldenGate installations(Oracle GoldenGate for Big Data, Oracle GoldenGate for MySQL, and OracleGoldenGate for DB2 zOS) are not yet part of the migration scope. The support tomigrate heterogeneous databases will be added soon. You can continue using the Migrating Oracle GoldenGate Cloud Classic Instances to Oracle Cloud Infrastructureguide for heterogeneous databases.

The scope of the migration is to move the replication configurations and itsfunctionalities only. Oracle GoldenGate Cloud Control functionalities will not bemigrated nor available in the new instances.

Oracle GoldenGate Monitoring in the Oracle Cloud Infrastructure instances can bedone using Oracle Enterprise Manager plugin for Oracle GoldenGate. See How do IMonitor Processes in Oracle GoldenGate Enterprise Manager Plug-in User Guide.

If you are using Oracle Database Cloud Service Classic as a source or targetdatabase for replication, Oracle recommends that you migrate your Oracle DatabaseCloud Service Classic to Oracle Database on Oracle Cloud Infrastructure. For thesteps to migrate your Oracle Database Cloud Service Classic to Oracle Database onOracle Cloud Infrastructure, see Select a Method to Migrate Database Instances.

About the Migration Task FlowGet an overview of the task that you need to perform to migrate your existing OracleGoldenGate Cloud classic instances to Oracle GoldenGate on Oracle CloudMarketplace.

Oracle GoldenGate on Oracle Cloud Marketplace contains two images: GoldenGatefor Oracle 19c Classic and GoldenGate for Oracle 19c Microservices. OracleGoldenGate Cloud Service instance contains GoldenGate for Oracle Classic andMicroservices instances. We recommend to migrate your Oracle GoldenGate CloudService classic instances to Oracle GoldenGate 19c Classic on Oracle CloudMarketplace. To migrate Oracle GoldenGate Cloud Service microservices instance toGoldenGate 19c Microservices on Oracle Cloud Marketplace, please contact support.

The migration plan for Oracle GoldenGate Cloud Service is to move the OracleGoldenGate Cloud Service classic instances to Oracle GoldenGate instances runningon Oracle Cloud Marketplace. The migration does not change your currentconfigurations and you can resume your replication after the migration is completed.After the migration, you run and manage replication from the Oracle GoldenGaterunning on Oracle Cloud Marketplace instead of Oracle GoldenGate Cloud Service.

At a high level, you need to perform the following tasks:

1. Get an instance in Oracle Cloud Marketplace.

2. Deploy Oracle GoldenGate 19c Classic on the Oracle Cloud Marketplace instance.

Chapter 1About the Migration Scope

1-2

3. Prepare for the migration and perform the pre-migration tasks in Oracle CloudMarketplace.

4. Copy configurations from Oracle GoldenGate Cloud Service instance to the OracleCloud Marketplace instance.

5. Start Oracle GoldenGate processes on the Oracle Cloud Marketplace instance.

6. Test your applications on the target instance and perform the post-migration tasks.

Chapter 1About the Migration Task Flow

1-3

2Prepare to Migrate Oracle GoldenGateCloud Instances to Oracle CloudMarketplace

Before you migrate your Oracle GoldenGate Cloud classic instances to Oracle CloudMarketplace, understand how the migration affects your existing instances, identify thenecessary compute shapes, create the network to support your target migrationinstances, and complete the pre-migration tasks.

Topics:

• About Downtime Requirements

• Select Oracle Cloud Marketplace Shapes

• Deploy Oracle GoldenGate 19c on Oracle Cloud Marketplace

• Configure Oracle GoldenGate 19c On Oracle Cloud Marketplace

• Perform Pre-Migration Tasks

About Downtime RequirementsThe migration process minimally impacts the availability of your existing OracleGoldenGate Cloud instance in Oracle Cloud Infrastructure Classic. This instance isstopped right before the migration. When it is started after the migration, the replicationprocess resumes from where it was stopped.

The Oracle GoldenGate Cloud Service classic instance files such as the configurationfiles, report files, or trail files are not impacted by the migration process.

After the Oracle GoldenGate Cloud classic instance is migrated successfully, clientscan be rerouted to the new instance in Oracle Cloud Marketplace.

Select Oracle Cloud Marketplace ShapesIdentify the compute shapes in Oracle Cloud Marketplace that provide similar or higherresources to shapes you're currently using for your service instances in OracleGoldenGate Cloud Service.

A compute shape defines the IaaS resources, such as OCPUs and memory, that areavailable to a specific node in a service instance. Oracle Cloud Infrastructure andOracle Cloud Infrastructure Classic each has its own set of standard compute shapes.See:

• About Shapes in Using Oracle Cloud Infrastructure Compute Classic

• Compute Shapes in the Oracle Cloud Infrastructure documentation

The supported compute shapes are VM.Standard2.4, VM.Standard2.8,VM.Standard2.16, and VM.Standard2.24.

2-1

https://www.oracle.com/pls/topic/lookup?ctx=cloud&id=STCSG-GUID-1DD0FA71-AC7B-461C-B8C1-14892725AA69

To ensure that a migrated service instance has the same performance characteristicsas the original instance, and can support an equivalent workload, choose Oracle CloudInfrastructure shapes that most closely map to the Oracle Cloud Infrastructure Classicshapes that you specified when you created the instance.

You must also confirm that the chosen shapes are available in your Oracle Cloudtenancy. Oracle configures shape limits for an Oracle Cloud Infrastructure region, orfor a specific availability domain within a region. You can use the console to view thecurrent shape limits for your tenancy, and to request a limit increase if necessary. See Service Limits in the Oracle Cloud Infrastructure documentation.

Additionally, plan and implement a proper Oracle Cloud Infrastructure network for yourcloud resources. See Overview of Networking.

Deploy Oracle GoldenGate 19c on Oracle CloudMarketplace

To get started with using Oracle GoldenGate 19c on Oracle Cloud Marketplace, youmust deploy Oracle GoldenGate 19c on Oracle Cloud Marketplace.

To deploy Oracle GoldenGate 19c on Oracle Cloud Marketplace, see DeployingOracle GoldenGate Classic Architecture for Oracle Database.

After deploying Oracle GoldenGate 19c on Oracle Cloud Marketplace, you can getstarted with using Oracle GoldenGate 19c.

Configure Oracle GoldenGate 19c On Oracle CloudMarketplace

After deploying Oracle GoldenGate 19c on Oracle Cloud Marketplace, you can accessthe latest release of Oracle GoldenGate.

To configure Oracle GoldenGate 19c, see Getting Started with Oracle GoldenGateClassic Architecture for Oracle Database.

Perform Pre-Migration TasksComplete the pre-migration tasks on your Oracle GoldenGate Cloud instance.

Before you migrate your Oracle GoldenGate Cloud classic architecture instance to anOracle GoldenGate instance on Oracle Cloud Marketplace, you should backup yourdata.

Backup and secure the data on cloud storage for the instance you want to migrate.Data includes configuration files and trail file data. The data location is /u02/data/ggdata. For steps to perform the backup, see Perform Backup and Restore.

You should also make sure that all the required sub-directories are created and theOracle GoldenGate classic installation directory is up and running without the extractand the replicat configured. You should make sure that the databases are accessibleto the Oracle GoldenGate marketplace machine.

Chapter 2Deploy Oracle GoldenGate 19c on Oracle Cloud Marketplace

2-2

https://docs.cloud.oracle.com/iaas/Content/Network/Concepts/overview.htm

3Migrate an Oracle GoldenGate CloudInstance to Oracle Cloud Marketplace

To migrate the Oracle GoldenGate Cloud classic instance to Oracle CloudMarketplace, you copy the configuration files from the existing Oracle GoldenGateinstance to the new Oracle Cloud Infrastructure Marketplace instance. You can thencontinue replication from where you left off. You may have to make some changes tothe configuration files for necessary database credentials, if you changed anything inthe new environment.

Topics:

• Stop Oracle GoldenGate Processes

• Copy Oracle GoldenGate Configurations

• Start the GoldenGate Processes

Stop Oracle GoldenGate Processes

Topics:

• Stop the Integrated Extract

• Stop the Extract Data Pump

• Stop the Integrated Replicat

Stop the Integrated Extract

To stop the integrated extract, perform the following steps:

1. Connect to the Oracle GoldenGate Cloud Service instance.

2. Start GGSCI.

3. Check the transaction status in extract for long running transactions against tablesbeing captured by Oracle GoldenGate.

GGSCI> send exta, showtrans

Note:

Make sure that these transactions commit or are rolled back if they aretoo old, otherwise the recovery time on the new extract will increase.

4. After the long running transactions are committed or rolled back, you can proceedto the next step of stopping the extract.

3-1

5. Stop the integrated extract.

GGSCI> stop exta

Stop the Extract Data Pump

To ensure that all the Oracle GoldenGate trail queued data has been shipped to thetarget Oracle GoldenGate instance, perform the following steps:


2. Start GGSCI.

3. Get the last read position of extract data pump in the Oracle GoldenGate CloudService instance.

GGSCI> info extapmpEXTRACT EXTAPMP Last Started 2019-06-21 20:38 Status RUNNINGCheckpoint Lag 00:00:00 (updated 00:00:05 ago)Process ID 123005Log Read Checkpoint File /u02/data/gg123ora18c/dirdat/ea1000000006 2019-06-21 21:03:26.000000 RBA 2031

4. Check the number and size of the Oracle GoldenGate trails remaining to beprocessed on disk.

GGSCI>shell ls -l ./dirdat/ea1*-rw-r-----. 1 oracle oracle 1251 Jun 17 03:04 ./dirdat/ea1000000000-rw-r-----. 1 oracle oracle 1310 Jun 21 20:10 ./dirdat/ea1000000001-rw-r-----. 1 oracle oracle 1310 Jun 21 20:19 ./dirdat/ea1000000002-rw-r-----. 1 oracle oracle 1310 Jun 21 20:33 ./dirdat/ea1000000003-rw-r-----. 1 oracle oracle 1310 Jun 21 20:39 ./dirdat/ea1000000004-rw-r-----. 1 oracle oracle 1814 Jun 21 20:51 ./dirdat/ea1000000005-rw-r-----. 1 oracle oracle 2031 Jun 21 21:25 ./dirdat/ea1000000006-rw-r-----. 1 oracle oracle 1310 Jun 21 21:25 ./dirdat/ea1000000007

5. If the RBA value of the extract data pump 'log read checkpoint' matches the filesize value from the output of the ls command, there is no more data to beprocessed. The extract data pump can be shutdown.

6. Stop the extract data pump.

GGSCI> stop extapmp

Stop the Integrated Replicat

To stop the integrated replicat, perform the following steps:


2. Start GGSCI.

Chapter 3Stop Oracle GoldenGate Processes

3-2

3. Confirm that all the queued Oracle GoldenGate trail data has been applied to thetarget database. Get the last read position of the integrated replicat by executingthe INFO replicat command.

GGSCI> info repa

REPLICAT REPA Last Started 2019-06-21 20:51 Status RUNNINGINTEGRATEDCheckpoint Lag 00:00:00 (updated 00:00:07 ago)Process ID 125403Log Read Checkpoint File /u02/data/gg123ora18c/dirdat/t1000000002 2019-06-21 20:57:33.827547 RBA 2549

4. Check the number and size of the Oracle GoldenGate trail files remaining to beprocessed on disk.

GGSCI> shell ls -l ./dirdat/t1*-rw-r-----. 1 oracle oracle 1369 Jun 21 20:10 ./dirdat/t1000000000-rw-r-----. 1 oracle oracle 1487 Jun 21 20:39 ./dirdat/t1000000001-rw-r-----. 1 oracle oracle 2549 Jun 21 20:51 ./dirdat/t1000000002

If the RBA value of the integrated replicat LOG read checkpoint matches the filesize value from the output of the ls command, there is no more data to beprocessed. The integrated replicat may be shutdown, otherwise you may wait forthe data to be processed.

5. Stop the integrated replicat.

GGSCI> stop repa

Copy Oracle GoldenGate ConfigurationsTo view the Oracle GoldenGate configuration files that you need to copy to the newOracle GoldenGate instance on Oracle Cloud Marketplace, perform the followingsteps:

1. Connect to your Oracle GoldenGate Cloud classic instance.

2. Start GGSCI from either Oracle GoldenGate 12.2 or Oracle GoldenGate 18.1classic architecture. The migration steps are the same for both versions.

3. Enter status all. The Oracle GoldenGate groups that need to be migrated aredisplayed.

GGSCI> status allProgram Status Group Lag at Chkpt Time Since ChkptMANAGER RUNNING JAGENT STOPPED PMSRVR STOPPEDEXTRACT EXTA STOPPED EXTRACT EXTAPMP STOPPED REPLICAT REPA STOPPED

Chapter 3Copy Oracle GoldenGate Configurations

3-3

4. View the Oracle GoldenGate extract process details by running the info <extractname>, showch command.

GGSCI> info exta, showchEXTRACT EXTA Last Started 2019-06-21 20:51 Status STOPPEDCheckpoint Lag 00:00:00 (updated 00:00:02 ago)Process ID 125394Log Read Checkpoint Oracle Integrated Redo Logs 2019-06-21 21:06:32 SCN 0.6362801 (6362801)Current Checkpoint Detail:Read Checkpoint #1 Oracle Integrated Redo Log Startup Checkpoint (starting position in the data source): Timestamp: 2019-06-21 20:08:04.000000 SCN: Not available Recovery Checkpoint (position of oldest unprocessed transaction in the data source): Timestamp: 2019-06-21 21:06:32.000000 SCN: 0.6362801 (6362801) Current Checkpoint (position of last record read in the data source): Timestamp: 2019-06-21 21:06:32.000000 SCN: 0.6362801 (6362801)Write Checkpoint #1 GGS Log Trail Current Checkpoint (current write position): Sequence #: 6 RBA: 2031 Timestamp: 2019-06-21 20:52:29.185553 Extract Trail: ./dirdat/ea1 Seqno Length: 9 Flip Seqno Length: No Trail Type: EXTTRAILHeader: Version = 2 Record Source = A Type = 18 # Input Checkpoints = 1 # Output Checkpoints = 1File Information: Block Size = 2048 Max Blocks = 100 Record Length = 2048 Current Offset = 0Configuration: Data Source = 3 Transaction Integrity = 1 Task Type = 0Status: Start Time = 2019-06-21 20:51:08 Last Update Time = 2019-06-21 20:52:29 Stop Status = A Last Result = 400


3-4

5. View the Oracle GoldenGate data pump process details by running the info<pump extract name>, detail command.

GGSCI> info extapmp, detailEXTRACT EXTAPMP Last Started 2019-06-21 20:38 Status STOPPEDCheckpoint Lag 00:00:00 (updated 00:00:05 ago)Process ID 123005Log Read Checkpoint File /u02/data/gg123ora18c/dirdat/a1000000006 2019-06-21 21:03:26.000000 RBA 2031 Target Extract Trails: Trail Name Seqno RBA Max MB Trail Type ./dirdat/t1 2 2549 10 RMTTRAIL Extract Source Begin End /u02/data/gg123ora18c/dirdat/ea1000000006 2019-06-21 20:33 2019-06-21 21:03 /u02/data/gg123ora18c/dirdat/ea1000000004 * Initialized * 2019-06-21 20:33 /u02/data/gg123ora18c/dirdat/ea1000000000 * Initialized * First Record ./dirdat/ea1000000000 * Initialized * First RecordCurrent directory /u02/data/gg123ora18cReport file /u02/data/gg123ora18c/dirrpt/EXTAPMP.rptParameter file /u02/data/gg123ora18c/dirprm/extapmp.prmCheckpoint file /u02/data/gg123ora18c/dirchk/EXTAPMP.cpeProcess file /u02/data/gg123ora18c/dirpcs/EXTAPMP.pceError log /u02/data/gg123ora18c/ggserr.log

6. View the Oracle GoldenGate replicat process details by running the info<replicat name>, detail command.

GGSCI> info repa, detailREPLICAT REPA Last Started 2019-06-21 20:51 Status STOPPEDINTEGRATEDCheckpoint Lag 00:00:00 (updated 00:00:07 ago)Process ID 125403Log Read Checkpoint File /u02/data/gg123ora18c/dirdat/t1000000002 2019-06-21 20:57:33.827547 RBA 2549INTEGRATED ReplicatDBLOGIN Provided, inbound server name is OGG$REPA in ATTACHED stateCurrent Log BSN value: 6358637Low Watermark CSN value: 6361905(All source transactions prior to this scn have been applied)High Watermark CSN value: 6362038(Some source transactions between this scn and the low watermark may have been applied) Extract Source Begin End /u02/data/gg123ora18c/dirdat/t1000000002 2019-06-21 20:46 2019-06-21 20:57 /u02/data/gg123ora18c/dirdat/t1000000002 2019-06-21 20:39 2019-06-21 20:46 /u02/data/gg123ora18c/dirdat/t1000000002 2019-06-21 20:19 2019-06-21 20:39 /u02/data/gg123ora18c/dirdat/t1000000001 * Initialized * 2019-06-21 20:19 /u02/data/gg123ora18c/dirdat/t1000000000 * Initialized * First


3-5

Record /u02/data/gg123ora18c/dirdat/t1000000000 * Initialized * First Record ./dirdat/t1000000000 * Initialized * First RecordCurrent directory /u02/data/gg123ora18cReport file /u02/data/gg123ora18c/dirrpt/REPA.rptParameter file /u02/data/gg123ora18c/dirprm/repa.prmCheckpoint file /u02/data/gg123ora18c/dirchk/REPA.cprProcess file /u02/data/gg123ora18c/dirpcs/REPA.pcrError log /u02/data/gg123ora18c/ggserr.log

7. Confirm that the Oracle GoldenGate environmental variables are set properly.

Copy the GLOBALS File

To copy the GLOBALS file, perform the following steps:

1. Connect to your Oracle GoldenGate Cloud Service classic instance.

2. Open the GLOBALS file from the /u02/data/ggdata directory and copy all the text.

3. Connect to your Oracle GoldenGate classic instance on Oracle CloudMarketplace.

4. Open the GLOBALS file and merge the text copied in step 2.

GGSCHEMA GGADMINCHECKPOINTTABLE GGADMIN.CHKTBLRPLALLOWOUTPUTDIR /home/opc/oracle18/dirdatENABLEMONITORING

5. Save and close both files.

You have successfully copied the GLOBALS file from the Oracle GoldenGate CloudService instance to the Oracle GoldenGate instance on Oracle Cloud Marketplace.

Copy the Login CredentialsYou save the effort of creating all the credentials for the GoldenGate encryption keysmanually by copying the login credentials from the Oracle GoldenGate Cloud Serviceinstance to the Oracle GoldenGate instance on Oracle Cloud Marketplace.

To copy the login credentials file, perform the following steps:


2. Copy the contents of the dirwlt and dircrd directories from /u02/data/ggdata tothe dirwlt and dircrd directories in the Oracle GoldenGate instance on OracleCloud Marketplace.

You have successfully copied the login credentials from the Oracle GoldenGate CloudService instance to the Oracle GoldenGate instance on Oracle Cloud Marketplace.


3-6

Note:

You must also ensure that the $TNS_ADMIN/tnsnames.ora and $TNS_ADMIN/sqlnet.ora files in the Oracle GoldenGate instance on Oracle CloudMarketplace contain the connection strings to the source and targetdatabases.

Copy the Integrated Extract

To copy the integrated extract, perform the following steps:


2. Copy the integrated extract parameter file from /u02/data/ggdata/dirprm to thedirprm directory in the Oracle GoldenGate instance on Oracle Cloud Marketplace.

3. Connect to the Oracle GoldenGate instance on Oracle Cloud Marketplace andopen the integrated extract parameter file you just copied in edit mode.

4. If you have changed anything in the new environment, include the new databasecredentials in the integrated extract parameter file.

Note:

We recommend that you do not change the database credentials or thesource/target databases during the Oracle GoldenGate migrationprocess.

5. From the integrated extract parameter file, remove the directory location ofEXTTRAIL and change the location as per the Oracle GoldenGate marketplaceinstallation directory.

After making all edits, the integrated extract parameter file may look like thefollowing sample:

extract exta SETENV (TNS_ADMIN='$ORACLE_HOME/network/admin') useridalias ggadmin_dbcs sourcecatalog dbcs4 ddl include all ddloptions report _NOUSETRIGGERMETADATA discardfile ./dirrpt/exto.dsc purge exttrail ./dirdat/a1 tranlogoptions _INFINITYTOZERO TABLE orclpdb.tkggu1.*;

You have successfully copied the integrated extract from the Oracle GoldenGateCloud Service instance to the Oracle GoldenGate instance on Oracle CloudMarketplace.


3-7

Copy the Integrated Replicat

To copy the integrated replicat, perform the following steps:


2. Copy the integrated replicat parameter file from /u02/data/ggdata/dirprm to thedirprm directory in the Oracle GoldenGate instance on Oracle Cloud Marketplace.

3. Connect to the Oracle GoldenGate instance on Oracle Cloud Marketplace andopen the integrated replicat parameter file you just copied in edit mode.

4. If you have changed anything in the new environment, include the new databasecredentials in the integrated replicat parameter file.

Note:


After making all edits, the integrated replicat parameter file may look like thefollowing sample:

replicat repaSETENV (TNS_ADMIN='$ORACLE_HOME/network/admin')useridalias ggadmin_pdb1ddlerror default discardddl include allddloptions reportDBOPTIONS INTEGRATEDPARAMS(parallelism6)discardfile ./dirrpt/repo.dsc purge, maxbytes 2147483646ASSUMETARGETDEFSmap orclpdb.tkggu1.*, TARGET orclpdb.tkggu2.*;

You have successfully copied the integrated replicat from the Oracle GoldenGateCloud Service instance to the Oracle GoldenGate instance on Oracle CloudMarketplace.

Copy the Extract Data Pump

To copy the extract data pump, perform the following steps:


2. Copy the extract data pump parameter files from /u02/data/ggdata/dirprm to thedirprm directory in the Oracle GoldenGate instance on Oracle Cloud Marketplace.

3. Connect to the Oracle GoldenGate instance on Oracle Cloud Marketplace andopen the extract data pump parameter file you just copied in edit mode.

4. If you have changed anything in the new environment, include the new databasecredentials in the extract data pump parameter file.


3-8

Note:


After making all edits, the extract data pump parameter file may look like thefollowing sample:

extract extapmpSETENV (TNS_ADMIN='$ORACLE_HOME/network/admin')useridalias ggadmin_dbcssourcecatalog dbcs4RMTHOST localhost, MGRPORT 7810rmttrail ./dirdat/t1passthruTABLE orclpdb.tkggu1.*;

You have successfully copied the extract data pump from the Oracle GoldenGateCloud Service instance to the Oracle GoldenGate instance on Oracle CloudMarketplace.

Copy the Checkpoint File

To copy the checkpoint file, perform the following steps:

1. Connect to the Oracle GoldenGate Cloud Service classic instance.

2. View the Oracle GoldenGate processes checkpoint.

GGSCI> info exta, showchGGSCI> info extapmp, detailGGSCI> info repa, detail

Save the results of these commands.

3. Copy the pce/pcb/pcr files from the dirchk directory in the Oracle GoldenGateCloud Service classic instance to the dirchk directory in the Oracle GoldenGateinstance on Oracle Cloud Marketplace.

4. Connect to the Oracle GoldenGate instance on Oracle Cloud Marketplace.

5. View the Oracle GoldenGate processes checkpoint in the Oracle CloudMarketplace instance and make sure it matches the information you viewed on theOracle GoldenGate Cloud Service instance.

GGSCI> info exta, showchGGSCI> info extapmp, detailGGSCI> info repa, detail

The only difference you should see is the replicat 'Log Read Checkpoint file',which still uses the old full path location.


3-9

Copy the Trail File

To ensure that the new trail file is written in the same format as the old trail file,perform the following steps:

1. Connect to the Oracle GoldenGate Cloud Service classic instance.

2. Copy the last trail file that was updated or read from the dirdat directory in theOracle GoldenGate Cloud Service classic instance to the dirdat directory in theOracle GoldenGate instance on Oracle Cloud Marketplace. You have to copy thesourcetrailfile and the trail file that the data pump writes to.

Start the GoldenGate Processes

Topics:

• Start the Integrated Extract

• Start the Extract Data Pump

• Alter Replicat

• Start the Integrated Replicat

Start the Integrated Extract

To start the integrated extract, perform the following steps:


2. Start GGSCI.

3. Establish a connection with the source database.

GGSCI> dblogin useridalias ggadmin_dbcsSuccessfully logged into database CDB$ROOT.

4. Start the integrated extract.

GGSCI> start extract extaSending START request to MANAGER ...EXTRACT EXTA starting

5. Check the integrated extract status.

info exta

You have successfully started the integrated extract process in the Oracle GoldenGateinstance in Oracle Cloud Marketplace.

Start the Extract Data Pump

To start the extract data pump, perform the following steps:

Chapter 3Start the GoldenGate Processes

3-10


2. Start GGSCI.

3. Establish a connection with the source database.

GGSCI> dblogin useridalias ggadmin_dbcsSuccessfully logged into database CDB$ROOT.

4. Alter the source trail file path to change the EXTSEQNO to the latest of theEXTSOURCETRAIL file.

GGSCI> alter extract extapmp exttrailsource ./dirdat/s1, EXTSEQNO <n>EXTRACT altered.

5. Start the extract data pump.

GGSCI> start extapmpSending START request to MANAGER ...EXTRACT EXTAPMP starting

6. Check the extract data pump status.

GGSCI> info extapmpEXTRACT EXTAPMP Last Started 2019-06-21 22:51 Status RUNNINGCheckpoint Lag 00:00:00 (updated 00:00:22 ago)Process ID 27770Log Read Checkpoint File /home/opc/oracle19/dirdat/ea1000000002 2019-06-21 22:50:25.000000 RBA 35862

Alter Replicat

Perform the followings steps to complete the migration process:


2. Start GGSCI.

3. Check the status of the replicat.

GGSCI> info repaREPLICAT REPA Last Started 2019-06-21 22:42 Status STOPPEDINTEGRATEDCheckpoint Lag 00:00:00 (updated 00:00:04 ago)Process ID 27234Log Read Checkpoint File /home/opc/oracle18/dirdat/t1000000001 2019-06-21 22:45:25.029946 RBA 32303

4. Run the following shell command.

GGSCI> shell ls -l ./dirdat/t1*

-rw-r-----. 1 opc opc 35106 Jun 21 22:48 ./dirdat/t1000000001


3-11

5. Alter the replicat to begin reading the new trail created by the extract data pump.

Alter replicat repa, exttrail ./dirdat/t1, extseqno 2, extrba 0, checkpointtable ORCLPDB.ggadmin.CHKTBLRPL

Start the Integrated Replicat

To start the integrated replicat, perform the following steps:


2. Start GGSCI.

3. Establish a connection with the target database.

GGSCI> dblogin useridalias ggadmin_pdb1Successfully logged into database ORCLPDB.

4. Start the integrated replicat.

GGSCI> start repaSending START request to MANAGER ...REPLICAT REPA starting

5. Check the integrated replicat status.

GGSCI> info repaREPLICAT REPA Last Started 2019-06-21 22:42 Status RUNNINGINTEGRATEDCheckpoint Lag 00:00:00 (updated 00:00:04 ago)Process ID 27234Log Read Checkpoint File /home/opc/oracle19/dirdat/t1000000001 2019-06-21 22:45:25.029946 RBA 32303

You have successfully started the integrated replicat process in the OracleGoldenGate instance in Oracle Cloud Marketplace.


3-12

4Complete Post-Migration Tasks

After successfully migrating your Oracle GoldenGate Cloud instances from OracleCloud Infrastructure Classic to Oracle Cloud Marketplace, test your instances andmigration scenarios, and then perform cleanup and other optional configuration tasks.

Topics:

• Test the Migrated GoldenGate Instance

• Clean Up Resources in Oracle Cloud Infrastructure Classic

Test the Migrated GoldenGate InstanceVerify that your migrated instance is accessible and the OGG processes are runningon the Oracle Cloud Marketplace instance.

Clean Up Resources in Oracle Cloud Infrastructure ClassicAfter testing your migrated instance in Oracle Cloud Marketplace, you can delete thesource instance and supporting cloud resources in Oracle Cloud Infrastructure Classic.

Delete your Oracle GoldenGate Cloud classic instance and any other supportingresources to avoid incurring costs for services you no longer use.

When you delete your Oracle GoldenGate Cloud classic instance,

• Compute resources such as block storage volumes and IP addresses areremoved.

• The Oracle Database Cloud Service instance isn’t deleted when you delete theservice instance, only the database repository and schemas are deleted. Youraccount remains charged for the database service instance. You may want toretain this database deployment if it's used for other service instances.

For more information, see Delete a Database Deployment.

• The Oracle Object Storage container isn't deleted. Your account remains chargedfor the storage container. You may want to retain this storage container if it's usedfor other service instances.

For more information, see Deleting Containers.

To delete your Oracle GoldenGate Cloud classic instance:

1. Log in to the Oracle Cloud My Services Dashboard and locate the OracleGoldenGate Cloud Service tile.

2. From the Action Menu, select Open Service Console.

3. From the Instances page, delete the instance that you successfully migrated toOracle Cloud Infrastructure.

a. Select the instance you want to delete.

4-1

b. From the Manage this Service menu, select Delete.

c. When prompted for confirmation, click Delete.

You have successfully deleted your Oracle GoldenGate Cloud classic instance.

Chapter 4Clean Up Resources in Oracle Cloud Infrastructure Classic

4-2

Documents

Migrating Oracle GoldenGate Cloud Service to Oracle Cloud ... · Oracle GoldenGate on Oracle Cloud Marketplace simplifies the tasks of upgrading software versions or applying bundle