This document describes the new features, major changes, and the known issues in the Oracle GoldenGate Enterprise Manager Plug-In 13c (13.4.2.0.0) release. It includes the following sections:

1.1 New and Changed Features

This section outlines the new features that are being introduced in various releases of the Oracle GoldenGate Enterprise Manager Plug-In.

1.1.1 New and Changed Parameters and Commands

The following emcli verbs are added to discover Oracle GoldenGate targets:
  • discover_gg: Discovery of Oracle GoldenGate Classic targets
  • discover_ggma: Discovery of Oracle GoldenGate Microservices targets
For more information, see Discovering Oracle GoldenGate Targets in the Oracle GoldenGate System Monitoring Plug-In User Guide.

1.1.2 Release 13.4.2.0.0 — March 2021

Discovery through command line is now supported:

The following emcli verbs are added to discover Oracle GoldenGate targets:
  • discover_gg: Discovery of Oracle GoldenGate Classic targets
  • discover_ggma: Discovery of Oracle GoldenGate Microservices targets
For more information, see Discovering Oracle GoldenGate Targets in the Oracle GoldenGate System Monitoring Plug-In User Guide.

Filters for deployments are added in the Service Manager page so that the user can now select a particular deployment and be able to view the processes and services of only that deployment.

For more information, see Service Manager in the Oracle GoldenGate System Monitoring Plug-In User Guide.

Preferred Credentials for Oracle GoldenGate Service Manager

It is required to set preferred credentials to Oracle GoldenGate Service manager target for Oracle GoldenGate Microservices instances in addition to monitoring credentials. While setting preferred credentials for a Microservices instance, you need to add only the host credential. For more information, see Setting Credentials for Oracle GoldenGate Microservices Instance in the Oracle GoldenGate System Monitoring Plug-In User Guide.

Oracle GoldenGate on Oracle Cloud Marketplace is certified using the Oracle Enterprise Manager on Oracle Cloud Marketplace.

Oracle Enterprise Manager 13.5.0.0.0 has been certified in this release.

1.2 Installation and Upgrades

For installation and upgrade instructions, see Installing Oracle GoldenGate Enterprise Manager Plug-In.

1.3 Corrected Problems

For questions about specific BugDB bug identification number or Service Request (SR) ticket numbers, contact Oracle Customer Support.

1.3.1 Release 13.4.2.0.1 — August 2021

Bug 32709655 - Discovery of Oracle GoldenGate Microservices (MA) targets fails when the Service Manager Host Name is lengthy

This issue has been fixed. Oracle GoldenGate Microservices (MA) targets are successfully discovered even if a lengthy Service Manager Host Name is entered.

Bug 32965181 - Discovery fails using discover_ggma when emcli client is not in same location as OMS

This issue has been fixed. The EMCLI verbs discover_gg and discover_ggma successfully run when configFile is present at a location local to EMCLI.

Bug 33173023 - When the Receiver Server is down, the Incident Manager displays an incorrect "Target is Down" Summary in the Incident Dashboard of the Oracle GoldenGate Receiver Server page.

This issue has been fixed. The Incident Manager does not display an incorrect summary now in either of the following cases: path for the Receiver server is not set or the Receiver server path is down.

1.3.2 Release 13.4.2.0.0 — March 2021

Bug 31631150 and Bug 32089989 - Performance issues (navigation and application-hanging issues)

These issues have been fixed. When the Oracle GoldenGate Home Page was being loaded, in certain scenarios connection was made to GoldenGate monitoring agent to get few configuration metrics from the Oracle Monitoring Service (OMS). When there was any issue with connection to the Oracle GoldenGate monitoring agent, Home page was either getting hung or taking long time to load.

Bug 31654769 - Distribution path and receiver path incident alert are not supported

This issue has been fixed. You can now set alerts for distribution path and receiver path status.

Bug 32028058 - User is unable to start/stop the renamed targets

This issue has been fixed. If the Extract and Replicat targets were renamed, then it was not possible to start or stop these targets.

