Oracle® Fusion MiddlewareInstalling Oracle GoldenGate Studio

12c (12.2.1.4.0)E95156-01September 2019

Oracle Fusion Middleware Installing Oracle GoldenGate Studio, 12c (12.2.1.4.0)

E95156-01

Copyright © 2016, 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 Preparing to Install Oracle GoldenGate Studio

Roadmap for Installing Oracle GoldenGate Studio 1-1

Roadmap for Verifying Your System Environment 1-2

Verifying Certification, System, and Interoperability Requirements 1-3

Selecting an Installation User 1-4

About User Permissions 1-4

About Non-Default User Permissions on UNIX Operating Systems 1-5

Verifying that the Installation User has Administrator Privileges on WindowsOperating Systems 1-5

About the Oracle Home Directory 1-6

About JDK Requirements for an Oracle Fusion Middleware Installation 1-7

About Database Requirements for an Oracle Fusion Middleware Installation 1-7

Obtaining the Product Distribution 1-8

2 Installing the Oracle GoldenGate Studio Software

Verifying the Installation Checklist 2-1

Starting the Installation Program 2-2

Navigating the Installation Screens 2-3

Verifying the Installation 2-4

Reviewing the Installation Log Files 2-5

Checking the Directory Structure 2-5

Viewing the Contents of the Oracle Home 2-5

3 Creating the Oracle GoldenGate Studio Repository Schema

Installing and Configuring a Certified Database 3-1

Starting the Repository Creation Utility 3-1

Navigating the Repository Creation Utility Screens to Create Schemas 3-2

Introducing the RCU 3-2

Selecting a Method of Schema Creation 3-3

Providing Database Connection Details 3-3

iii

Specifying a Custom Prefix and Selecting the Oracle GoldenGate RepositorySchema 3-4

Specifying Schema Passwords 3-4

Specifying Custom Variables 3-4

Completing Schema Creation 3-5

Verifying the Installation 3-5

4 Next Steps After Installing Oracle GoldenGate Studio

Setting the User Home Directory 4-1

Starting Oracle GoldenGate Studio 4-2

Performing additional tasks with the Oracle GoldenGate Studio 4-2

5 Uninstalling or Reinstalling Oracle GoldenGate Studio

About Product Deinstallation 5-2

Stopping Oracle Fusion Middleware 5-2

Removing Your Database Schemas 5-2

Uninstalling the Software 5-3

Starting the Uninstall Wizard 5-3

Selecting the Product to Uninstall 5-3

Navigating the Uninstall Wizard Screens 5-4

Removing the Oracle Home Directory Manually 5-4

Removing the Program Shortcuts on Windows Operating Systems 5-4

Removing the Oracle GoldenGate Studio Cache Directory 5-5

Reinstalling the Software 5-5

Performing a Clean Reinstall on the Same System as a Previous Installation 5-6

A Updating the JDK After Installing and Configuring an Oracle FusionMiddleware Product

About Updating the JDK Location After Installing an Oracle Fusion MiddlewareProduct A-1

Updating the JDK Location in an Existing Oracle Home A-2

Updating the JDK Location in an Existing Domain Home A-3

Updating the JDK in an Existing OGGSTUDIO Home A-3

iv

Abstract

Documentation for installers and system administrators that describes how to installand configure Oracle GoldenGate Studio.

5

Preface

This document describes how to install and configure Oracle GoldenGate Studio.

• Audience

• Documentation Accessibility

• Related Documents

• Conventions

AudienceThis guide is intended for system administrators or application developers who areinstalling and configuring Oracle GoldenGate Studio. It is assumed that readers arefamiliar with web technologies and have a general understanding of Windows andUNIX platforms.

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

Accessible Access to Oracle Support

Oracle customers who have purchased support have access to electronic supportthrough 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.

Related DocumentsRefer to the Oracle Fusion Middleware Library for additional information.

• For installation information, see Fusion Middleware Installation Documentation.

• For upgrade information, see Fusion Middleware Upgrade Documentation.

• For administration-related information, see Fusion Middleware AdministrationDocumentation.

• For release-related information, see Fusion Middleware Release Notes.

ConventionsThe following text conventions are used in this document:

Convention Meaning

boldface Boldface type indicates graphical user interface elements associatedwith an action, or terms defined in text or the glossary.

Audience

6

Convention Meaning

italic Italic type indicates book titles, emphasis, or placeholder variables forwhich you supply particular values.

monospace Monospace type indicates commands within a paragraph, URLs, codein examples, text that appears on the screen, or text that you enter.

Conventions

7

1Preparing to Install Oracle GoldenGateStudio

To prepare for your Oracle GoldenGate Studio installation, verify that your systemmeets the basic requirements to obtain the correct installation software.

You can obtain the correct installation software from https://www.oracle.com/technetwork/middleware/goldengate/downloads/index.html

• Roadmap for Installing Oracle GoldenGate StudioThis roadmap provides the steps required to install Oracle GoldenGate Studio,such as verifying your environment, running the installer, creating the Repositoryschema, and starting Oracle GoldenGate Studio after installation.

• Roadmap for Verifying Your System EnvironmentBefore you begin the installation process, read and understand the importantinformation in this roadmap. It identifies important tasks and checks to perform toensure that your environment is properly prepared for installing OracleGoldenGate Studio.

• Obtaining the Product DistributionYou can obtain the Oracle Fusion Middleware Infrastructure and OracleGoldenGate Studio distribution on the Oracle Technology Network (OTN).

Roadmap for Installing Oracle GoldenGate StudioThis roadmap provides the steps required to install Oracle GoldenGate Studio, suchas verifying your environment, running the installer, creating the Repository schema,and starting Oracle GoldenGate Studio after installation.

The following table provides the high-level steps required for installing OracleGoldenGate Studio:

Table 1-1 Standard Installation Roadmap

Task Description Documentation

Verify your systemenvironment.

Before beginning the installation,verify that the minimum systemand network requirements are met.

See Roadmap for Verifying Your System Environment.

Check for anymandatory patchesthat will be requiredbefore or after theinstallation.

Review the Oracle FusionMiddleware Infrastructure releasenotes to see if there are anymandatory patches required for thesoftware products you areinstalling.

See Install and Configure in Release Notes for OracleFusion Middleware Infrastructure.

Obtain theappropriatedistribution.

Obtain the Oracle GoldenGateStudio distribution.

See Obtaining the Product Distribution.

1-1

Table 1-1 (Cont.) Standard Installation Roadmap

Task Description Documentation

Determine yourinstallationdirectories.

Verify that the installer can accessor create the installer directoriesthat it must access or create. Also,verify that the directories exist onsystems that meet the minimumrequirements.

Note: Oracle does not recommendinstalling the Oracle GoldenGateStudio binaries on an NFS-mounted file system.

See What are the Key Oracle Fusion MiddlewareDirectories? in Oracle Fusion MiddlewareUnderstanding Oracle Fusion Middleware.

Install the software. Run the Oracle Universal Installerto install Oracle GoldenGateStudio.

Installing the software transfers thesoftware to your system andcreates the Oracle home directory.

See Installing the Oracle GoldenGate Studio Software.

Note:

