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.
This section covers the following:
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:
-
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.
-
Select Agents under Administration.
The Oracle Management Cloud Agents page is displayed.
-
On the Oracle Management Cloud Agents page, click the Action Menu on the top right corner of the page and select Download Agents.
The Agent Software Download page is displayed.
-
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 have selected is displayed.
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.
-
Click the agent software link to download the agent software ZIP file.
-
Linux:
sha1sum <cloudagent_linux.x64_1.33.0.zip>
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:
-
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.
-
Select Agents under Administration.
-
On the Oracle Management Cloud Agents page, click the Action Menu on the top right corner of the page and select Download Agents.
The Agent Software Download page is displayed.
-
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.
- Make a note of the
TENANT_NAME
andOMC_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
-
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:
-
On the Oracle Management Cloud home page, click the global navigation menu on the top left, then click Agents under Administration.
The Oracle Management Cloud Agents page is displayed.
-
On the Oracle Management Cloud Agents page, click the Action Menu on the top right corner of the page and select Manage Registration Keys.
The Registration Keys page displays a list of all registration keys.
-
Enter the required details in the Registration Keys page:
-
In the Name field, specify a name to identify the registration key.
-
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.
-
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.