Cloud Agent - alfredokriegdba.com

This post is about some useful commands to administer the OMC’s Cloud agent. The very first step is to install the OMC Cloud agent. You may refer to my previous post on how to install it here.

The omcli command is located at /agent_inst/bin.

I’m skipping these 3 basic commands start, stop and status.

Here we go!

– List the targets currently managed by the Cloud agent

$ ./omcli config agent listtargets

Oracle Management Cloud Agent

[hostname.localdomain:1302, Lama]

[hostname.localdomain, omc_host_linux]

– Get the TimeZone of the server where the Cloud agent is running

$ ./omcli config agent getTZ

Oracle Management Cloud Agent

US/Eastern

– Get a detailed output of the Cloud agent scheduler

$ ./omcli status agent scheduler

Oracle Management Cloud Agent

—————————————————————

Number of currently running scheduled items :: 0

Number of currently ready scheduled items :: 0

Number of scheduled items :: 57

Schedule Attempts Delay Percentage :: 0.000%

Running entries::

Ready entries::

Scheduled entries::

2017-03-31 14:32:58.968 : HeapMonitorTask

…

2017-03-31 22:34:14.667 : PurgeTargetEvents

2017-03-31 22:35:47.885 : PurgeADR

2017-04-01 13:34:20.810 : EventStatusPurge

—————————————————————

Agent is Running and Ready

– Get a summary of the Cloud agent’s scheduler

$ ./omcli status agent scheduler -summary

Oracle Management Cloud Agent

—————————————————————

Number of currently running scheduled items :: 0

Number of currently ready scheduled items :: 0

Number of scheduled items :: 57

Schedule Attempts Delay Percentage :: 0.000%

—————————————————————

Agent is Running and Ready

– Dump the internal state of the agent [option component name]

$ ./omcli dumpstate agent

Oracle Management Cloud Agent

Generated file: /u01/omc/infra/agent_inst/sysman/emd/dumps/SystemDump_1490985620656.xml

– Dump internal information of all components of the Cloud agent

$ ./omcli dumpstate agent -dump_full_state

Oracle Management Cloud Agent

Generated file: /u01/omc/infra/agent_inst/sysman/emd/dumps/SystemDump_1490985775823.xml

– Add entities to the Cloud agent using JSON template

$ ./omcli add_entity agent /home/oracle/omc_weblogic.json

Oracle Management Cloud Agent

Operation Succeeded: Accepted 2 of 2 entities for processing.

– Delete entities from the Cloud agent using JSON template

$ ./omcli delete_entity agent /home/oracle/omc_weblogic.json

Oracle Management Cloud Agent

Request for removing the entities was accepted for processing.

This is just a small taste of all the options built into the Oracle’s Cloud agent. For more information about all the options refer to Oracle’s documentation.

https://docs.oracle.com/en/cloud/paas/management-cloud/gfadg/omcli-command-options.html

Thanks,

Alfredo

This is my first experience with the Oracle Cloud, in particular with Oracle Management Cloud (OMC). In this first post I will guide you through the installation of the Cloud Agent in a Linux host.

First you have to login to OMC and click on the navigation icon below.

It’ going to open the navigation screen that contains 4 sections; Home, Cloud Services, Explorers and Administration.

In the Administration section click on Agents.

In this page we are looking into 2 important items for us. Registration Keys and Download.

The way I see the Registration Keys is like the Agent Registration password in OEM 13c. You need a valid Registration Key to deploy your Cloud Agent. So, click on that link and verify that you have a Registration Key; if not, you can create one.

Then proceed to download the agent by clicking on the Download link.

In order to install the Cloud Agent in the Linux host there are some pre-reqs to be met.

First verify that you have acl and libaio.i686 packages installed.

# rpm -q acl

acl-2.2.49-6.el6.x86_64

# rpm -qa|grep libaio

libaio-devel-0.3.107-10.el6.x86_64

libaio-0.3.107-10.el6.x86_64

libaio-0.3.107-10.el6.i686

Then move the AgentInstall.zip previously downloaded into an staging directory and unzip it.

$ mkdir –p /home/oracle/omc

$ mv AgentInstall.zip /home/oracle/omc

$ cd /home/oracle/omc

$ unzip AgentInstall.zip

$ $ ls

AgentInstall.bat AgentInstall.sh AgentInstall.zip README

Create a folder to install the Cloud Agent.

$ mkdir –p /u01/omc/infra

Verify that the server has the FQN configured (name.domain_name).

$ hostname

ol6-121-plug.localdomain

Finally install the Cloud Agent.

$ ./AgentInstall.sh AGENT_TYPE=cloud_agent AGENT_REGISTRATION_KEY=R******************1 AGENT_BASE_DIR=/u01/omc/infra AGENT_PORT=1302 ORACLE_HOSTNAME=ol6-121-plug.localdomain

WARNING: The current cURL version 7.19.7 does not support TLS1.2 protocol; the downloader script will attempt to continue but may not work. Please install 7.49.1 or later versions of cURL for error-free execution.

Downloading lama agent software …

Generating emaas.properties …

Extracting Agent Software …

Installing the Agent …

Registering the Agent …

Downloading Certificates …

Configuring the Agent …

Cleanup temporary files …

Then you have to run the root script required after the installation.

# /u01/omc/infra/core/1.15.0/root.sh

/etc exist

/u01/omc/infra/core/1.15.0

Check the status of the Cloud Agent.

$ ./omcli status agent

Oracle Management Cloud Agent

—————————————————————

Version : 1.15.0

State Home : /u01/omc/infra/agent_inst

Log Directory : /u01/omc/infra/agent_inst/sysman/log

Binaries Location : /u01/omc/infra/core/1.15.0

Process ID : 9828

Parent Process ID : 9790

URL : https://ol6-121-plug.localdomain:1302/emd/main/

Started at : 2017-03-20 20:49:15

Started by user : oracle

Operating System : Linux version 3.8.13-26.2.2.el6uek.x86_64 (amd64)

Data Collector enabled : false

Sender Status : FUNCTIONAL

Gateway Upload Status : FUNCTIONAL

Last successful upload : 2017-03-20 21:04:39

Last attempted upload : 2017-03-20 21:04:38

Pending Files (MB) : 0.01

Pending Files : 14

Backoff Expiration : (none)

—————————————————————

Agent is Running and Ready

Now if you go to the OMC portal, the agent will show up automatically.

Want to learn more about Oracle Management Cloud? There’s a free hands on lab “Cloud Experience” at Collaborate 2017 for all attendees on Wednesday 4/5/17.

Thanks,

Alfredo