Oracle GoldenGate Studiois a Standalone Software.You do not have to installthe Infrastructure Softwareas a prerequisite.

Create the OracleGoldenGate StudioRepository schema.

Run the Repository Creation Utilityto create the Oracle GoldenGateStudio Repository schema.

See Creating the Oracle GoldenGate Studio RepositorySchema.

Start and useOracle GoldenGateStudio.

Discover additional tools andresources to use OracleGoldenGate Studio.

See Next Steps After Installing Oracle GoldenGateStudio.

Roadmap for Verifying Your System EnvironmentBefore you begin the installation process, read and understand the importantinformation in this roadmap. It identifies important tasks and checks to perform toensure that your environment is properly prepared for installing Oracle GoldenGateStudio.

The following table identifies important tasks and checks to perform to ensure thatyour environment is prepared for installing Oracle GoldenGate Studio.

Table 1-2 Roadmap for Verifying Your System Environment

Task Description Documentation

Verify certification andsystem requirements.

Verify that your operating system is certifiedand properly configured for installation andconfiguration.

See Verifying Certification, System,and Interoperability Requirements.

Identify a proper installationuser.

Verify that the installation user has therequired permissions to install the software.

See Selecting an Installation User.

Chapter 1Roadmap for Verifying Your System Environment

1-2

Table 1-2 (Cont.) Roadmap for Verifying Your System Environment

Task Description Documentation

Select the Oracle homedirectory on your system.

Verify that you can create the necessaryOracle home directory for installation,according to the recommended directorystructure.

Oracle GoldenGate Studio is a standaloneinstallation. The Oracle home directoryshould be a new, empty directory.

See About the Oracle HomeDirectory.

Install a certified JDK. The installation program for the distributionrequires a certified JDK present on yoursystem.

See About JDK Requirements for anOracle Fusion MiddlewareInstallation.

Install and configure adatabase for mid-tierschemas.

You must have access to a certifieddatabase that is properly configured for theRepository schema required by OracleGoldenGate Studio.

See About Database Requirementsfor an Oracle Fusion MiddlewareInstallation.

• Verifying Certification, System, and Interoperability RequirementsOracle recommends that you use the certification matrix and system requirementsdocuments with each other to verify that your environment meets the requirementsfor installation.

• Selecting an Installation UserThe user who installs and configures your system must have the requiredpermissions and privileges.

• About the Oracle Home DirectoryWhen you install any Oracle Fusion Middleware product, you must use an Oraclehome directory.

• About JDK Requirements for an Oracle Fusion Middleware InstallationMost Fusion Middleware products are in .jar file format. These distributions donot include a JDK. To run a .jar distribution installer, you must have a certifiedJDK installed on your system.

• About Database Requirements for an Oracle Fusion Middleware InstallationMany Oracle Fusion Middleware products require database schemas prior toconfiguration. If you do not already have a database where you can install theseschemas, you must install and configure a certified database.

Verifying Certification, System, and Interoperability RequirementsOracle recommends that you use the certification matrix and system requirementsdocuments with each other to verify that your environment meets the requirements forinstallation.

1. Verifying that your environment meets certification requirements:

Make sure that you install your product on a supported hardware and softwareconfiguration. See the certification document for your release on the Oracle FusionMiddleware Supported System Configurations page.

Oracle has tested and verified the performance of your product on all certifiedsystems and environments. Whenever new certifications are released, they areadded to the certification document right away. New certifications can be released

Chapter 1Roadmap for Verifying Your System Environment

1-3

at any time. Therefore, the certification documents are kept outside thedocumentation libraries and are available on Oracle Technology Network.

2. Using the system requirements document to verify certification:

Oracle recommends that you use the Oracle Fusion Middleware SystemRequirements and Specifications document to verify that the certificationrequirements are met. For example, if the certification document indicates thatyour product is certified for installation on 64-Bit Oracle Linux 6.5, use thisdocument to verify that your system meets the required minimum specifications.These include disk space, available memory, specific platform packages andpatches, and other operating system-specific requirements. System requirementscan change in the future. Therefore, the system requirement documents are keptoutside of the documentation libraries and are available on Oracle TechnologyNetwork.

3. Verifying interoperability among multiple products:

To learn how to install and run multiple Fusion Middleware products from the samerelease or mixed releases with each other, see Oracle Fusion Middleware 12cInteroperability and Compatibility in Oracle Fusion Middleware UnderstandingInteroperability and Compatibility.

Selecting an Installation UserThe user who installs and configures your system must have the required permissionsand privileges.

• About User PermissionsThe user who installs a Fusion Middleware product owns the files and has certainpermissions on the files.

• About Non-Default User Permissions on UNIX Operating SystemsChanging the default permission setting reduces the security of the installation andyour system. Oracle does not recommend that change the default permissionsettings.

• Verifying that the Installation User has Administrator Privileges on WindowsOperating SystemsTo update the Windows Registry, you must have administrator privileges.

About User PermissionsThe user who installs a Fusion Middleware product owns the files and has certainpermissions on the files.

The user who installs a Fusion Middleware product has the following permissions onthem:

• Read and write permissions on all non-executable files (forexample, .jar, .properties, or .xml). All other users in the same group as the fileowner have read permissions only.

• Read, write, and execute permissions on all executable files (forexample, .exe, .sh, or .cmd). All other users in the same group as the file ownerhave read and execute permissions only.

Chapter 1Roadmap for Verifying Your System Environment

1-4

This means that someone other than the person who installs the software can use theinstalled binaries in the Oracle home to configure a domain or set of FusionMiddleware products.

Below are some additional considerations to make prior to running the installer:

• On UNIX operating systems, Oracle recommends that you set the umask to 027 onyour system prior to installation. This ensures that file permissions are set properlyduring installation. Use the following command:

umask 027

You must enter this command in the same terminal window from which you plan torun the product installer.

• On UNIX operating systems, do not run the installation program as the root user.The installer startup validation will fail and you will not be able to continue.

• When managing a product installation (for example, applying patches), you mustuse the same user ID as was used to perform the initial product installation.

• On Windows operating systems, the user performing the installation must haveAdministrator privileges. See Verifying the Installation User has AdministratorPrivileges on Windows Operating Systems.

About Non-Default User Permissions on UNIX Operating SystemsChanging the default permission setting reduces the security of the installation andyour system. Oracle does not recommend that change the default permission settings.

If other users require access to a particular file or executable, use the UNIX sudocommand or other similar commands to change the file permissions.

Refer to your UNIX operating system Administrator's Guide or contact your operatingsystem vendor, if you need further assistance.

Verifying that the Installation User has Administrator Privileges on WindowsOperating Systems

To update the Windows Registry, you must have administrator privileges.

By default, users with the administrator privilege sign in to the system with regularprivileges, but can request elevated permissions to perform administrative tasks.

To perform a task with elevated privileges:

1. Find the Command Prompt icon, either from the Start menu or the Windows iconin the lower-left corner.

2. Right-click Command Prompt and select Run as administrator.

This opens a new command prompt window, and all actions performed in thiswindow are done with administrator privileges.

Chapter 1Roadmap for Verifying Your System Environment

1-5

