Focus On Oracle

Installing, Backup & Recovery, Performance Tuning,
Troubleshooting, Upgrading, Patching

Oracle Engineered System


当前位置: 首页 » 技术文章 » Cloud

OMC - How to Install Gateway Agent

OMC(Oracle Management Cloud)就是Oracle的管理云,是集AI、BigData于一身的数字化运维管理解决方案。

Prerequisites for Installing a Gateway

General Prerequisites
If you have subscriptions to IT Analytics or Log Analytics, and if you want to collect data from an existing on-premise Oracle Enterprise Manager setup, then you must have an existing deployment of any one of the following in your data center.

Oracle Enterprise Manager Cloud Control 12.1.0.3
Oracle Enterprise Manager Cloud Control 12.1.0.4
Oracle Enterprise Manager Cloud Control 12.1.0.5
Oracle Enterprise Manager Cloud Control 13.1.0.x
Oracle Enterprise Manager Cloud Control 13.2.0.x

Ensure that you deploy the Oracle Management Cloud agents in the following sequence:

Gateway不是必须的,如果要装,确保按照下列顺序去安装。

1. Gateway
2. Data collector
3. Cloud agents

TLS 1.2 version is supported for Oracle Management Cloud agents.

Ensure that the noexec option has not been set on the agent home mount point.

Permissions Required to Install an Agent on Windows
You must deploy an agent on Windows as an administrator and ensure that necessary permissions are set as follows:

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 and set the following permissions:

Act as part of the operating system
Adjust memory quota for a process
Log on as a batch job
Replace process level tokens

Permissions required on the Agent Base Directory
when an agent is upgraded, you need not run the root.sh script after the upgrade to restart the agent host machine.

A symbolic link is defined in <AGENT_BASE_DIRECTORY> that points to the latest version of the agent Oracle Home directory.

Due to this, <AGENT_BASE_DIRECTORY> must have the following permissions:

The agent install user must be the owner of the directory.
Either the root user (in case of Unix-based systems) or the agent install user can be the owner of the agent base parent directories.
Only the owners of <AGENT_BASE_DIRECTORY> and its parent directories should have write permissions on those directories.

Supported Operating Systems and Software Packages

Red Hat Enterprise Linux 5 or later (64 bit)
Red Hat Enterprise Linux 6 or later (64 bit)
Red Hat Enterprise Linux 7 or later (64 bit)
Oracle Enterprise Linux 5 or later (64 bit)
Oracle Enterprise Linux 6 or later (64 bit)
Oracle Enterprise Linux 7 or later (64 bit)
SUSE Linux Enterprise Server 11 (x86_64)
AIX 6.1 or later
AIX 7.1 or later
Solaris 10 or later
Solaris 11 or later
Microsoft Windows 2008 Enterprise R2 (Intel 64-bit, Developer) and later
Microsoft Windows Server 2012 Standard (64 bit)
Microsoft Windows 2012 Standard R2 (Intel 64-bit, Developer) and later

For detailed information regarding all the Prerequisites for Installation a Gateway Agent please refer to the document:
https://docs.oracle.com/en/cloud/paas/management-cloud/emaig/prerequisites-installing-gateway.html

Download the Gateway Agent Software

Login to Oracle Management Cloud Console

Click on the Navigation Menu --> Click on Administration --> Agents

Preparing the Response File for Gateway Installation

下载agent安装代理后,需要配置个agent.rsp文件,就是下面的表格里面的参数。

When the agent binary ZIP file is downloaded and extracted, a sample response file, agent.rsp, is provided as a template.

To install a gateway, you must specify a set of parameters in the response file.
We have parameters for Typical Installation of Gateway Agent and have parameters for Installation of Gateway Agent on Proxy Server.

Preparing the Response File for a Typical Installation of the Gateway

In this we have two category of parameters (1) Mandatory and (2) Optional

Mandatory Common Parameters for Installing Any Agent(这些参数是必须的)

Parameter

 Description

 TENANT_ID

 Name of the tenant where Oracle Management Cloud is running. The Identity Domain is the TENANT_ID.
