Prerequisites for Installing a Gateway

Before you install a gateway, you must meet a set of prerequisites.

This section lists the key considerations and prerequisites for installing a gateway and covers the following:

General Guidelines

  • It is recommended not to deploy cloud agents as a root user.

  • Installing a gateway is an optional task. In your data center, if the hosts on which you want to install cloud agents have access to the Internet, either directly or through a proxy server, then you can skip installing a gateway. Typically, in large organizations that have an enterprise setup, access to Internet is controlled, and only a few hosts are configured as gateways through which other hosts access the Internet. This helps ensure the security of the setup against malicious cyber attacks.

  • Before proceeding, ensure that you understand and follow the generic prerequisites listed in Generic Prerequisites for Deploying Oracle Management Cloud Agents.

System and Port Requirements

The following table lists the system requirements to install a gateway.

RAM Kernel Parameters Port Number
8 GB Hard nofile 65536

Ulimit value for maximum user processes >=4000

4459 to 4479

Prerequisites Check Option

Before you install a gateway, you can check if you have met all the prerequisites to perform a seamless gateway installation. The AgentInstall.sh script reads the parameters values from the gateway.rsp response file and performs automated checks to ensure that your environment fulfills the basic requirements for the gateway installation.

Perform the following steps to run the prerequisites check:

  1. On your Linux host, navigate to the gateway installation directory where you have saved the gateway.rsp file.

  2. Open the gateway.rsp response file using any standard editor.

  3. Enter values for the mandatory parameters: TENANT_NAME, OMC_URL, and AGENT_REGISTRATION_KEY.

    Based on your requirement, edit the optional parameters if the default values are not in line with your best practices.

  4. Save the gateway.rsp response file.

  5. Run the AgentInstall script passing the parameter EXECUTE_PREREQ=true using the command line interface.

    For example, ./AgentInstall.sh|bat EXECUTE_PREREQ=true

    If the prerequisite check fails, the script stops with relevant error message.

    If the prerequisite check completes successfully, you get the following message:

    $ ./AgentInstall.sh EXECUTE_PREREQ=true
    Unzipping agent software, this may take some time...
    Installing Gateway...
    Executing Pre-requisite checks only for Gateway..
    Gateway parameter validation started...
    Gateway pre-requisite checks started...
    Pre-requisite checks successfully completed for [Gateway]. 

    Alternatively, you can pass the required parameter values using the command line interface to perform the prerequisite check.

    For example, ./AgentInstall.sh|bat TENANT_NAME=<TENANT_NAME> OMC_URL=<OMC_URL> AGENT_REGISTRATION_KEY=<AGENT_REGISTRATION_KEY> EXECUTE_PREREQ=true

    Please refer to the log file located under <AGENT_ZIP_FILE_EXTRACTED_DIRECTORY>/AgentInstall_<timestamp>.log for more details.