Note:

If you have User Access Control enabled on your system, you may seean additional window asking you to confirm this action. Confirm andcontinue with this procedure.

3. Perform the desired task.

For example, to start the product installer:

For a jar file, enter:

java —jar distribution_name.jar

For an executable (.exe, .bin, or .sh file), enter:

distribution_name.exe

About the Oracle Home DirectoryWhen you install any Oracle Fusion Middleware product, you must use an Oraclehome directory.

This directory is a repository for common files that are used by multiple FusionMiddleware products installed on the same machine. These files ensure that FusionMiddleware operates correctly on your system. They facilitate checking of cross-product dependencies during installation. For this reason, you can consider the Oraclehome directory a central support directory for all Oracle Fusion Middleware productsinstalled on your system.

Fusion Middleware documentation refers to the Oracle home directory asORACLE_HOME.

Oracle Home Considerations

Keep the following in mind when you create the Oracle home directory and install theOracle Fusion Middleware products:

• Do not include spaces in the name of your Oracle home directory; the installerdisplays an error message if your Oracle home directory path contains spaces.

• You can install only one instance of each Oracle Fusion Middleware product in asingle Oracle home directory. If you need to maintain separate versions of aproduct on the same machine, each version must be in its own Oracle homedirectory.

Although you can have several different products in a single Oracle home, onlyone version of each product can be in the Oracle home.

Multiple Home Directories

Although in most situations, a single Oracle home directory is sufficient, it is possibleto create more than one Oracle home directory. For example, you need to maintainmultiple Oracle home directories in the following situations:

• You prefer to maintain separate development and production environments, with aseparate product stack for each. With two directories, you can update yourdevelopment environment without modifying the production environment until youare ready to do so.

Chapter 1Roadmap for Verifying Your System Environment

1-6

• You want to maintain two different versions of a Fusion Middleware product at thesame time. For example, you want to install a new version of a product whilekeeping your existing version intact. In this case, you must install each productversion in its own Oracle home directory.

• You need to install multiple products that are not compatible with each other. See Oracle Fusion Middleware 12c (12.2.1.4.0) Interoperability and Compatibility inOracle Fusion Middleware Understanding Interoperability and Compatibility .

Note:

If you create more than one Oracle home directory, you must provide non-overlapping port ranges during the configuration phase for each product.

About JDK Requirements for an Oracle Fusion Middleware InstallationMost Fusion Middleware products are in .jar file format. These distributions do notinclude a JDK. To run a .jar distribution installer, you must have a certified JDKinstalled on your system.

Make sure that the JDK is installed outside of the Oracle home. If you install the JDKunder the Oracle home, you may encounter problems when you try to perform tasks inthe future. Oracle Universal Installer validates that the Oracle home directory is empty;the install does not progress until you specify an empty directory. Oracle recommendsthat you locate your JDK installation in the /home/oracle/products/jdk directory.

Platform-specific distributions have a .bin (for UNIX operating systems) or .exe (forWindows operating systems) installer; in these cases, a platform-specific JDK is in thedistribution and you do not need to install a JDK separately. However, you may needto upgrade this JDK to a more recent version, depending on the JDK versions that arecertified.

Always verify the required JDK version by reviewing the certification information on the Oracle Fusion Middleware Supported System Configurations page. For 12c(12.2.1.4.0), the certified JDK is 1.8.0_211 and later.

To download the required JDK, navigate to the following URL and download the JavaSE JDK:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

About Database Requirements for an Oracle Fusion MiddlewareInstallation

Many Oracle Fusion Middleware products require database schemas prior toconfiguration. If you do not already have a database where you can install theseschemas, you must install and configure a certified database.

To find a certified database for your operating system, see the certification documentfor your release on the Oracle Fusion Middleware Supported System Configurationspage on the Oracle Technology Network (OTN).

Chapter 1Roadmap for Verifying Your System Environment

1-7

To make sure that your database is properly configured for schema creation, seeRepository Creation Utility Requirements in the Oracle Fusion Middleware SystemRequirements and Specifications document.

After your database is properly configured, you use the Repository Creation Utility(RCU) to create product schemas in your database. This tool is available in the Oraclehome for your Oracle Fusion Middleware product. See About the Repository CreationUtility in Oracle Fusion Middleware Creating Schemas with the Repository CreationUtility.

Obtaining the Product DistributionYou can obtain the Oracle Fusion Middleware Infrastructure and Oracle GoldenGateStudio distribution on the Oracle Technology Network (OTN).

To prepare to install Oracle Fusion Middleware Infrastructure and Oracle GoldenGateStudio:

1. Enter java -version on the command line to verify that a certified JDK is installedon your system. For 12c (12.2.1.4.0), the certified JDK is 1.8.0_211 and later.

See About JDK Requirements for an Oracle Fusion Middleware Installation.

2. Locate and download the Oracle Fusion Middleware Infrastructure and OracleGoldenGate Studio software.

See Obtaining Product Distributions in Oracle Fusion Middleware Planning anInstallation of Oracle Fusion Middleware.

Chapter 1Obtaining the Product Distribution

1-8

2Installing the Oracle GoldenGate StudioSoftware

Follow these step to install the Oracle GoldenGate Studio software and verify that it isinstalled properly.Before beginning the installation, ensure that you have verified your systemenvironment as mentioned in the Roadmap.

• Verifying the Installation ChecklistThe installation process requires specific information from you.

• Starting the Installation ProgramBefore running the installation program, you must verify the JDK and prerequisitesoftware is installed.

• Navigating the Installation ScreensThe installer shows a series of screens where you verify or enter information aboutyour installation.

• Verifying the InstallationAfter you complete the installation, verify whether it was successful by completinga series of tasks.

Verifying the Installation ChecklistThe installation process requires specific information from you.

Table 2-1 lists important items that you must know before, or decide during, OracleGoldenGate Studio installation.

Table 2-1 Installation Checklist

Information Example Value Description

JAVA_HOME /home/Oracle/Java/jdk1.8.0_211

Environment variable thatpoints to the Java JDK homedirectory.

Database host examplehost.exampledomain

Name and domain of the hostwhere the database isrunning.

Database port 1521 Port number that the databaselistens on. The default Oracledatabase listen port is 1521.

Database service name orcl.oracle.com Oracle databases require aunique service name. Thedefault service name is orcl.

2-1

Table 2-1 (Cont.) Installation Checklist

Information Example Value Description

DBA user name SYS Name of user with databaseadministration privileges. Thedefault DBA user on Oracledatabases is SYS.

DBA password ExamplePassword1 Password of the user withdatabase administrationprivileges.

ORACLE_HOME /home/Oracle/product/Oracle_Home

Directory you will install yoursoftware in.

This directory will includeOracle GoldenGate Studio.

RCU utility ORACLE_HOME/oracle_common/bin

Path to the RepositoryCreation Utility (RCU).

RCU schema prefix DEV Prefix for names of databaseschema used by OracleGoldenGate Studio.

RCU schema password ExamplePassword1 Password for the databaseschema used by OracleGoldenGate Studio.

Starting the Installation ProgramBefore running the installation program, you must verify the JDK and prerequisitesoftware is installed.

