Data Collector: Typical Installation
This section discusses the typical installation of a data collector.
-
It is recommended not to use
root
user to install a data collector. -
You install a data collector by running the
AgentInstall
script from the command line. TheAgentInstall
script reads a set of parameters that can be specified in a response file (agent.rsp
) or they can be passed along in the command line. -
A typical installation assumes the
agent.rsp
response file is saved under the same directory where you have saved theAgentInstall
script. If that’s not the case, then you must pass theAGENT_RSP_FILE
parameter in the command line with the location of the response file when you run theAgentInstall
script. See Install a Data Collector Specifying Parameters in the Command Line.
To perform a typical installation:
If you are installing the data collector without a gateway, then install the data collector on a host that has access to the Internet, either directly or through a proxy server.
To install the data collector, follow these steps:
-
Identify a host in your data center with Internet access to Oracle Management Cloud.
-
Ensure that you have performed the steps listed in Prerequisites for Installing a Data Collector.
-
Log on to the host where you will install the data collector and navigate to the directory where you have already extracted the data collector software ZIP file.
For example, if you extracted the data collector software ZIP file to a directory named
datacollector_agent
under the/scratch
directory on your host, then theAgentinstall
script will be present in the/scratch/datacollector_agent/
directory after the ZIP file is extracted. Navigate from your present working directory to the/scratch/datacollector_agent
directory.If you haven’t completed this step previously, see Download the Oracle Management Cloud Agent Software.
-
Edit the
agent.rsp
response file.When the data collector software ZIP file is downloaded and extracted, a sample response file,
agent.rsp
, is provided as a template. Ensure that you have updated theagent.rsp
response file and specified the correct values of the parameters listed in Registration Parameters for Installing Cloud Agents and Communication Parameters for Installing Cloud Agents based on your requirements.Also, ensure that you have updated the
agent.rsp
response file with the correct values of the data collector parameters listed in Data Collector Parameters. You may need to specify additional data collector parameters listed in Optional Data Collector Parameters based on your requirements. -
Run the agent installation script to install the data collector.
-
If you are installing the data collector on a UNIX-based host:
./AgentInstall.sh
Alternatively, you can run:
sh AgentInstall.sh
-
If you are installing the data collector on a Windows host, right-click and select Run as administrator to open an Administrator command prompt and run the following:
AgentInstall.bat
-
Your data collector installation is now complete. Next step is to Verify the Data Collector Installation.