Oracle® GoldenGate Application Adapters

Upgrading Oracle GoldenGate Adapters

12c (12.1.2.1.1)

E61860-01

May 2015

This document provides information on how to upgrade an existing Oracle GoldenGate Adapter.

This document contains the following sections:

- Upgrading Overview

- Upgrading User Exits

- Upgrading JMS Capture

- Release Level Special Instructions

- Documentation Accessibility

1 Upgrading Overview

There are two types of upgrades for the Oracle GoldenGate Java Adapters:

- An adapter that is receiving changes captured from a source database and written to an Oracle GoldenGate trail.

- An adapter that is receiving changes from a JMS source

The upgrade steps are different for each of these.

2 Upgrading User Exits

These sections explain the steps you need to follow for each of the types of upgrades.

2.1 Upgrading Source Database Capture

If the adapter is receiving trail data from a source database, use the following upgrade steps:

1. Create an installation directory that has no spaces in its name.

2. Extract the zip file into this new installation directory. This will download the files into several subdirectories.

3. Still on the installation directory, bring up GGSCI to create the remaining subdirectories in the installation location.

Shell> ggsci
GGSCI> CREATE SUBDIRS

4. Copy all of the dirprm files from your existing installation into the dirprm directory in the new installation location.

Note:
All of your configuration files must be in the dirprm directory. If you have property files, Velocity templates, or other configuration files in a location other than dirprm in your old installation, copy them to the dirprm directory in the new installation.

5. Copy all of the dirdef files from your existing installation into the dirdef directory in the new installation location.

6. If you have additional jar files or other custom files in your old installation, copy them to the new installation directory.

7. Configure the Extract pump processes in the new installation directory by bringing up GGSCI and adding the Extracts and naming the trails.

GGSCI> ADD EXTRACT group_name, EXTTRAILSOURCE trail_name, . . .

8. Start the Extract processes and verify that they are running:

GGSCI> START EXTRACT group_name
GGSCI> INFO EXTRACT group_name
GGSCI> VIEW REPORT group_name

9. Modify the source system to write to the new Oracle GoldenGate Adapter installation directory:

- (Optional) Upgrade the source database Oracle GoldenGate capture following the upgrade procedure for your database platform.

- Configure the source database capture to write to the new Oracle GoldenGate Adapter installation location dirdat directory.

- When the old Oracle GoldenGate Adapter installation has processed all its data, switch over to the process that will send data to the new location.

3 Upgrading JMS Capture

If your adapter is capturing changes from a JMS source, use the following steps to upgrade the installation.

1. Create an installation directory that has no spaces in its name.

2. Extract the zip file into this new installation directory. This will download the files into several subdirectories.

3. Still on the installation directory, bring up GGSCI to create the remaining subdirectories in the installation location.

Shell> ggsci
GGSCI> CREATE SUBDIRS

4. Copy all of the dirprm files from your existing installation into the dirprm directory in the new installation location.

5. Copy all of the dirdef files from your existing installation into the dirdef directory in the new installation location.

6. If you have additional jar files or other custom files in your old installation, copy them to the new installation directory.

7. Configure the Extract processes in the new installation directory to write to a new trail by bringing up GGSCI and adding the Extracts and naming the trails.

GGSCI> ADD EXTRACT group_name, EXTTRAILSOURCE trail_name, . . .

8. Stop the old Extract from the previous version.

GGSCI> STOP EXTRACT old_name

9. Start the new Extract processes and verify that they are running:

GGSCI> START EXTRACT group_name
GGSCI> INFO EXTRACT group_name
GGSCI> VIEW REPORT group_name

10. When the old Oracle GoldenGate Adapter installation has processed all its data, configure the downstream processes to read from the new trails generated by the upgraded JMS capture process.

4 Release Level Special Instructions

This section covers special instructions for upgrading to certain release numbers.

4.1 Upgrading to 12.1.2.1.0

This section covers special instructions to be followed when upgrading to Oracle GoldenGate Adapters release 12.1.2.1.0.

4.1.1 Creating the Logging Configuration

When upgrading to Oracle GoldenGate Adapters release 12.1.2.1.0 from release 11.1.0 or later, the previous logging configuration will use files stored in the ggjava directory. For example, logging property files may be found in ggjava/resources/classes. In 12.1.2, these files may have changed, moved, or may no longer exist.

To upgrade the logging configuration:

- Navigate to the newly installed AdapterExamples directory

- Locate the example logging configuration file

- Copy the example file to the dirprm directory

- Customize the logging configuration as needed

5 Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Upgrading Oracle GoldenGate Adapters, 12c (12.1.2.1.1) for Adobe FrameMaker 7.2 on Windows

E61860-01

Copyright © 2015, 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, 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.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2016, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

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.

Warranty Disclaimer

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.

Restricted Rights Notice

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.

Hazardous Applications Notice

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.

Trademark Notice

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.

Third-Party Content, Products, and Services Disclaimer

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.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Alpha and Beta Draft Documentation Notice

If this document is in private preproduction status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your beta trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.