To start the installation program:

1. Sign in to the host system.

2. Change to the directory where you downloaded the installation program.

3. You must have installed the Oracle Fusion Middleware Infrastructure 12c(12.2.1.4.0). For instructions, see Installing the Infrastructure Software in OracleFusion Middleware Installing and Configuring the Oracle Fusion MiddlewareInfrastructure.

4. Start the installation program by running the java executable from the JDKdirectory. For example:

• (UNIX) /home/Oracle/Java/jdk1.8.0_211/bin/java -jarfmw_12.2.1.4.0_oggstudio.jar

• (Windows) C:\home\Oracle\Java\jdk1.8.0_211\bin\java -jarfmw_12.2.1.4.0_oggstudio.jar

Chapter 2Starting the Installation Program

2-2

Note:

You can also start the installer in silent mode using a saved response fileinstead of launching the installer screens. For more about silent or commandline installation, see Using the Oracle Universal Installer in Silent Mode inOracle Fusion Middleware Installing Software with the Oracle UniversalInstaller.

When the installation program appears, you are ready to begin the installation.

Navigating the Installation ScreensThe installer shows a series of screens where you verify or enter information aboutyour installation.

The following table lists the order in which installer screens appear. If you needadditional help with an installation screen, click the screen name. You can also clickHelp on the installation screens for additional instructions.

Table 2-2 Oracle GoldenGate Studio Install Screens

Screen Description

Installation Inventory Setup On UNIX operating systems, this screen opens if this is the firsttime you are installing any Oracle product on this host. Specifythe location where you want to create your central inventory.Make sure that the operating system group name selected onthis screen has write permissions to the central inventorylocation.

For more about the central inventory, see About the OracleCentral Inventory in Oracle Fusion Middleware InstallingSoftware with the Oracle Universal Installer.This screen does not appear on Windows operating systems.

Welcome This screen introduces you to the product installer.

Auto Updates Use this screen to search for the latest software updates,including important security updates, via your My Oracle Supportaccount.

Installation Location Use this screen to specify your Oracle home directory location.The Oracle home location you specify on this screen should be anew, empty directory.

You can click View to verify and ensure that you are installingOracle GoldenGate Studio in the correct Oracle home.

For more about Oracle Fusion Middleware directory structure,see About the Directories for Installation and Configuration inOracle Fusion Middleware Planning an Installation of OracleFusion Middleware.

Installation Type Use this screen to select the installation type and consequently,the products and feature sets you want to install. CompleteInstall is the only installation type for Oracle GoldenGate Studio.This option is already selected by default.

Chapter 2Navigating the Installation Screens

2-3

Table 2-2 (Cont.) Oracle GoldenGate Studio Install Screens

Screen Description

Prerequisite Checks This screen verifies that your system meets the minimumnecessary requirements.

To view the list of tasks that gets verified, select ViewSuccessful Tasks. To view log details, select View Log.

If any prerequisite check fails, then an error message appears atthe bottom of the screen. Fix the error and click Rerun to tryagain. To ignore the error or the warning message and continuewith the installation, click Skip (not recommended).

If there are warning or error messages, see one of thedocuments in Roadmap for Verifying Your System Environment.

Installation Summary Use this screen to verify the installation options you selected. Ifyou want to save these options to a response file, click SaveResponse File and enter the response file location and name.You can use response files later if you perform a silentinstallation.

All feature sets that are installed after installation is complete arelisted here.

For more about silent or command line installation, see Usingthe Oracle Universal Installer in Silent Mode in Oracle FusionMiddleware Installing Software with the Oracle UniversalInstaller.Click Install to begin the installation.

Installation Progress This screen displays the installation progress.

When the progress bar reaches 100% complete, click Finish todismiss the installer or click Next to see a summary.

Installation Complete This screen displays the Installation Location and the FeatureSets that are installed. Review this information and click Finishto close the installer.

After installing the software, you should be able to start Oracle GoldenGate Studiofrom the ORACLE_HOME/oggstudio/bin directory. However, at this point, you cannotuse the product. You must first create the required schemas by using the RepositoryCreation Utility (RCU).

Verifying the InstallationAfter you complete the installation, verify whether it was successful by completing aseries of tasks.

• Reviewing the Installation Log FilesReview the contents of the installation log files to make sure that the installer didnot encounter any problems.

• Checking the Directory StructureThe contents of your installation vary based on the options that you selectedduring the installation.

• Viewing the Contents of the Oracle HomeYou can view the contents of the Oracle home directory by using theviewInventory script.

Chapter 2Verifying the Installation

2-4

Reviewing the Installation Log FilesReview the contents of the installation log files to make sure that the installer did notencounter any problems.

By default, the installer writes logs files to the Oracle_Inventory_Location/logs (onUNIX operating systems) or Oracle_Inventory_Location\logs (on Windowsoperating systems) directory.

For a description of the log files and where to find them, see Installation Log Files inOracle Fusion Middleware Installing Software with the Oracle Universal Installer.

Checking the Directory StructureThe contents of your installation vary based on the options that you selected duringthe installation.

See What Are the Key Oracle Fusion Middleware Directories? in Oracle FusionMiddleware Understanding Oracle Fusion Middleware.

Viewing the Contents of the Oracle HomeYou can view the contents of the Oracle home directory by using the viewInventoryscript.

See Viewing the Contents of an Oracle Home in Oracle Fusion Middleware InstallingSoftware with the Oracle Universal Installer.

Chapter 2Verifying the Installation

2-5

3Creating the Oracle GoldenGate StudioRepository Schema

The repository for Oracle GoldenGate Studio contains all of the replication design anddeployment details. Therefore, you must install the repository schema on a certifieddatabase before using Oracle GoldenGate Studio. You create the repository using theOracle Repository Creation Utility (RCU).

Before you begin creating the schema, ensure that you have completed installing theOracle GoldenGate Studio software in a new, empty Oracle home as described in Installing the Oracle GoldenGate Studio Software.

Follow the instructions in this section to install the schema:

• Installing and Configuring a Certified DatabaseBefore you create the database schemas, you must install and configure acertified database, and verify that the database is up and running.

• Starting the Repository Creation UtilityStart the Repository Creation Utility (RCU) after you verify that a certified JDK isinstalled on your system.

• Navigating the Repository Creation Utility Screens to Create SchemasEnter required information in the RCU screens to create the database schemas.

• Verifying the InstallationAfter completing the installation steps, verify that Oracle GoldenGate Studio isinstalled properly.

Installing and Configuring a Certified DatabaseBefore you create the database schemas, you must install and configure a certifieddatabase, and verify that the database is up and running.

See About Database Requirements for an Oracle Fusion Middleware Installation.

Starting the Repository Creation UtilityStart the Repository Creation Utility (RCU) after you verify that a certified JDK isinstalled on your system.

To start the RCU:

1. Verify that a certified JDK already exists on your system by running java -version from the command line. For 12c (12.2.1.4.0), the certified JDK is1.8.0_211 and later.

See About JDK Requirements for an Oracle Fusion Middleware Installation.

2. Ensure that the JAVA_HOME environment variable is set to the location of thecertified JDK. For example:

3-1

