1. Installing and Managing Oracle Management Cloud Agents
  2. Install Oracle Management Cloud Agents
  3. Install a Data Collector
  4. Data Collector: Typical Installation

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. The AgentInstall 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 the AgentInstall script. If that’s not the case, then you must pass the AGENT_RSP_FILE parameter in the command line with the location of the response file when you run the AgentInstall 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:

  1. Identify a host in your data center with Internet access to Oracle Management Cloud.

  2. Ensure that you have performed the steps listed in Prerequisites for Installing a Data Collector.

  3. 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 the Agentinstall 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.

  4. 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 the agent.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.

  5. 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.