6.7 Subscribing Management Agents to an Agent Gold Image

To subscribe a set of Management Agents to an Agent Gold Image, use either of the following methods:

  • Subscribing Management Agents to an Agent Gold Image Using Gold Agent Images Home Page

  • Subscribing Management Agents to an Agent Gold Image Using EM CLI

    WARNING:

    You cannot directly subscribe a Shared Agent (NFS Agent) to an Agent Gold Image. To subscribe to an Agent Gold Image, you must first convert the Shared Agent to a standalone Management Agent, and then subscribe to an Agent Gold Image.

    Note:

    When you have to subscribe a set of related Management Agents to an Agent Gold Image, it is mandatory to subscribe all the related Agents. However, there is an option to override this in case if you want to subscribe only a selected few Agents to the Agent Gold Image. To achieve this, you have to set the parameter ignoreRelatedCheck to true in the EM_GI_MASTER_INFO table.

6.7.1 Subscribing Management Agents to an Agent Gold Image Using Gold Agent Images Home Page

Note:

You cannot install, update, or upgrade a Shared Agent (NFS Agent) using an Agent Gold Image.

You cannot subscribe the following Management Agents to an Agent Gold Image:

  • Central Agent.

  • Already subscribed Management Agents.

  • Shared Agents (NFS Agents).

  • Unsecure Management Agents.

  • Management Agents on platforms that are different from the platforms on which the Agent Gold Image is available.

    The platform is identified by the Oracle home collection, so make sure the Oracle home target is discovered and collected. To do so, On the Home page of the Management Agent, in the Summary section, click Oracle Home and Patch Details, and on the following page, click Refresh Configuration.

To subscribe a set of Management Agents to an Agent Gold Image, follow these steps:

  1. From the Setup menu, select Manage Cloud Control, then select Gold Agent Images.
  2. Click the name of the required Agent Gold Image.
  3. Click Manage Image Versions and Subscriptions.
  4. Select the Subscriptions tab. Click Subscribe.
  5. Search for and select the required Management Agents, then click Select.

6.7.2 Subscribing Management Agents to an Agent Gold Image Using EM CLI

To subscribe a Management Agent to an Agent Gold Image using EM CLI, follow these steps:

Note:

You cannot subscribe the following Management Agents to an Agent Gold Image:

  • Central Agent.

  • Already subscribed Management Agents.

  • Shared Agents (NFS Agents).

  • Unsecure Management Agents.

  • Management Agents on platforms that are different from the platforms on which the Agent Gold Image is available.

    The platform is identified by the Oracle home collection, so make sure the Oracle home target is discovered and collected. To do so, On the Home page of the Management Agent, in the Summary section, click Oracle Home and Patch Details, and on the following page, click Refresh Configuration.

  1. Log in to EM CLI from the /bin directory present within the Oracle home of the OMS: 
    $<ORACLE_HOME>/bin/emcli login -username=<user_name>

    Once you run this command, EM CLI will prompt you for a password. Enter the password for the user name you specified.

  2. Synchronize EM CLI: 
    $<ORACLE_HOME>/bin/emcli sync
  3. Run the subscribe_agents verb to subscribe the specified Management Agent to a specific Agent Gold Image: 
    $<ORACLE_HOME>/bin/emcli subscribe_agents 
         -image_name="Image Name" 
         [-agents="agent_name_pattern"] 
         [-groups="group_name"]

    Note that the parameters mentioned in [ ] are optional.

    The -image_name parameter subscribes the Management Agents to the specified Agent Gold Image.

    The -agents parameter subscribes only the Management Agents that match the specified name pattern.

    The -groups parameter subscribes only the Management Agents that belong to the specified groups.

    Examples:

    • The following example subscribes the Management Agents that match the name pattern abc% or xyz.domain.com:1243 to the Agent Gold Image OPC_AGT_ADC_POD:

      $<ORACLE_HOME>/bin/emcli subscribe_agents -image_name="OPC_AGT_ADC_POD" -agents="abc%,xyz.domain.com:1243"

    • The following example subscribes all the Management Agents to the Agent Gold Image OPC_AGT_ADC_POD:

      $<ORACLE_HOME>/bin/emcli subscribe_agents -image_name="OPC_AGT_ADC_POD"

    • The following example subscribes all the Management Agents that belong to the group GROUP1 or GRP2 to the Agent Gold Image OPC_AGT_ADC_POD:

      $<ORACLE_HOME>/bin/emcli subscribe_agents -image_name="OPC_AGT_ADC_POD" -groups="GROUP1,GRP2"