5.2.1 Discovering an Oracle GoldenGate Enterprise Manager Plug-in Classic Instance using EM CLI

Oracle Enterprise Manager Command Line Interface (EM CLI) enables you to access Enterprise Manager functionality through a command-line interface or scripts. The discover_gg Verb is used to discover Oracle GoldenGate Classic targets. Targets discovered using this emcli verb are auto promoted, except when they are run using the -check option.

For more information about EM CLI, see EM CLI Overview and Concepts. For more information about discovery, see Discovering Oracle GoldenGate Targets in the UI.

Syntax

emcli discover_gg
[-configFile="configFile"]
[-debug]
[-check]
Options
-configFile
Path to the discovery input file. Ensure that this file contains the following parameters:
  • host - Hostname of Oracle GoldenGate Monitor Agent. For example, host00uaz.us.oracle.com
  • port - Port of Oracle GoldenGate Monitor Agent. For example, 5559.
  • user - Username to connect to Oracle GoldenGate Monitor Agent. For example, oggmajmxusr.
  • password - Password to connect to Oracle GoldenGate Monitor Agent.
  • agentURL - Enterprise Manager Agent URL. For example, https://host00uaz.us.oracle.com:3872/emd/main/. You can also set multiple secondary agentURLs that are comma separated. The first url in the list that is UP and running will be considered as the primary agentURL and the rest are all secondary URLs. For example, https://phoenix93982.dev3sub2phx.databasede3phx.oraclevcn.com:3872/emd/main/,https://london57277.dev1sub1lhr.databasede02lhr.oraclevcn.com:3872/emd/main,https://phoenix95679.dev3sub2phx.databasede3phx.oraclevcn.com:3872/emd/main/.
  • targetNamePrefix - Enter the target name prefix. For example, test_env_orcl_src. The target name prefix is appended with colon (":") and this gets prefixed to all target names. For example, test_env_orcl_src:targetName. This is an optional field.
-debug
Runs the verb in verbose mode for debugging purposes.
-check
Runs discovery and displays the results. This does not add the targets.
Exit Codes
  • 0 - On success
  • Non-zero value - Verb processing was not successful.

Example

emcli discover_gg
-configFile="/scratch/input.conf"
-debug
-check
For more information about troubleshooting Discovery-related issues, see Troubleshooting Discovery.