1. Oracle GoldenGate System Monitoring Plug-In User Guide
  2. Setting the Credentials

3 Setting the Credentials

This topic details the following: For more information on setting credentials, watch the Setting Credentials in Oracle GoldenGate Enterprise Manager Plug-in video.

3.1 Credentials — Overview

The Enterprise Manager Credential subsystem enables the Enterprise Manager Administrators to store credentials in a secure manner — as preferences or operation credentials. The credentials can then be used to perform different system management activities, such as real-time monitoring, patching, provisioning, and other target administrative operations.

You need to set the Preferred Credentials for Oracle GoldenGate classic instance and set the Monitoring Credentials for Oracle GoldenGate microservices (MA) instance.

Before setting credentials, you can notice that the process action buttons are grayed out:

Figure 3-1 Action Buttons are not active

Before setting credentials, you will notice process action buttons are grayed out

Figure 3-2 Action Buttons are active

After credentials are set, the action buttons will become active

3.2 Different Credential Sets for Oracle GoldenGate

Preferred credentials are used to simplify access to the managed targets by storing target login credentials in the Management Repository. Preferred credentials are required for performing the administrative tasks for the Oracle GoldenGate classic instances.

Preferred credentials are set on a per-user basis, thus ensuring the security of the managed enterprise environment. The credentials are hierarchical in nature. For example, if credentials are provided for Oracle GoldenGate target type, then by default, they are applicable to its child target types as well, which means that they are applicable for Oracle GoldenGate Extract, Manager, or Replicat processes. Preferred Credentials are of the following types: Host Credential and OGG Admin Credentials.
Host Credential
Host Credential is the credential to login to the Enterprise Manage Agent host machine. 
OGG Admin Credentials
OGG Admin Credentials is the credentials of Oracle GoldenGate Monitoring Agent. The username is defined in the config.properties in the Oracle GoldenGate Monitoring Agent installation.

3.2.1 Monitoring Credentials

Monitoring credentials are required to perform the administrative tasks for the Oracle GoldenGate microservices instances.

The monitoring credentials are hierarchical in nature. For example, if credentials are provided for Oracle GoldenGate Service Manager target type, then by default, they are applicable to its child target types as well, such as Oracle GoldenGate Administration/Distribution/Receiver Server. For monitoring credential, use the same credential that can access Service Manager on Oracle GoldenGate microservices instances.

3.3 Setting the Credentials for Oracle GoldenGate Classic Instance

To create preferred credentials:
  1. Navigate to the Setup menu, select Security, then select Preferred Credentials.
  2. On the Preferred Credentials page, type goldengate in search box, then click Search.
  3. Under the Target Type column, click Oracle GoldenGate to highlight the row, then click Manage Preferred Credential
  4. On the Oracle GoldenGate Preferred Credentials page, you can create both the Default Preferred Credentials as well as the Target Preferred Credentials.

    If you want to set a preferred credential for Oracle GoldenGate, which is applicable for all Oracle GoldenGate targets, then go to Default Preferred Credentials.

    If you want to set a preferred credential for Oracle GoldenGate applicable only to a specific Oracle GoldenGate target, then go to Target Preferred Credentials.

  5. Under Default Preferred Credentials, select the Host Credentials credential set, and click Set to display the Select Named Credential dialog box. Create new or use existing credential that can be used to login to the EM Agent host machine.
  6. Under Default Preferred Credentials, select OGG Admin Credentials credential set, and click Set to display the Select Named Credential dialog box. Create new credential by entering the same JAgent credential that was used to discover this GoldenGate instance, or use an existing one.
  7. Under Target Preferred Credentials, click on a target with Host Credentials credential set, then click Test by wrench icon. It brings up the Test Named Credential page. Keep the Test Type as Basic, and click Test button. Ensure all targets with Host Credentials credential set are tested with successful results.

3.4 Setting Credentials for Oracle GoldenGate Microservices Instance

To set the monitoring credentials for Oracle GoldenGate microservices (MA) instance:

  1. Navigate to the Setup menu, select Security, and then select Monitoring Credentials to display the Security > Monitoring Credentials page.
  2. Type goldengate service in the search box, then click Search.
  3. Select the Oracle GoldenGate Service Manager Target Type.
  4. Click Manage Monitoring Credentials to display the Oracle GoldenGate Monitoring Credentials page.
  5. Select the Target Name and click Set Credentials to display the Enter monitor credentials dialog box.
  6. Enter the service manager Username, Password, and Confirm Password, and click Save. (same Service Manager credential that was used to discover this GoldenGate instance).
    The Monitoring Credentials are set and this information is indicated on the screen.

    Note:

    The Monitoring Credentials should only be set for GoldenGate microservices instance. Do not use Monitoring Credentials for classic instance. To set Monitoring Credentials for multiple targets, you can use emcli create_credential_set verb with the -monitoring option.