Oracle Management Cloud — Agent Deployment

Authors: Monowar Mukul (OCM) & Nassyam Basha (Oracle ACE Director, OCM)

Introduction

In the first article, we’ve seen how to create and provision Oracle Management Cloud instance. In this article, we will follow the next steps to download and Install the agent at the target side for Oracle Management cloud. In this example, the target will be a two-node RAC Cluster.

OMC Agent

Oracle Management Cloud agent plays a major and key role in sending analytical data to the OMC server for the beautiful and graphical few in the attractive graphical user interface. We will see in next articles how analytics applied and how gathers the data. In this article, we will purely focus on agent installation as well as how to register the keys.

To download the agent software for OMC, Access to the Oracle management cloud portal and follow the navigation as “Dashboard → services → Management Cloud.” This navigation redirects us to OMC instance and also to the OMC interface.

Navigation to Management Cloud Page

From the OMC service access to the OMC portal as below.

OMC Portal Access

Now the OMC URL will take us to the OMC interface to administer, monitoring and manage the management cloud. Initially, we will download the agent software for the required platform from OMC interface with the navigation “Management Cloud à Administration à Agents”

OMC Interface

In Oracle Management Cloud Agent page, we are going to perform two operations.

1. Registering the keys
2. Download the Agent software
3. Installation of the Agent.

Creating the Registration Keys

Initially, we will create the registration keys — Registration keys issued against the identity domain and these keys will be used at the time of Agent Installation. After the creation of registration keys and ensure the status is in a VALID state.

Creating registration keys for OMC agents

After the creation of registration keys, follow the navigation to download the keys using the navigation “Action Menu → Manage Registration Keys” It will display all the registration keys was created so far. Select the appropriate registration key and download.

Download Agent Software

Now we will move forward with the next step to download the Agent file for the required platform. In the same OMC Agents, We will download the agent from the tab “Download” tab by selecting the i) agent type ii) Operating system.

Download the platform based agent software.

There is notable information in download page to keep the values of

1. TENANT_NAME
2. OMC_URL
3. AGENT_REGISTRATION_KEY — These values will be used at the time of Agent Installation.

Save the information related to OMC, TENANT Names

Installing OMC Agent

After downloading the Agent software, we will move to the target server and ensure the checksum value is same as per the above image.

[oracle@racdb1 tmp]$ unzip cloudagent_linux.x64_1.35.0.zip -d /u01/app/OMC
Archive: cloudagent_linux.x64_1.35.0.zip
inflating: /u01/app/omcagent/unzip
inflating: /u01/app/omcagent/AgentDeployment.sh
inflating: /u01/app/omcagent/agentimage.properties
inflating: /u01/app/omcagent/agent.rsp
inflating: /u01/app/omcagent/agent_software_build.xml
extracting: /u01/app/omcagent/agentcoreimage.zip
inflating: /u01/app/omcagent/AgentInstall.sh

From the extracted folder we can see the file with “agent.rsp”, we will make a copy of the file so that we won’t disturb the original file.

$ cp agent.rsp agent.rsp.bkp
$ vi agent.rsp

In the agent response file, we will entitle the information of

1. TENANT_NAME
2. OMC_URL
3. AGENT_REGISTRATION_KEY

Validate the values of the response file

After completion of the changes in agent.rsp file we will run the agent installer and also we will by pass the response file as below.

Run Agent Installation as oracle OS user

[oracle@racdb1 OMC]$ ./AgentInstall.sh AGENT_RSP_FILE=agent.rsp
Unzipping agent software, this may take some time…
Installing Cloud Agent…
Cloud Agent parameter validation started…
Cloud Agent pre-requisite checks started…
Cloud Agent base directory creation started…
Security artifacts download started…
Cloud Agent setup started…
Registering Cloud Agent…
Starting Cloud Agent…
Cloud Agent started.
Cloud Agent installation completed.
Cloud Agent post installation checks started.
Cloud Agent is up and running.
Cloud Agent is communicating to Oracle Management Cloud.
Cloud Agent is monitored in Oracle Management Cloud.
Cloud Agent post installation checks completed.
To start Cloud Agent upon Operating System restart include ‘/u01/app/OMC/omcagent/agent_inst/bin/omcli start agent’ in the start-up scripts.
For further details please refer http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/management-cloud&id=deploy_agent.

Check Agent Status

Export the agent binaries to the PATH to access the omcli executable with associated files.

[oracle@racdb1 OMC]$ export PATH=$PATH:/u01/app/OMC/omcagent/agent_inst/bin

Agent Status

Execute root script

Login to root user and execute the root.sh script to update the repository.

[opc@racdb1 app]$ sudo su -
Last login: Mon Nov 5 23:32:04 UTC 2018 on pts/0
[root@racdb1 ~]# /u01/app/OMC/omcagent/core/1.35.0/root.sh
/etc exist
Creating /etc/oragchomelist file…
/bin/chown: invalid group: `oracle:#OSDBA_GROUP#’

Expanding OMC Cloud Agent on 2nd Node

So far we have completed all the required steps on Node 1, the same and all the steps we need to execute on the second node as well. Assuming we have installed the agent on the 2nd node and check the status of OMC agent on a 2nd node as below.

Agent Status from the 2nd node of cluster

Verify OMC Server after Agents Deployment

We have deployed the agent on both the nodes of the RAC cluster, now we will check the status in OMC server console with the navigation “OMC Console à Administration à Agents”. Verify that the cloud agents are running on all the nodes for RAC Configuration.

Agents latest status from OMC

Question? How the target will communicate to the OMC server? Here the registration key plays a major role in authentication from target to server. Likewise, the SSH keys work in authentication from one server to another server.

Summary

We’ve seen how to register the keys for agents and also downloading the required platform based agent and installation on both the nodes of RAC and finally we have seen the agents status from the OMC console with step by step instructions.

Authors

Nassyam Basha is a Database Administrator. He has around ten years of experience as a Production Oracle DBA, currently working as Database Expert with eProseed KSA. He holds a master’s degree in Computer Applications from the University of Madras. He is an Oracle 11g Certified master an Oracle ACE Director. He actively participates in Oracle-related forums such as OTN with a status of Super Hero, Oracle support awarded as “Guru” and acting as OTN Moderator and written numerous articles with OTN and on Toad World. He maintains an Oracle technology-related blog, www.oracle-ckpt.com and can be reached at https://www.linkedin.com/in/nassyambasha/

Monowar Mukul is currently working as a Principal Oracle Database Specialist. I am an Oracle certified Master (Oracle 12c Certified Master Administration, Oracle 12c Certified Master MAA and Oracle 11g Certified Master Administration). He has been working as an Oracle DBA consultant over 17 years with Oracle MAA space for both Exadata and non-Exadata Systems, Oracle Cloud Space and SOA Middleware. He worked across various business sectors including tertiary education, energy, government, mining and transport in Australia. He demonstrated highly developed critical thinking and analytical skills working as a Principal Oracle Database Specialist. You can find more details about him and his work achievements at https://www.linkedin.com/in/monowarmukul/