• (UNIX) setenv JAVA_HOME /home/Oracle/Java/jdk1.8.0_211

• (Windows) set JAVA_HOME=C:\home\Oracle\Java\jdk1.8.0_211

3. Change to the following directory:

• (UNIX) ORACLE_HOME/oracle_common/bin

• (Windows) ORACLE_HOME\oracle_common\bin

4. Enter the following command:

• (UNIX) ./rcu

• (Windows) rcu.bat

Navigating the Repository Creation Utility Screens to CreateSchemas

Enter required information in the RCU screens to create the database schemas.

• Introducing the RCUThe Welcome screen is the first screen that appears when you start the RCU.

• Selecting a Method of Schema CreationUse the Create Repository screen to select a method to create and loadcomponent schemas into the database.

• Providing Database Connection DetailsOn the Database Connection Details screen, provide the database connectiondetails for the RCU to connect to your database.

• Specifying a Custom Prefix and Selecting the Oracle GoldenGate RepositorySchemaOn the Select Components screen, select Create new prefix, specify a customprefix, then select the Oracle GoldenGate - Repository schema.

• Specifying Schema PasswordsOn the Schema Passwords screen, specify how you want to set the schemapasswords on your database, then enter and confirm your passwords.

• Specifying Custom VariablesUse the Custom Variables screen to specify a password for the supervisor userand to select the encryption algorithm for the Oracle GoldenGate StudioRepository schema.

• Completing Schema CreationNavigate through the remaining RCU screens to complete schema creation.

Introducing the RCUThe Welcome screen is the first screen that appears when you start the RCU.

Click Next.

Chapter 3Navigating the Repository Creation Utility Screens to Create Schemas

3-2

Selecting a Method of Schema CreationUse the Create Repository screen to select a method to create and load componentschemas into the database.

On the Create Repository screen:

• If you have the necessary permissions and privileges to perform DBA activities onyour database, select System Load and Product Load. This procedure assumesthat you have SYSDBA privileges.

• If you do not have the necessary permissions or privileges to perform DBAactivities in the database, you must select Prepare Scripts for System Load onthis screen. This option generates a SQL script that you can give to your databaseadministrator. See About System Load and Product Load in Oracle FusionMiddleware Creating Schemas with the Repository Creation Utility.

• If the DBA has already run the SQL script for System Load, select PerformProduct Load.

Providing Database Connection DetailsOn the Database Connection Details screen, provide the database connection detailsfor the RCU to connect to your database.

Note:

If you are unsure of the service name for your database, you can obtain itfrom the SERVICE_NAMES parameter in the initialization parameter file of thedatabase. If the initialization parameter file does not contain theSERVICE_NAMES parameter, then the service name is the same as the globaldatabase name, which is specified in the DB_NAME and DB_DOMAINparameters.

For example:

Database Type: Oracle DatabaseConnection String Format: Connection Parameters or ConnectionString

Connection String: examplehost.exampledomain.com:1521:Orcl.exampledomain.com

Host Name: examplehost.exampledomain.comPort: 1521Service Name: Orcl.exampledomain.comUser Name: sysPassword: ******Role: SYSDBA

Click Next to proceed, then click OK in the dialog window that confirms a successfuldatabase connection.

Chapter 3Navigating the Repository Creation Utility Screens to Create Schemas

3-3

Specifying a Custom Prefix and Selecting the Oracle GoldenGateRepository Schema

On the Select Components screen, select Create new prefix, specify a custom prefix,then select the Oracle GoldenGate - Repository schema.

The schema Common Infrastructure Services is also automatically created. Thisschema is dimmed; you cannot select or deselect it. For more information, see Aboutthe Service Table Schema in Oracle Fusion Middleware Creating Schemas with theRepository Creation Utility.

A custom prefix is required to logically group the schemas together. Note the customprefix that you specify here as you will need it later.

Tip:

For more information about organizing schemas, see Planning Your SchemaCreation in Oracle Fusion Middleware Creating Schemas with the RepositoryCreation Utility.

For more information about custom prefixes, see About Custom Prefixes in OracleFusion Middleware Creating Schemas with the Repository Creation Utility.

Click Next to proceed, then click OK on the dialog window confirming that prerequisitechecking for schema creation was successful.

Specifying Schema PasswordsOn the Schema Passwords screen, specify how you want to set the schemapasswords on your database, then enter and confirm your passwords.

Tip:

You must make a note of the passwords you set on this screen; you willneed them later on when providing your database connection information toconnect to the repository after you start Oracle GoldenGate Studio.

Specifying Custom VariablesUse the Custom Variables screen to specify a password for the supervisor user and toselect the encryption algorithm for the Oracle GoldenGate Studio Repository schema.

The custom variables for Oracle GoldenGate Studio are described in the followingtable:

Chapter 3Navigating the Repository Creation Utility Screens to Create Schemas

3-4

Variable Description

Supervisor Password Password of the supervisor user. You must confirm this password on thefollowing line.

You must enter a password for the Supervisor Password and ConfirmSupervisor Password fields. These fields are required before you cancontinue. The password should be between 6 and 12 characters.

Make a note of the password you set on this screen; you will need it later onwhen providing your Oracle GoldenGate Studio connection information toconnect to the repository after you start Oracle GoldenGate Studio.

Encryption Algorithm Select the encryption algorithm, AES-128.

This field is optional. If this field is left blank, the default value is AES-128.

Completing Schema CreationNavigate through the remaining RCU screens to complete schema creation.

On the Map Tablespaces screen, the Encrypt Tablespace check box appears only ifyou enabled Transparent Data Encryption (TDE) in the database (Oracle or OracleEBR) when you start the RCU. Select the Encrypt Tablespace check box if you wantto encrypt all new tablespaces that the RCU creates.

When you reach the Completion Summary screen, click Close to dismiss the RCU.

Verifying the InstallationAfter completing the installation steps, verify that Oracle GoldenGate Studio isinstalled properly.

To verify that Oracle GoldenGate Studio is installed properly, see Performingadditional tasks with the Oracle GoldenGate Studio. You should familiarize yourselfwith the tasks that this section describes and perform them to verify that OracleGoldenGate Studio is installed properly.

Chapter 3Verifying the Installation

3-5

4Next Steps After Installing OracleGoldenGate Studio

After installing the software and creating the repository schema, there are additionaltasks you might want to perform to get started working with Oracle GoldenGate Studio.

• Setting the User Home DirectoryWhen you start Oracle GoldenGate Studio for the first time, a cache directory forGoldenGate Studio is created (unless this directory already exists from a previousinstallation). This directory is used to store binaries and user preferences for theinstallation. If you don’t want this information to be stored at the default location,you must define a custom directory.

• Starting Oracle GoldenGate StudioAfter you install the software and create your Oracle home, you can start andaccess Oracle GoldenGate Studio from the ORACLE_HOME/oggstudio/bindirectory.

• Performing additional tasks with the Oracle GoldenGate StudioTo get started, review these common tasks you will likely want to perform afterinstalling Oracle GoldenGate Studio.

