Go to main content
|Oracle® GoldenGate Enterprise Manager Plug-In Release Notes|
Enterprise Manager Plug-In Release Notes
The Enterprise Manager Plug-in for Oracle GoldenGate extends the Oracle Enterprise Manager (OEM) Cloud Control to support for monitoring and managing Oracle GoldenGate processes including the following:
Viewing summary of all Oracle GoldenGate release 11g (11.2) and later instances on a single, customizable web page.
In depth examination into dozens of metric values and metric history.
Automated notifications and ticket creation through incidents.
Graphing historical trends of any numerical metric.
Enhanced EM target promotion; simultaneously promoting all targets in an Oracle GoldenGate instance.
For each process in the instance, the Oracle GoldenGate EM Plug-in home page displays:
Target type, such as Extract or Manager
The lag in seconds
Sparkline graphs that display lag trends
Delta operations per second
Time elapsed since last Oracle GoldenGate checkpoint
Timestamp of last Oracle GoldenGate checkpoint
The Oracle GoldenGate EM Plug-in includes custom screens for:
Customizing the display on the home page. This allows the you to:
Indicate that certain Oracle GoldenGate instances should or should not be displayed on the home page.
Change the order of instances displayed.
Define an alternate display name.
Add a description for an instance.
Promoting Oracle GoldenGate targets. To simplify the promotion of Oracle GoldenGate instances that may include many Extract and Replicat processes, a custom screen displays all of the processes defined for an instance and allows the user to promote all or a subset in a single action.
To support high availability, the tab was added to Manage Agent home screen.
The Oracle GoldenGate EM Plug-in supports monitoring of the platforms where Oracle GoldenGate 11g (11.2 and later) instances can run with the following exceptions: HP NonStop and DB2 for i.
The Oracle GoldenGate EM Plug-in has been certified on the following product releases:
Enterprise Manager 12c Cloud Control Release 1 (220.127.116.11) and later.
Oracle GoldenGate 11g Release 2 (18.104.22.168.17) and later.
Oracle recommends that you use Oracle GoldenGate Monitor Agent 12c (12.1.3) with this Oracle GoldenGate EM Plug-in to ensure full functionality.
This section outlines the new features that are being introduced in Release 12c (22.214.171.124) .
Support for DB2 z/OS was added.
Support for High Availability replication failovers in a cluster was added.
The new Manage Agent tab was added to the home page to allow you to set master and slave combinations for high availability.
For target types Replicat and Extract you can:
Control processes using Start, Stop, Kill and Resume actions.
View and edit the associated configuration files.
View and edit the associated report and discard files.
Preferred Credentials security for processing control and file operations was enhanced to provide target-level privileges to Administrator Users.
You can remotely monitor of Oracle GoldenGate using the Oracle GoldenGate Monitor Agent.
Response Metrics are now categorized under Default/Availability rather than the previous Default/Load category.
This section contains information about new and updated Oracle GoldenGate EM Plug-in EM Plug-in parameters and Commands as the result of new features or functionality changes in the product for this release.
There are no new parameters or commands in this release.
The following GGSCI commands are applicable to the Oracle GoldenGate:
START JAGENT starts up the JAgent for the Oracle GoldenGate instance.
STOP JAGENT stops the JAgent.
INFO JAGENT and
STATUS JAGENT indicate whether or not the JAgent is running.
CREATE DATASTORE creates a storage area to hold monitoring information supplied by Oracle GoldenGate Extract, Replicat, and Manager processes.
REPAIR DATASTORE checks that all Extract and Replicat processes are registered and attempts to resolve any internal consistency issues. This should only be used when directed by Oracle Support.
OGG_VIEW_DISCARD_FILE role and log file is deprecated.
Support for specifying a particular release of Oracle GoldenGate using the
feature_version.xml file is deprecated because it is set automatically in this release.
The installation file downloaded from Oracle is not compressed using
gzip, instead it is a standard ZIP file. To uncompress the download, use the following methods:
Use WinZip or another uncompress method that supports ZIP files.
If you do not have these utilities, you can download them from the Oracle UnZip Utilities Download web site at
For installation and upgrade instructions, see Oracle Enterprise Manager Oracle GoldenGate System Monitoring Plug-In Installation Guide.
For questions about specific BugDB bug identification number or Service Request (SR) ticket numbers, contact Oracle Customer Support.
agentList variable is Null, then a
Exception occurred. To correct this issue, the exception was handled by adding If checks and also handled the unnecessary open issue by closing them properly.
If the report and discard file sizes are greater than a page size, then an
Unknown exception ]] java.lang.NumberFormatException For input string occurred. The
GETFILEINCHUNK command was modified to correct process the sizes.
An issues with report files not displaying any content on Windows systems was fixed.
An issue with OEM incorrectly refreshing the Preferred credentials when the Extract process has two parents was fixed.
When promoting a target, all of the matched processes in the instance are returned.
For a composite target,
is_ propagating = 1 means that its privilege is passed to its member targets. For the oracle_goldengate target
is_propagating is now set to 1.
Added total ignores and delta ignores for Replicat processes.
If the current value of a performance MP is zero, its delta value is now also zero.
When a target goes down, the message displayed was improved to "Target is DOWN".
The message metric for GoldenGate targets was removed and Log Monitoring configuration in the targets metadata was added.
The password field was changed to be secure input in the GoldenGate Discovery Parameter page.
For questions on specific bugs or ticket numbers, consult Oracle Customer Support. SR is the Oracle Support SR number, and BugDB is the bug identification number. .
If you encounter this issue, you need to do the following:
After applying the agent patch, restart the EM agent.
After applying the server patch and if ADF Exceptions and errors occur, you need to remove the corresponding process, and then rediscover it in the Server UI.
You can use My Oracle Support to find knowledge solutions, workarounds, and other information that is reported by customers, partners, and Oracle employees. My Oracle Support also enables you to open an SR ticket. If a patch is required to resolve an SR, you will receive instructions about how to download it from My Oracle Support.
Note:If you purchased Oracle GoldenGate and support through a distributor, contact your distributor instead of attempting to create a service request through My Oracle Support.
To view the Oracle GoldenGate Knowledge Base, follow these steps:
Select your language and then log in with your email and Oracle password.
Click the Knowledge tab.
In the Select a product or product line field, enter GoldenGate, and then select an Oracle GoldenGate product from the context-sensitive list to narrow your results. (You may have to wait a few seconds for this list to appear).
In the Enter search terms field, enter a search keyword or multiple keywords to focus the query.
Additional information about how to use this tab is obtained by clicking Help.
If you cannot find an answer to your question or problem in the Knowledge Base, you can open a support request ticket with Oracle Support by following these steps:
Select your language, and then sign in with your credentials. If you have not done so, you will have to register to use this web site.
Click the Service Requests tab.
Click Create SR.
Use the Create Service Request wizard to complete and submit your SR. Additional information about how to use this tab is obtained by clicking Help.
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at
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.
Enterprise Manager Plug-In Release Notes, 12c (126.96.36.199)
Copyright © 2012, 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.