Oracle® Fusion Middleware Administering Oracle GoldenGate for HP NonStop (Guardian) 12c (12.2.0.1) E57712-04 June 2018 Oracle Fusion Middleware Administering Oracle GoldenGate for HP NonStop (Guardian), 12c (12.2.0.1) E57712-04 Copyright © 2014, 2018, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license 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 for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you 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 on behalf 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 the programs, 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 that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used 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 Micro Devices. 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 expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible 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 Preface Audience xii Documentation Accessibility xii Related Information xii Conventions xiii 1 Understanding Oracle GoldenGate for HP NonStop Oracle GoldenGate Overview 1-1 Oracle GoldenGate Configuration 1-1 Oracle GoldenGate Features 1-2 Oracle GoldenGate Architecture 1-3 Oracle GoldenGate Components 1-3 Extract 1-4 Logger 1-4 Collector 1-5 Trails 1-5 Replicat 1-6 Manager 1-6 Syncfile 1-6 Processing Groups 1-6 Checkpoints 1-7 Parameters 1-7 Reader 1-7 Coordinator 1-8 Oracle GoldenGate Processing 1-8 Initial Data Synchronization 1-8 File to Replicat 1-8 Direct Load 1-9 Direct Bulk Load 1-9 Capturing Data Changes from TMF Applications 1-9 Capturing Changes for Distributed Network Transactions 1-10 Capturing Data Changes from Non-TMF applications 1-11 iii Using Extract for Data Distribution 1-12 Batch Processing 1-12 Capturing Directly from Files 1-13 Custom Event Processing 1-13 Oracle GoldenGate Commands 1-13 To Start GGSCI 1-13 2 Planning the Configuration Planning Overview 2-1 Configuring TMF-Enabled Processing 2-2 Adding Columns to a Source Table 2-2 Ensuring All Audit is Processed 2-2 Keeping Necessary Audit Available for Extract 2-3 Ensuring TMF Cannot Purge Audit 2-3 Copying the Audit to an Alternative Location 2-3 Using Tape Dumps as an Alternative Location 2-3 Minimizing Vulnerability to Outages 2-4 Configuring FUP RELOAD Activity 2-4 Data Compression 2-4 Compressed Enscribe Records 2-5 Compressed SQL Records 2-5 DCOMPRESS File Attribute Not Supported 2-6 AUDITCOMPRESS File Attribute Considerations 2-6 Configuring for Distributed Network Transactions 2-6 Re-configuring TMF 2-9 Configuring Non-TMF-Enabled Processing 2-9 Maintaining Data Integrity 2-9 Supported File Types and Operations 2-10 Authentication for Bound Programs 2-11 System Utilities That Update Databases 2-11 Private Memory and Stack Space 2-11 Impact on Existing Application Performance 2-11 Configuring Oracle Goldengate Global Operations 2-12 GLOBALS Parameter File 2-12 Changing the Default Location of AUDCFG 2-12 Configuring Replication 2-12 Replicating SQL Tables with System Keys 2-13 Replicating Primary Key Updates 2-13 Missing Row Errors 2-13 Non-Audited Target 2-14 iv Compressed Updates to Enscribe Targets 2-14 Files and Tables Other Than Key-Sequenced 2-14 Load Balancing and Performance Issues 2-15 Potential Problems with Audit Compressed Files 2-15 Conflicts with Updating the Target 2-16 Many-to-One Replication 2-16 Bi-Directional Replication 2-16 Replicating Data to Non-TMF Enabled Databases 2-17 Replicating New SQL Columns 2-17 Configuring for Maximum Throughput 2-17 Extraction 2-18 TMF Extraction 2-18 Non-TMF Data Extraction 2-18 Replication 2-18 Latency Issues 2-18 Capacity Planning 2-19 TMF Data Extraction 2-19 Non-TMF Data Extraction 2-19 Data Transfer into Oracle GoldenGate Trails 2-19 Replicat Throughput 2-19 Changing Default Component Names 2-19 Using Wildcards 2-20 Support for DDL and DDL2 2-21 Specifying Internet Protocol Addresses 2-21 3 Configuring Initial Data Synchronization Initial Data Synchronization 3-1 Example Steps for Initial Data Load 3-2 Configure and Run Extract 3-2 Perform Initial Load Using the File to Replicat Method 3-2 Configure and Run Replicat 3-3 Direct Load 3-3 To run direct load: 3-3 Using Wildcards 3-5 Direct Bulk Load 3-5 To run direct bulk load: 3-5 Synchronizing Nonstop Databases Using Database Utilities Through TCP/IP 3-6 Controlling the IP Process for Replicat 3-7 Loading Oracle, Microsoft, or Sybase SQL Server Tables 3-7 Loading to Oracle or SQL Server 3-8 v Initial Sync Parameter File Examples 3-8 Sample NonStop to Oracle Parameter Files 3-9 Sample SQL Server Parameter Files 3-9 Limiting the Enscribe Source Key Range for Initial Load 3-10 Restarting an Initial Load 3-10 Loading Initial Data from Windows and Unix 3-11 Integrating Source and Target Data 3-11 Distributing Extracted Data 3-12 Direct File Extraction 3-12 Batch Processing 3-13 One-Time Database Extraction 3-13 Trickle Batch Processing 3-13 Determining the Next File 3-14 When the Next File is Processed 3-14 4 Configuring Oracle GoldenGate Security Using Encryption 4-1 How Data is Encrypted 4-1 Encrypting Trail or Extract Files 4-2 Encrypting a Database Password 4-2 Encrypting Data Sent Across TCP/IP 4-3 Generating Encryption Keys 4-4 Using Command Security 4-5 Securing the CMDSEC File 4-7 5 Configuring the Manager and Collector Introducing Manager 5-1 Configuring and Starting Manager 5-1 Creating and Configuring the Manager Parameter File 5-2 A Sample Manager Parameter File 5-2 Starting and Stopping Manager 5-3 Configuring and Running the Collector 5-3 Maintaining Ports for Remote Connections through Firewalls 5-4 Configuring Collector 5-4 Configuration Examples 5-5 The TCP/IP Port 5-6 Dynamic Method 5-6 Explicit Method 5-6 Monitoring Collector 5-7 vi Security Considerations 5-7 Collecting Between Open Systems and NonStop 5-7 6 Configuring Change Synchronization Introduction 6-1 Change Synchronization for TMF Applications 6-1 Configuring Extract 6-1 Configuring Trails 6-2 Configuring Replicat 6-2 Change Synchronization for Non-TMF Applications 6-3 Creating the LOGPARM File 6-4 Sample LOGPARM File 6-4 Configuring Logger and GGSLIB 6-6 Starting Logger 6-6 Using Macros to Bind GGSLIB to a Non-TMF Application 6-6 Building GGSLIB 6-6 Private Memory and Stack Space 6-7 Alternate Methods of Binding GGSLIB to an Application 6-7 Using the ?Search Directive 6-8 Non-Native Environments 6-8 Native Mode Itanium Systems 6-8 Libraries for Native Applications 6-8 Running NLDLIB 6-9 Removing a Library 6-9 Activating Authorization of Bound Libraries 6-10 Managing the Authorization Event 6-11 Adding and Verifying the Authorization Event 6-11 Using Different PARAM-TEXT Options 6-12 Getting the Current Status of the Authorization Event 6-12 Working with Parameter Files 6-13 Creating a Parameter File 6-14 Storing Parameter Files 6-16 Viewing a Parameter File 6-16 Changing a Parameter File 6-17 Using