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

Gateway: Typical Installation

This section discusses the typical installation of a gateway.

  • It is recommended not to use root user to install a gateway.

  • You install a gateway 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 (gateway.rsp) or they can be passed along in the command line.

  • A typical installation assumes the gateway.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 Gateway 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 a Gateway Over a Proxy Server and Install a Gateway 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 a Gateway.

  3. Log in to the host where you will install a gateway and navigate to the directory where you have already extracted the gateway software ZIP file.

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

  4. Edit the gateway.rsp response file.

    Ensure you have updated the gateway.rsp response file and specified the correct values of the parameters listed in the Registration Parameters for Installing a Gateway.

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

    Once you are done editing, save the gateway.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 a Gateway Over a Proxy Server and Install a Gateway with Custom Certificates.

  5. Run the agent installation script to install a gateway.

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

      ./AgentInstall.sh

      Alternatively, you can run sh AgentInstall.sh

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

      AgentInstall.bat

      Note:

      The user installing the agent must have permissions to act as part of the operating system, adjust memory quota for a process, replace process level tokens, and log on as a batch job. To verify the permissions, from the Start menu, click Settings, then click Control Panel. From the Control Panel window, click Administrative Tools, and then click Local Security Policy. Expand the Local Policies folder and open the User Rights Assignment folder.

Your gateway installation is now complete. Next step is to Verify the Gateway Installation.