This document describes the new features, major changes, and the known issues in the Oracle GoldenGate Enterprise Manager Plug-In 13c (13.5.1.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

  • Target Name Prefix (Optional Parameter): in the Discovery User Interface (Discovery via UI as well as EMCLI Verbs) for both Oracle GoldenGate Classic and Microservices Instances.
  • GG_EXECUTE: Support the start/stop/kill Extract and Replicat via EMCLI. See EMCLI - Commands to Execute on GoldenGate Process.

1.1.2 Release 13.5.1.0.0 — February 2022

Monitoring of GoldenGate Monitor Agent

Oracle GoldenGate target displays metrics, such has monitor agent version, status, and web service availability relating to GoldenGate Monitor agent. These metrics and a few others are displayed on the Oracle GoldenGate Target page. When the Monitor agent is down or Web Service is unreachable, the status of various GoldenGate classic targets displays a Warning icon on the OGG Home page. You can set alerts and notification for GoldenGate monitoring agent metrics. See GoldenGate Monitor Agent in Oracle GoldenGate System Monitoring Plug-In.

Discovery Support for additional GoldenGate Targets

You can now discover and monitor GoldenGate instances running in Oracle Cloud Infrastructure and OCI Marketplace configured to run using reverse proxy.

Additional Metrics for Distribution/Receiver Paths

You can monitor and view the additional Path metrices, such as Path Details that include target encryption algorithm, critical, processing lag, auto restart, and Statistics like DDLs, DMLs, and Table Statistics in the Distribution Service detailed page and Receiver Service detailed page. For more information, see Distribution Service and Receiver Service in Oracle GoldenGate System Monitoring Plug-In.

Enhancement of Administration Service

The Administration Service has been enhanced to display the following Process Summary details: Process Health Overview chart, Alert Overview chart, and the metrics details of the Processes. Process-related details, such as Name, Status, Type, Lag, Total Discards, and Total Ignore are displayed in a tabular format. You can also view detailed metrics for a selected process. For more information, see Administration Service in Oracle GoldenGate System Monitoring Plug-In.

EMCLI Verb to start/stop:

The GG_EXECUTE EMCLI Verb has been added to support the start/stop/kill Extract and Replicat. For more information, see EMCLI - Commands to Execute on GoldenGate Process in Oracle GoldenGate System Monitoring Plug-In.

Addition of a new Discovery Parameter

A new Target Name Prefix field has been added to GoldenGate Classic and GoldenGate Microservices Discovery modules. This will be prefixed for all discovered target names. You can choose to give any environment name, which will help you to identify targets that send alerts and also look up for targets in the All Targets page. For the EMCLI Verb based discovery of Oracle GoldenGate targets, a new targetNamePrefix parameter has been added that serves the same purpose as the Target Name Prefix field. For more information, see Discovering Oracle GoldenGate Targets in the UI and Enterprise Manager CLI Verb-Based Discovery of Oracle GoldenGate Targets in Oracle GoldenGate System Monitoring Plug-In.

Changes to Credentials

Monitoring credentials are automatically set to the Oracle GoldenGate Microservices instance after discovery. You need not explicitly set Monitoring credentials and can set only Preferred credentials. You can now manage credentials of the Administration Service and Service Manager separately. If credentials are set for Administration Service target then it is applicable to its child targets, such as extracts and replicats. See Manage Credentials in Oracle GoldenGate System Monitoring Plug-In.

1.2 Installation and Upgrades

For installation and upgrade instructions, see Install and Upgrade in Oracle GoldenGate System Monitoring 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.5.1.0.0 — February 2022

Bug 32709655 - Unable to Discover GoldenGate Microservices (MA) Components when the Hostname is Long

This issue has been fixed. You can discover Oracle GoldenGate Microservices components even after entering a lengthy Hostname in the Edit Parameters page.

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

This issue has been fixed. If you do not provide the configuration file location, then the emcli client checks for the file in the local directory as well and picks it up.

Support for Alert Notification when Oracle GoldenGate Enterprise Manager Plug-in cannot Communicate with Monitor Agent

This issue has been fixed. You can now set alerts to get notified when the Monitor agent is down. Oracle GoldenGate Monitor Agent metrics are added to Oracle GoldenGate target for which, you can set alerts.

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.5.1.0.0 — February 2022

Bug 33704015: Oracle GoldenGate Microservices Coordinated replicat threads is listing in the Enterprise Manager OGG Home page after upgrading from PLG 13.4.2 to 13.5.1

After you upgrade Oracle GoldenGate Enterprise Manager Plug-in from release 13.4.2 to 13.5.1, the Oracle GoldenGate Microservices coordinated replicat threads are listed in the Oracle Enterprise Manager Home page.

Workaround: You need to manually delete the thread processes.

Bug 33762967 - Unable to Save Configuration file changes which are longer in length via EM

Workaround: You can edit and save the lengthy .prm and .properties files from Oracle GoldenGate Core.

Bug 33799014 - EM UI is not displaying Total_discards and Total_ignores metrics for Parallel Replicat targets

Total_discards and Total_ignores metrics are listed as 0 for parallel replicat targets.

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 database 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

Oracle GoldenGate for Big Data Documentation:

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

For additional information on Oracle GoldenGate, refer to:

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

Oracle Database High Availability

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.