Setting the User Home DirectoryWhen you start Oracle GoldenGate Studio for the first time, a cache directory forGoldenGate Studio is created (unless this directory already exists from a previousinstallation). This directory is used to store binaries and user preferences for theinstallation. If you don’t want this information to be stored at the default location, youmust define a custom directory.

By default, the cache directory is created inside the user home directory:

(Linux) </home/exampleuser/.oggstudio>

(Windows) <C:\Users\exampleuser\AppData\Roaming\oggstudio>

If the default location is not appropriate for your environment, you can set theide.user.dir environment variable on your system to specify your preferred userdirectory path.

For Example, set the following in oggstudio.conf

AddVMOption -Dide.user.dir=PATH

When you launch GoldenGate Studio for the first time, you can verify that the userhome directory has been set to your preferred directory by accessing the Help menu,selecting About from the drop-down menu, selecting the Properties tab, and findingthe definition for ide.user.dir.

4-1

Starting Oracle GoldenGate StudioAfter you install the software and create your Oracle home, you can start and accessOracle GoldenGate Studio from the ORACLE_HOME/oggstudio/bin directory.

To start Oracle GoldenGate Studio:

1. Change to the following directory: ORACLE_HOME/oggstudio/bin .

For example:

cd ORACLE_HOME/oggstudio/bin

2. Run the following command:

(Linux) <./oggstudio>

(Windows) <oggstudioW.exe>

Performing additional tasks with the Oracle GoldenGateStudio

To get started, review these common tasks you will likely want to perform afterinstalling Oracle GoldenGate Studio.

Table 4-1 Basic Tasks for Oracle GoldenGate Studio

Task More Information

Use wizards that provide pre-configured solution anddeployment templates.

See Understanding Solutions in Using OracleGoldenGate Studio.

Develop solutions by dragging and dropping dataservers and replication paths to the solution diagram.

See Working with Solutions and Deployment Profiles inUsing Oracle GoldenGate Studio.

Define physical resources and assign them to yourdeployment profiles.

See Understanding Deployment Profiles in Using OracleGoldenGate Studio.

Create multiple deployment profiles for a single solution.For example, separate profiles for testing and productionteam.

See Understanding Deployment Profiles in Using OracleGoldenGate Studio.

Use Automap or manually map schema, table, andcolumn mappings and assign to replication paths.

See Understanding Mapping Groups in Using OracleGoldenGate Studio.

Reuse mapped groups in multiple replication paths andacross different projects.

See Understanding Mapping Groups in Using OracleGoldenGate Studio.

Add, remove, and fine tune any Oracle GoldenGateoption or parameter.

See Using the Properties Inspector in Using OracleGoldenGate Studio.

Generate parameter files and Oracle GoldenGatecommands. Deploy them online to live OracleGoldenGate instances or save them locally for manualdeployment.

See Understanding Deployment Profiles in Using OracleGoldenGate Studio.

Start, stop, and monitor all physical processes. See Monitoring in Using Oracle GoldenGate Studio.

Monitor your solutions and view deployment historyinformation.

See Understanding Deployment Profiles in Using OracleGoldenGate Studio.

Chapter 4Starting Oracle GoldenGate Studio

4-2

Table 4-1 (Cont.) Basic Tasks for Oracle GoldenGate Studio

Task More Information

Export solutions and mappings to XML files that can beimported by other Oracle GoldenGate Studio users.

See Using the Projects Navigator in Using OracleGoldenGate Studio.

Chapter 4Performing additional tasks with the Oracle GoldenGate Studio

4-3

5Uninstalling or Reinstalling OracleGoldenGate Studio

Follow the instructions in this section to uninstall or reinstall Oracle GoldenGateStudio.

Oracle recommends that you always use the instructions in this section to remove thesoftware. If you try to remove the software manually, you may encounter problemswhen you try to reinstall the software again at a later time. Following the procedures inthis section ensures that the software is properly removed.

• About Product DeinstallationThe Oracle Fusion Middleware deinstaller removes the software from the Oraclehome directory that it starts from.

• Stopping Oracle Fusion MiddlewareBefore running the Uninstall Wizard, Oracle recommends that you stop all serversand processes associated with the Oracle home you are going to remove.

• Removing Your Database SchemasBefore you remove the Oracle home, Oracle recommends that you run RepositoryCreation Utility to remove the GoldenGate Studio Repository schema associatedwith this installation.

• Uninstalling the SoftwareFollow the instructions in this section to start the Uninstall Wizard and remove thesoftware.

• Removing the Oracle Home Directory ManuallyAfter you uninstall the software, you must manually remove your Oracle homedirectory and any existing subdirectories that the Uninstall Wizard did not remove.

• Removing the Program Shortcuts on Windows Operating SystemsOn Windows operating systems, you must also manually remove the programshortcuts; the Deinstallation Wizard does not remove them for you.

• Removing the Oracle GoldenGate Studio Cache DirectoryOracle GoldenGate Studio cache information should be manually removed afteryou deinstall the software but before you begin a new Oracle GoldenGate Studioinstallation on the same system; the deinstaller does not remove this information.

• Reinstalling the SoftwareYou can reinstall your software into the same Oracle home as a previousinstallation only if you uninstalled the software by following the instructions in thissection, including manually removing the Oracle home directory.

• Performing a Clean Reinstall on the Same System as a Previous InstallationIf you uninstall Oracle GoldenGate Studio but don’t remove the cache directoryassociated with the installation, the binaries and preferences stored in thisdirectory will be preserved. If you reinstall the software on the same system as theprevious installation, your new installation will automatically pick up the oldbinaries and preferences.

5-1

About Product DeinstallationThe Oracle Fusion Middleware deinstaller removes the software from the Oracle homedirectory that it starts from.

Table 5-1 summarizes the deinstallation procedure and links to supportingdocumentation.

Table 5-1 Roadmap for Product Deinstallation

Task Description Documentation

Stop Oracle Fusion Middleware. All servers and processes associatedwith the Oracle home should bestopped before running thedeinstaller.

Note that you should disconnect fromthe repository and close OracleGoldenGate Studio.

See Stopping Oracle FusionMiddleware.

Drop your database schemas. Run Repository Creation Utility toremove the GoldenGate StudioRepository schema.

See Removing Your DatabaseSchemas.

Remove the software. Run the product deinstaller toremove Oracle GoldenGate Studio.

Note that if your Oracle homecontains multiple products, you mustrun the deinstaller multiple times,once for each product.

See Uninstalling the Software.

Remove the Oracle home directory. The deinstaller does not remove allfiles and folders from the Oraclehome directory. After the deinstalleris finished, you must manuallyremove the Oracle home to completeyour product removal.

See Removing the Oracle HomeDirectory Manually.

Stopping Oracle Fusion MiddlewareBefore running the Uninstall Wizard, Oracle recommends that you stop all servers andprocesses associated with the Oracle home you are going to remove.

See Stopping an Oracle Fusion Middleware Environment in Oracle Fusion MiddlewareAdministering Oracle Fusion Middleware.

Removing Your Database SchemasBefore you remove the Oracle home, Oracle recommends that you run RepositoryCreation Utility to remove the GoldenGate Studio Repository schema associated withthis installation.

If there are multiple sets of schemas on your database, be sure to identify the schemaprefix associated with the schema you are removing.

