Decommissioning Oracle Management Cloud Stack with Bottom-Up Approach

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

Nassyam Basha
Oracle Developers
6 min readMar 11, 2019

--

Introduction

Consider for some instance is to destroy all the Oracle Management Cloud service with the repository, in such cases always there will be a method in place. This article helps how to remove each of the components to delete the OMC instance safely with proper protocols in the Bottom-Up Approach.

This practice usually happens in the testing phase before production go-live of Oracle Management Cloud.

OMC Components

In Oracle Management Cloud we will list out the components we are going to remove in order with proper methodology. There is always parent and child relationship when the components are depending on each other, so we need to be careful to ensure we have not left any components before removing Oracle management cloud instance.

  1. Disabling Licenses for Entities
  2. Deleting Entities of OMC
  3. Removing OMC Agent
  4. Removing OMC instance from Oracle Cloud

Disabling Licence for Entities

When added entities to Oracle Management Cloud, we have also assigned the license type (EE or SE) for each entity, before deleting the entities it is better to disable the licenses for all the entities. Go to OMC console and navigate to “Management Cloud → Administration → Entity Configuration.”

Navigation to Entity Configuration

In the entity’s configuration panel, select on the licenses section so that we can view the number of licenses enabled for entities in Oracle Management Cloud.

Number of Licensed entities

Click on the number under Edition (Standard or Enterprise) and then change the option to “Set All to None.”

Change License Edition

Then save the changes, so that it will update in the repository.

Save the licenses information

After saving the changes, entities are none for Enterprise Edition and all entities back to unlicensed.

Latest status of Licenses.

Deleting Entities of OMC

After disabling licenses the next step is to remove the entities or targets from the Oracle management cloud as no more part of the configuration. Navigate to the same console as above “Management Cloud à Administration à Entity Configuration.” Select the tab “Delete Entities.”

Delete Entities

In drop down box of “Select entities” — Select all the entities to delete. To delete the entities, we can select the entity types filters.

Entity Filtering

The entities to be removed were filtered, recheck all the entities before proceeding to the next step.

Delete Entities — filtered

In the next screen, we can see the number of entities with the entity type and then click on “Delete.”

Deleting entities — Final

Final Confirmation will be prompted, proceed to delete. After submitting a request, we can see the delete job was successful.

Final confirmation for deleting entities
Status of Delete Entities

To verify the entities which deleted, stay on the same console navigation. From “Delete Entities” console click on “Recently Deleted” with the time frame.

Recently deleted entities

Removing Cloud Agent

So far we have deleted all the entities, and now we will uninstall the agent from all the targets of the entities dependent. To do that, we have to stop the agent on all the targets.

Connect to the target host machine and stop the OMC agent using the below syntax and command follows.

$ <$OMC_AGENT_HOME>/bin/omcli stop agent

Agent Stopped for all the targets

After stopping the agent, Then go to OMC console and navigate to “Management Cloud → Administration → Agents.”

Navigation to Agents

From the Oracle Management Cloud Agents console, click on “Cloud Agents” tab. Here we can see all the list of the agents which registered with OMC. Click the hamburger menu of each tab (or) we can deinstall all the agents with a single click of “Deinstall” as shown below.

Deinstall Agents

In this article, our goal is to remove all the OMC setup. Hence proceed to deinstall all the agents.

Confirmation — Deinstall Agents

The agent deinstall process has started as per the status bar information.

Agents deletion — Job status

We can see the outstanding status of Agent from the section column.

Status of an agent from version column.

In another way, click on the hamburger menu of each agent and click for “View Details,” this option helps to track the live status of the agent deletion.

Agent view details
In Detail Agent View with current status

After completion of the agent uninstallation, remove the target agent software empty directory as part of the cleanup process.

Remove directory structure from all the targets

Removing OMC instance from Oracle Cloud

We have removed the entities and also removed the agents from the Oracle management cloud. Now the OMC consists of null targets or entities. This task will be considered as the final task as part of the decommissioning of the Oracle management cloud. Navigate to “Services → Management Cloud” — we can view the list of the OMC services created.

Navigation to OMC Service

Under the instances tab, click on the hamburger menu of the OMC service and click on delete the OMC instance.

Deleting the OMC instance

OMC service console will prompt for final confirmation, click for “Force service deletion” to avoid PaaS script failures if any.

Final confirmation of OMC instance

OMC service terminated for no more use, and the deletion process starts immediately.

OMC instance termination & deletion

Summary

We’ve seen how to decommission Oracle Management Cloud service in the Bottom-Up approach method starting from the licenses, entities, agent uninstallation and finally the Oracle Management Cloud service with step by step instructions.

Authors Bio

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/

--

--