3 Download the Oracle Management Cloud Agent Software

The Oracle Management Cloud agent software is provided in a downloadable ZIP file which contains the required files to install Oracle Management Cloud agents.

Download the Oracle Management Cloud Agent Software

You can download the agent software ZIP file using one of the following options:

Download Using Oracle Management Cloud User Interface

The preferred method to download the agent installation software is using the Oracle Management Cloud User Interface.

The agent installation software ZIP file is tenant agnostic: You can download it from any tenant and use it to install agents against other tenants.

Perform the following steps to download the agent software ZIP file:

  1. On the Oracle Management Cloud home page, click the OMC Navigation icon on the top-left corner to view the Management Cloud navigation pane, if it isn’t already displayed.

  2. Select Agents under Administration.

  3. On the Oracle Management Cloud Agents page, click the Download tab.

    The Agent Software Download page is displayed.

  4. Select the agent type from the Agent Type drop-down list, and select the operating system that the agent will be installed on from the Operating System drop-down list.

    The agent software link for the agent you’ve selected is displayed.

    agent download

    If you want to view a list of agent installers for all available and supported operating systems, then select All from the Operating System drop-down list.


    new agent installer, all operating systems

  5. Click the agent software link to download the agent software ZIP file.

Ensure that you verify if the downloaded ZIP file is downloaded completely. Run the following command to verify if the value of the SHA1 Checksum column in the user interface matches the output.
  • Linux: sha1sum <cloudagent_linux.x64_1.33.0.zip>

This agent software ZIP file is now saved on your host.

Download Using a Web Browser

You can also download the agent software ZIP file using a Web Browser. This is an alternative method provided in case you don’t have access to the Oracle Management Cloud User Interface or you have internet, network or firewall restrictions.

Click one of the following platform-specific links of your choice:

When downloading the agent software using this method, you still need to connect to the Oracle Management Cloud to gather parameters values before you start installing the agent. To gather the required parameters values, you need to perform the following:

  1. On the Oracle Management Cloud home page, click the OMC Navigation icon on the top-left corner to view the Management Cloud navigation pane, if it isn’t already displayed.

  2. Select Agents under Administration.

  3. On the Oracle Management Cloud Agents page, click the Download tab.

    The Agent Software Download page is displayed.

  4. Select the agent type from the Agent Type drop-down list, and select the operating system that the agent will be installed on from the Operating System drop-down list.

    The agent software link for the agent you’ve selected is displayed.

  5. Make a note of the TENANT_NAME and OMC_URL parameter values displayed under the agent link. When installing the agent, you’ll have to update the response file with these values. See Understanding Response Files

Extract the Agent Software ZIP File

To extract the agent software ZIP file, perform the following steps:
  • Navigate to the directory where you have downloaded the agent software ZIP file.

  • Run the following command to unzip the file: unzip <your zip file name>

  • For example, unzip cloudagent_linux.x64_1.31.0.zip

Create Registration Keys

You need a registration key to install Oracle Management Cloud Agents.

A registration key is issued against your identity domain. You can create a new registration key and use that key for installing a new agent by updating the response file and specifying the AGENT_REGISTRATION_KEY=<NewKeyValue> parameter. The registration key is only used during installation. Once an agent is installed with the registration key, that key can be removed from Oracle Management Cloud.

To create a registration key:

  1. On the Oracle Management Cloud home page, click the global navigation menu on the top left, then click Agents under Administration.

  2. On the Oracle Management Cloud Agents page, click the Registration keys tab.

    The Registration Keys page displays a list of all registration keys.

  3. Enter the required details in the Registration Keys page:

    1. In the Name field, specify a name to identify the registration key.

    2. In the Registration Limit field, enter a number that indicates the maximum number of agents, data collectors, and gateways that can be associated with the registration key.

    3. Click Create New Key.

    A new registration key is created. You can now pass the value of this key to the AgentInstall script at the time of installation.

You can also download a registration key. For more information, see Manage Registration Keys.