Cloud Agents: Typical Installation

This section discusses the typical installation of cloud agents.

  • It is recommended not to use root user to install cloud agents.

  • You install cloud agents 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 the Cloud Agent Specifying Parameters in the Command Line.

  • If you have a proxy server or using custom certificates, be sure to check the steps listed in Install the Cloud Agent Over a Proxy Server and Install the Cloud Agent with Custom Certificates.

To perform a typical installation:

  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 Cloud Agents.

  3. Log on to the host where you will install the cloud agent and navigate to the directory where you have already extracted the cloud agent software ZIP file.

    For example, if you extracted the ZIP file to a directory named cloud_agent under the /u01/stage directory on your host, then the Agentinstall script will be present in the /u01/stage/cloud_agent directory after the ZIP file is extracted. Navigate from your present working directory to the /u01/stage/cloud_agent directory.

  4. Edit the agent.rsp response file.

    Ensure you have updated the agent.rsp response file and specified the correct values of the parameters listed in Registration Parameters and Communication Parameters.

    Based on your requirement, you may also need to update the agent.rsp response file with values of the parameters listed in Optional Parameters.

    Once you are done editing, save the agent.rsp response file under the same directory where AgentInstall script is located.

    If you have a proxy server or using custom certificates, be sure to check the steps listed in Install the Cloud Agent Over a Proxy Server and Install the Cloud Agent with Custom Certificates.
  5. Run the agent installation script to install a cloud agent.

    • If you are installing a cloud agent on a UNIX-based host:

      ./AgentInstall.sh

      Alternatively, you can run: sh AgentInstall.sh

    • If you are installing a cloud agent on a Windows host, right-click and select Run as administrator to open an Administrator command prompt and run the following:

      AgentInstall.bat

Your cloud agent installation is now complete. Next step is to Verify the Cloud Agent Installation.