Chapter 5About Product Deinstallation

5-2

To remove the 12c (12.2.1.4.0) GoldenGate Studio Repository schema, use theRepository Creation Utility (RCU) associated with your 12c (12.2.1.4.0) GoldenGateStudio Oracle home. If you use RCU associated with a previous installation to drop the12c (12.2.1.4.0) repository or use RCU associated with your 12c (12.2.1.4.0)installation to drop previous versions of the repository, you might encounter problemswhile running the RCU drop repository operation.

For schema removal steps, see Dropping Schemas in Oracle Fusion MiddlewareCreating Schemas with the Repository Creation Utility.

Uninstalling the SoftwareFollow the instructions in this section to start the Uninstall Wizard and remove thesoftware.

If you want to uninstall the product in a silent (command-line) mode, see Running theOracle Universal Installer for Silent Uninstallation in Oracle Fusion MiddlewareInstalling Software with the Oracle Universal Installer.

• Starting the Uninstall Wizard

• Selecting the Product to Uninstall

• Navigating the Uninstall Wizard Screens

Starting the Uninstall WizardTo start the Uninstall Wizard:

1. Change to the following directory:

(UNIX) ORACLE_HOME/oui/bin

(Windows) ORACLE_HOME\oui\bin

2. Enter the following command:

(UNIX) ./deinstall.sh

(Windows) deinstall.cmd

Selecting the Product to UninstallBecause multiple products might exist in the Oracle home, ensure that you areuninstalling the correct distribution.

After you start the deinstaller, the Distribution to Uninstall screen appears only if morethan one distribution is detected in the Oracle home from where the program isstarted. From the drop-down list, select GG Studio 12.2.1.3.0 and click Uninstall. Thedeinstallation program shows the screens listed in Navigating the Uninstall WizardScreens.

Note:

You will not encounter the Distribution to Uninstall screen if no other softwareis detected in the Oracle home.

Chapter 5Uninstalling the Software

5-3

Navigating the Uninstall Wizard ScreensThe Uninstall Wizard shows a series of screens to confirm the removal of the software.

If you need help on screen listed in Table 5-2, click Help on the screen.

Table 5-2 Uninstall Wizard Screens and Descriptions

Screen Description

Welcome Introduces you to the product Uninstall Wizard.

Uninstall Summary Shows the Oracle home directory and its contents that are uninstalled. Verify that this is thecorrect directory.

If you want to save these options to a response file, click Save Response File and enterthe response file location and name. You can use the response file later to uninstall theproduct in silent (command-line) mode. See Running the Oracle Universal Installer forSilent Uninstall in Installing Software with the Oracle Universal Installer.Click Deinstall, to begin removing the software.

Uninstall Progress Shows the uninstallation progress.

Uninstall Complete Appears when the uninstallation is complete. Review the information on this screen, thenclick Finish to close the Uninstall Wizard.

Removing the Oracle Home Directory ManuallyAfter you uninstall the software, you must manually remove your Oracle homedirectory and any existing subdirectories that the Uninstall Wizard did not remove.

For example, if your Oracle home directory is /home/Oracle/product/ORACLE_HOME on a UNIX operating system, enter the following commands:

cd /home/Oracle/product rm -rf ORACLE_HOME

On a Windows operating system, if your Oracle home directory is C:\Oracle\Product\ORACLE_HOME, use a file manager window and navigate to the C:\Oracle\Productdirectory. Right-click on the ORACLE_HOME folder and select Delete.

Removing the Program Shortcuts on Windows OperatingSystems

On Windows operating systems, you must also manually remove the programshortcuts; the Deinstallation Wizard does not remove them for you.

To remove the program shortcuts on Windows:

1. Change to the following directory: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Oracle\ORACLE_HOME\Product

2. If you only have one product installed in your Oracle home, delete theORACLE_HOME directory. If you have multiple products installed in your Oraclehome, delete all products before you delete the ORACLE_HOME directory.

Chapter 5Removing the Oracle Home Directory Manually

5-4

Removing the Oracle GoldenGate Studio Cache DirectoryOracle GoldenGate Studio cache information should be manually removed after youdeinstall the software but before you begin a new Oracle GoldenGate Studioinstallation on the same system; the deinstaller does not remove this information.

If you didn’t redefine your user home directory (see Setting the User Home Directory),the Oracle GoldenGate Studio cache information is stored in a directory inside theuser’s home directory by default. For example:

(Linux) </home/exampleuser/.oggstudio>

(Windows) <C:\Users\exampleuser\AppData\Roaming\oggstudio>

The binaries and user preferences are stored in this directory.

You must find and remove this directory if you plan to do a clean reinstall of OracleGoldenGate Studio on the same system in the future. If you deinstall OracleGoldenGate Studio but don’t manually remove the cache directory, the binaries storedin this directory are preserved. As a result, if you reinstall the software on the samesystem as the same user, the binaries from your previous installation will be usedunless this directory is manually removed during deinstallation. For more information,see Performing a Clean Reinstall on the Same System as a Previous Installation.

Reinstalling the SoftwareYou can reinstall your software into the same Oracle home as a previous installationonly if you uninstalled the software by following the instructions in this section,including manually removing the Oracle home directory.

When you reinstall, you can then specify the same Oracle home as your previousinstallation.

If ODI is installed again in the same location where it was previously deleted, deletethe entire Oracle Home where it was previously installed.

Consider the following cases where the Oracle home is not empty:

• Installing in an existing Oracle home that contains the same feature sets.

The installer warns you that the Oracle home that you specified during installationalready contains the same software you are trying to install.

• Installing in an existing, non-empty Oracle home.

For example, suppose you chose to create your Domain home or Applicationhome somewhere inside your existing Oracle home. This data is not removedwhen you uninstall a product, so if you try to reinstall into the same Oracle home,the installer does not allow it. Your options are:

– Uninstall your software from the Oracle home (as this section describes) andthen remove the Oracle home directory. After you uninstall the software andremove the Oracle home directory, you can reinstall and reuse the sameOracle home location. Any domain or application data that was in the Oraclehome must be re-created.

– Select a different Oracle home directory.

Chapter 5Removing the Oracle GoldenGate Studio Cache Directory

5-5

Performing a Clean Reinstall on the Same System as aPrevious Installation

If you uninstall Oracle GoldenGate Studio but don’t remove the cache directoryassociated with the installation, the binaries and preferences stored in this directorywill be preserved. If you reinstall the software on the same system as the previousinstallation, your new installation will automatically pick up the old binaries andpreferences.

To do a clean reinstall of the software and to ensure that older binaries (from aprevious installation) in the cache are not used to run GoldenGate Studio, you shouldeither:

• Find and remove the cache directory associated with the previous installation. See Removing the Oracle GoldenGate Studio Cache Directory.

• Use the -clean option when starting Oracle GoldenGate Studio from thecommand line, which forces GoldenGate Studio to pick up the new binaries. Forexample:

Linux <./oggstudio -clean>

Windows <oggstudioW.exe -clean>

Chapter 5Performing a Clean Reinstall on the Same System as a Previous Installation

5-6