Bug 32106807 - Microservices (MA) with Oracle Enterprise Manager plugin - problem trying to get the configuration or logs with remote EM Agent

This issue has been fixed. You can now access logs and configuration of Oracle GoldenGate Microservices Secure Sockets Layer (SSL) instance when discovered from a remote agent.

Bug 32351556 - Unable to discover Microservices deployment to Oracle Enterprise Manager

This issue has been fixed. Discovery was failing when the Service Manager password contained few special characters.

1.4 Known Issues

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.

1.4.1 Release 13.4.2.0.0 — March 2021

Bug 31563078 - "Seconds Since Last OGG Checkpoint" metrics is not redirecting to right section in All metrics page.

When you click Seconds Since Last OGG Checkpoint on the OGG Home page, it doesn't redirect to the Seconds Since Last OGG Checkpoint page on the All metrics page.

Bug 30111773 - Seconds Since Last OGG Checkpoint value displaying high if OGG MA configure with Remote Agent

When an Oracle GoldenGate Microservices instance is configured on a remote agent, then the Seconds Since Last OGG Checkpoint does not display valid values, and very high values are displayed.

Bug 31551487 - User is Unable to promote Distribution, pmsrvr and Receiver server together

From the Setup Discovery page, you cannot promote the Distribution Server, Performance Metrics Server, and the Receiver Server together.

Workaround: You need to promote the Distribution Server, Performance Metrics Server, and the Receiver Server separately.

Bug 31772746 - Lag displaying multiple times in incident alert page in an upgrade environment

You can set a metric alert for lag using either the Metrics and Collections page or the All Metrics page. However, while defining a rule in the Incident alert page, lag is displayed twice.

Workaround: You have to set alert for both the lags, while defining the Incident Rule.

1.5 Getting Help with My Oracle Support

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.

1.5.1 Viewing the Oracle GoldenGate Knowledge Base

To view the Oracle GoldenGate Knowledge Base, follow these steps:

  1. Browse to the My Oracle Support web site at https://support.oracle.com/portal/.
  2. Select your language and then log in with your email and Oracle password.
  3. Click the Knowledge tab.
  4. 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).
  5. 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.

1.5.2 Creating an Oracle GoldenGate SR Ticket

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:

  1. Browse to the My Oracle Support web site at https://support.oracle.com/portal/.
  2. 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.
  3. Click the Service Requests tab.
  4. Click Create SR.
  5. 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.

1.6 Audience

This guide is intended for installers, database administrators, and system administrators who are installing, configuring and running Oracle GoldenGate.

1.7 Related Information

The Oracle GoldenGate Product Documentation Libraries are found at:

Oracle GoldenGate Documentation

The Oracle GoldenGate related product documentation libraries are found at:

https://docs.oracle.com/en/middleware/goldengate/index.html

For additional information on Oracle GoldenGate, refer to:

https://www.oracle.com/middleware/technologies/goldengate.html

https://www.oracle.com/database/technologies/high-availability/oracle-database-maa-best-practices.html

1.8 Conventions

The following text conventions are used in this document:

Convention Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, such as "From the File menu, select Save." Boldface also is used for terms defined in text or in the glossary.

italic

italic

Italic type indicates placeholder variables for which you supply particular values, such as in the parameter statement: TABLE table_name. Italic type also is used for book titles and emphasis.

monospace

MONOSPACE

Monospace type indicates code components such as user exits and scripts; the names of files and database objects; URL paths; and input and output text that appears on the screen. Uppercase monospace type is generally used to represent the names of Oracle GoldenGate parameters, commands, and user-configurable functions, as well as SQL commands and keywords.

UPPERCASE

Uppercase in the regular text font indicates the name of a utility unless the name is intended to be a specific case.

{ }

Braces within syntax enclose a set of options that are separated by pipe symbols, one of which must be selected, for example: {option1 | option2 | option3}.

[ ]

Brackets within syntax indicate an optional element. For example in this syntax, the SAVE clause is optional: CLEANUP REPLICAT group_name [, SAVE count]. Multiple options within an optional element are separated by a pipe symbol, for example: [option1 | option2].

1.9 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.