11.2.2 Troubleshooting: Oracle GoldenGate Microservices Targets

• Identifying the Error
  

11.2.2.1 Identifying the Error

To identify the error:

1. After logging in to the Oracle GoldenGate Enterprise Manager Plug-in, on the main page, select Setup, click Add Target, and then select Configure Auto Discovery to display the Setup Discovery page.
2. On the Targets on Host tab, select a target and then click Diagnostic Details to display the Diagnostic Details page.
3. Select the Oracle GoldenGate Service Manager target that you just discovered.
4. Click Log from Agent to display a Confirmation dialog box.
5. Scroll down the Confirmation dialog to view the errors.

Resolution

1. Discover a Microservices instance as described in Discovering an Oracle GoldenGate Enterprise Manager Plug-in Microservices Instance.
2. While discovering a target, when you come across the Edit Parameters: Oracle GoldenGate dialog box, enter the correct Password for the given User Name and click OK.
3. Click Discover Now and click Yes in the Discover Now confirmation dialog box.
4. After the discovery is successful, click Close in the Confirmation dialog box.
5. To view the discovery logs in case of an error occurrence, select the target, click Diagnostic Details, select Oracle GoldenGate Microservices, and the click Log from Agent.

Oracle GoldenGate Microservices targets are successfully discovered on entering the appropriate Hostname, Username, Password, Port, and Target Name Prefix in the Edit Parameters dialog box.

This topic describes the following discovery-related errors:

• Authentication Issue
  
• Connection Issue
  
• SSL Certificate Issue
  

11.2.2.1.1 Authentication Issue

Ensure that you are able to login to the Oracle GoldenGate Microservices URL using the correct credentials that you have entered in the Oracle GoldenGate Enterprise Manager Plug-in to successfully discover Oracle GoldenGate Microservices targets.

11.2.2.1.2 Connection Issue

If discovery is not successful and a Connection Exception has occurred, then you need to ensure the following:

• The Oracle GoldenGate Service Manager is up and running in case of Oracle Cloud Infrastructure (OCI) Marketplace instances or on-premises GoldenGate instances.
• Ensure that the Administration Service and Performance Metrics Service are up and running.
• There is no firewall blocking connection to the Oracle GoldenGate host from the Enterprise Manager Agent host.
• Oracle GoldenGate REST APIs (Performance Metrics Service) are accessible from the Enterprise Manager Agent. For example, use the cURL command to test the connectivity to the Oracle GoldenGate REST APIs. For more information about using the command, see REST API for Oracle GoldenGate.
• If Oracle GoldenGate is running with SSL, then you need to import the certificate at the Enterprise Manager Agent TrustStore. Ensure that the certificate is imported in the correct Enterprise Manager agent that monitors the corresponding GoldenGate targets. You can view and download the certificate using the browser by logging into the Oracle GoldenGate Administration Service UI or the Service Manager UI in case of OCI GoldenGate instance.

11.2.2.1.3 SSL Certificate Issue

If discovery is not successful and a valid certification path to requested target is not found, then you need to ensure the following:

• Ensure that the Administration Service and Performance Metrics Service are up and running.
• Ensure that the SSL certificate has been uploaded/installed on the OEM Agent present in GoldenGate Microservices server.

  Note:

  If you have uploaded SSL certificate in OEM Agent running on the OMS Server and not on OEM Agent running on GoldenGate Microservices Server, then target discovery fails with the following error:

  SEVERE: Exception during Targets discovery: EM-90000 - Target Discovery failed. Internal Error. Please contact System Administrator. com.oracle.sysman.goldengate.discovery.GoldenGateDiscovery$GGDiscoveryException: EM-90000 - Target Discovery failed. Internal Error. Please contact System Administrator. Unable to find valid certification path to requested target.

  Performance Metric REST API will directly read with OMS Server.