AUpdating the JDK After Installing andConfiguring an Oracle Fusion MiddlewareProduct

Consider that you have a JDK version jdk1.8.0_191 installed on your machine. Whenyou install and configure an Oracle Fusion Middleware product, the utilities, such asConfiguration Wizard (config.sh|exe), OPatch, or RCU point to a default JDK, forexample, jdk1.8.0_191. After some time, Oracle releases a new version of the JDK,say jdk1.8.0_211 that carries security enhancements and bug fixes.From 12c (12.2.1.3.0) onwards, you can upgrade the existing JDK to a newer version,and can have the complete product stack point to the newer version of the JDK.

You can maintain multiple versions of JDK and switch to the required version on needbasis.

• About Updating the JDK Location After Installing an Oracle Fusion MiddlewareProductThe binaries and other metadata and utility scripts in the Oracle home and Domainhome, such as RCU or Configuration Wizard, use a JDK version that was usedwhile installing the software and continue to refer to the same version of the JDK.The JDK path is stored in a variable called JAVA_HOME which is centrally locatedin .globalEnv.properties file inside the ORACLE_HOME/oui directory.

About Updating the JDK Location After Installing an OracleFusion Middleware Product

The binaries and other metadata and utility scripts in the Oracle home and Domainhome, such as RCU or Configuration Wizard, use a JDK version that was used whileinstalling the software and continue to refer to the same version of the JDK. The JDKpath is stored in a variable called JAVA_HOME which is centrally locatedin .globalEnv.properties file inside the ORACLE_HOME/oui directory.

The utility scripts such as config.sh|cmd, launch.sh, or opatch reside in theORACLE_HOME, and when you invoke them, they refer to the JAVA_HOME variablelocated in .globalEnv.properties file. To point these scripts and utilities to the newerversion of JDK, you must update the value of the JAVA_HOME variable inthe .globalEnv.properties file by following the directions listed in Updating the JDKLocation in an Existing Oracle Home .

To make the scripts and files in your Domain home directory point to the newer versionof the JDK, you can follow one of the following approaches:

• Specify the path to the newer JDK on the Domain Mode and JDK screen whilerunning the Configuration Wizard.

For example, consider that you installed Oracle Fusion Middleware Infrastructurewith the JDK version 8u191. So while configuring the WebLogic domain with theConfiguration Assistant, you can select the path to the newer JDK on the Domain

A-1

Mode and JDK screen of the Configuration Wizard. Example: /scratch/jdk/jdk1.8.0_211.

• Manually locate the files that have references to the JDK using grep (UNIX) orfindstr (Windows) commands and update each reference. See Updating theJDK Location in an Existing Oracle Home .

Note:

If you install the newer version of the JDK in the same location as theexisting JDK by overwriting the files, then you don’t need to take any action.

• Updating the JDK Location in an Existing Oracle HomeThe getProperty.sh|cmd script displays the value of a variable, such asJAVA_HOME, from the .globalEnv.properties file. The setProperty.sh|cmd scriptis used to set the value of variables, such as OLD_JAVA_HOME or JAVA_HOMEthat contain the locations of old and new JDKs in the .globalEnv.properties file.

• Updating the JDK Location in an Existing Domain HomeYou must search the references to the current JDK, for example 1.8.0_191manually, and replace those instances with the location of the new JDK.

• Updating the JDK in an Existing OGGSTUDIO HomeWhen you start Oracle GoldenGate Studio for the first time, you will be promptedto specify the JDK home.

Updating the JDK Location in an Existing Oracle HomeThe getProperty.sh|cmd script displays the value of a variable, such asJAVA_HOME, from the .globalEnv.properties file. The setProperty.sh|cmd script isused to set the value of variables, such as OLD_JAVA_HOME or JAVA_HOME thatcontain the locations of old and new JDKs in the .globalEnv.properties file.

The getProperty.sh|cmd and setProperty.sh|cmd scripts are located in the followinglocation:

(UNIX) ORACLE_HOME/oui/bin(Windows) ORACLE_HOME\oui\binWhere, ORACLE_HOME is the directory that contains the products using the currentversion of the JDK, such as 1.8.0_191.

To update the JDK location in the .globalEnv.properties file:

1. Use the getProperty.sh|cmd script to display the path of the current JDK from theJAVA_HOME variable. For example:

(UNIX) ORACLE_HOME/oui/bin/getProperty.sh JAVA_HOME(Windows) ORACLE_HOME\oui\bin\getProperty.cmd JAVA_HOMEecho JAVA_HOMEWhere JAVA_HOME is the variable in the .globalEnv.properties file that containsthe location of the JDK.

2. Back up the path of the current JDK to another variable such asOLD_JAVA_HOME in the .globalEnv.properties file by entering the followingcommands:

Appendix AAbout Updating the JDK Location After Installing an Oracle Fusion Middleware Product

A-2

(UNIX) ORACLE_HOME/oui/bin/setProperty.sh -name OLD_JAVA_HOME-value specify_the_path_of_current_JDK(Windows) ORACLE_HOME\oui\bin\setProperty.cmd -nameOLD_JAVA_HOME -value specify_the_path_of_current_JDK

This command creates a new variable called OLD_JAVA_HOME inthe .globalEnv.properties file, with a value that you have specified.

3. Set the new location of the JDK in the JAVA_HOME variable ofthe .globalEnv.properties file, by entering the following commands:

(UNIX) ORACLE_HOME/oui/bin/setProperty.sh -name JAVA_HOME -value specify_the_location_of_new_JDK(Windows) ORACLE_HOME\oui\bin\setProperty.cmd -name JAVA_HOME-value specify_the_location_of_new_JDK

After you run this command, the JAVA_HOME variable inthe .globalEnv.properties file now contains the path to the new JDK, such asjdk1.8.0_211.

Updating the JDK Location in an Existing Domain HomeYou must search the references to the current JDK, for example 1.8.0_191 manually,and replace those instances with the location of the new JDK.

You can use the grep (UNIX) or findstr (Windows) commands to search for thejdk-related references.

You’ll likely be required to update the location of JDK in the following three files:

(UNIX) DOMAIN_HOME/bin/setNMJavaHome.sh(Windows) DOMAIN_HOME\bin\setNMJavaHome.cmd

(UNIX) DOMAIN_HOME/nodemanager/nodemanager.properties(Windows) DOMAIN_HOME\nodemanager\nodemanager.properties

(UNIX) DOMAIN_HOME/bin/setDomainEnv.sh(Windows) DOMAIN_HOME\bin\setDomainEnv.cmd

Updating the JDK in an Existing OGGSTUDIO HomeWhen you start Oracle GoldenGate Studio for the first time, you will be prompted tospecify the JDK home.

The JDK location that you specify is saved in the cache directory for use during everysubsequent launch of the Oracle GoldenGate Studio. To update the JDK location, youshould update the path of JDK mentioned in the product.conf file in cache andrestart Oracle GoldenGate Studio. Upon restart, Oracle GoldenGate Studio will usethe new JDK home.

The cache directory is created inside the user home directory. See Setting the UserHome Directory.

Appendix AAbout Updating the JDK Location After Installing an Oracle Fusion Middleware Product

A-3