6.5 Setting a Particular Agent Gold Image Version as the Current Version

The up-to-date version of an Agent Gold Image that you want to use to standardize the Management Agents in your enterprise is termed as the current version of the Agent Gold Image.

When an Agent Gold Image version is created, it is marked as a draft version. Setting a draft version of an Agent Gold Image as the current version indicates that the gold image version is ready to be used to mass deploy or mass update Management Agents. Once an image is set to Active (Current), you cannot revert it to a draft or a restricted version.

To set a draft version of an Agent Gold Image as the current version, use either of the following methods:

• Setting a Particular Agent Gold Image Version as the Current Version Using Gold Agent Images Home Page

• Setting a Particular Agent Gold Image Version as the Current Version Using EM CLI

6.5.1 Setting a Particular Agent Gold Image Version as the Current Version Using Gold Agent Images Home Page

To set a draft version of an Agent Gold Image as the current version, 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 Versions and Drafts tab. Select the gold image version that you want to set as the current version, then click Set Current Version.

   A job that promotes the Agent Gold Image draft version to the current version is submitted to the Enterprise Manager job system. You can view the status of this job on the Gold Agent Image Activities page, in the Image Activities tab.

6.5.2 Setting a Particular Agent Gold Image Version as the Current Version Using EM CLI

To set a particular Agent Gold Image version as the current version using EM CLI, follow these steps:

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 promote_gold_agent_image verb to promote the Agent Gold Image version to the Current maturity level:

   $<ORACLE_HOME>/bin/emcli promote_gold_agent_image         
   -version_name="gold_image_version_name"       
    -maturity="Current/Restricted/Draft"
    
   

   The -version_name parameter defines the Agent Gold Image that you want to promote.

   The -maturity parameter defines the gold image maturity level.

   For example, to promote the Agent Gold Image OPC_AGI_DB_JUL_13 to the Current maturity level, run the following:

   $<ORACLE_HOME>/bin/emcli promote_gold_agent_image  -version_name=OPC_AGI_DB_JUL_13 -maturity=Current