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:
It is recommended not to deploy cloud agents as a
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:
On your Linux host, navigate to the gateway installation directory where you have saved the
gateway.rspresponse file using any standard editor.
Enter values for the mandatory parameters:
Based on your requirement, edit the optional parameters if the default values are not in line with your best practices.
AgentInstallscript passing the parameter
EXECUTE_PREREQ=trueusing the command line interface.
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.
./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>.logfor more details.