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