You can get this information from your New Account welcome email or by navigating to Administration > Agents> Download, and selecting an agent type from the Agent Type drop-down list. The TENANT_ID value is displayed at the bottom of the page.

 UPLOAD_ROOT

 The absolute URL including the protocol that is required to connect to Oracle Management Cloud for uploading data for the specific TENANT_ID.
You can get this value, navigate to Administration > Agents > Download, and select an agent type from the Agent Type drop-down list. The UPLOAD_ROOT value is displayed at the bottom of the page.

 AGENT_REGISTRATION_KEY

 Key to validate the identity of the tenant and the authenticity of the installation.
You can get the registration key from Oracle Management Cloud Dashboard, by navigating to Administration > Agents> Registration Keys.

 AGENT_BASE_DIRECTORY

 

Empty directory where the agent must be installed on the host machine. If an empty directory is not specified, then a directory is created during installation.

Optional Common Parameters for Installing Any Agent(这些参数是可选的)

Parameter

Description

AGENT_RSP_FILE

This parameter is require if you have saved your response file at a location other than the location where you’ve extracted your agent binary Zip file. We need to provide the absolute path of the response file including the file name. Pass this parameter in the command line along with the Agentinstall.sh script, and not inside response file.

AGENT_PORT

This parameter is require if we need to install Agent on a specific port. If you don’t specify any value, the default port (3872) or an available port in the range 1830-1849 is used.
The port number to which the agent process will be bound. The AgentInstall script stops the installation process if this port is occupied at the time of installation.

ORACLE_HOSTNAME

The host name where the agent will be installed. If specified, the value is validated to check if the it resembles the agent host name and that it is neither an IP address nor a junk value. It must match the fully qualified domain name (FQDN) specified.
If you don’t specify any value, the AgentInstall script evaluates the host name using the INetAddress Java class methods.

IGNORE_VALIDATIONS

A flag to disable all validations and prerequisite checks.
Valid values: true or false
Default value: false
To ignore validations, change the value to true, IGNORE_VALIDATIONS=true.

IGNORE_ULIMIT_CHECK

A flag to disable ulimit checks (only on non-windows platforms).
Valid values: true or false
Default value: false
To ignore ulimit checks, change the value to true, IGNORE_ULIMIT_CHECK=true

Preparing the Response File for Installing the Gateway Over a Proxy Serve

Parameters for Installing Any Agent Over a Proxy Server

Parameter

Description

OMC_PROXYHOST

Address of your proxy server to be used for connection. Ensure that you don't pass the https:// value with the proxy host details
Example: www-proxy.company.com

OMC_PROXYPORT

Port of your proxy server.

OMC_PROXYUSER

User name required to access your proxy server.

OMC_PROXYPWD

Password required to access your proxy server.

OMC_PROXYREALM

Authentication realm (if any) to be used to access your proxy server.

Installing Gateway Agent

1. Run the "AgentInstall.sh" script to install the Gateway Agent.
2. The "agent.rsp" file should be present in the folder where "AgentInstall.sh" is available.

    把agent.rsp和AgentInstall.sh放在同一目录,然后安装即可

Verifying the Deployment of Gateways
1. Verify the Agent Status from the command prompt by running the command:
<AGENT_BASE_DIR>/agent_inst/bin/omcli status agent

 

Reference

https://docs.oracle.com/en/cloud/paas/management-cloud/index.html

https://docs.oracle.com/en/cloud/paas/management-cloud/emaig/workflow-installing-oracle-management-cloud-agents.html

http://www.oracle.com/webfolder/technetwork/tutorials/infographics/omc_quickview/index_text.html

How to Install Gateway Agent (Doc ID 2346298.1) 


关键词:omc cloud 

相关文章

Oracle Cloud Native Solutions
Oracle Kubernetes Engine
OMC vs ELK
Terraform,docker,wercker,k8s
Vagrant with oracle
Oracle自治数据仓库云
OMC - How to Install Gateway Agent
Oracle大数据之交互式快速参考
Oracle数据库云服务
Oracle数据库备份云服务
Oracle RAC and Third Party Cloud
Oracle Database Multilingual Engine(MLE)
Top