OEM 13c: Agent is out-of-sync with repository. This most likely means that the agent was reinstalled or recovered

Understanding OEM 13c Agent Out-of-Sync Errors

In Oracle Enterprise Manager (OEM) 13c, the Management Agent acts as the vital communication bridge between target host systems and the Management Repository (OMR). When an agent status throws the error "Agent is out-of-sync with repository. This most likely means that the agent was reinstalled or recovered," it signifies a mismatch in sequence numbers or timestamp tokens between the agent state and the Management Server (OMS).

This situation usually occurs during:

  • Host-level server recovery or disaster recovery tests.

  • Unscheduled agent re-installations without clearing old target metadata.

  • Long periods of network disconnection between the host and OMS.

  • Abrupt server shutdowns causing local state corruptions in the agent's filesystem.

Prerequisites & Initial Checks

Before starting the resynchronization process, log in to the affected target node via SSH as the Oracle installation owner and run an initial status check:

$ emctl status agent

If the status output confirms that the agent is blocked or marked out-of-sync, follow the step-by-step resolution steps below.

Step-by-Step Resolution Guide

Step 1: Attempt Manual Upload

First, try forcing a manual data upload from the target node to see if the OMS accepts the current sequence:

$ emctl upload agent

If the upload succeeds without errors, verify the status again. If it fails with a blockage warning, proceed to the OEM Console resynchronization.


Step 2: Navigate to the Blocked Agent in OEM Console

  1. Log into your Oracle Enterprise Manager 13c Cloud Control web console using an administrator account.

  2. Go to Setup > Manage Cloud Control > Agents.

  3. From the list of monitored agents, filter by selecting the Agent Unreachable or Blocked status category.


Step 3: Initiate Target Resynchronization

  1. Locate and click on the specific hostname corresponding to the blocked agent.

  2. From the Agent Dropdown Menu (top left of the agent home page), hover over Target Setup and click Resynchronization.

  3. Click Continue to confirm the action. OEM will submit an internal job to align the sequence keys between the repository and the host agent.


Step 4: Verify and Force Final Upload

Once the console resynchronization job completes successfully, switch back to your terminal session on the target server:

 $ emctl status agent

$ emctl upload agent


Below are the exact steps I followed to overcome the issue I faced.

On a Friday morning shift, during my monitoring routine I found the EM agent was out of sync in my tableau server.


A quick surf on the internet landed me on couple of Oracle's MOS documents and I was able to solve the issue. Below are the step by step process to fix the issue.

1. Try to upload the agent if in case it was recently recovered or reinstalled. If upload's successfully, then the issue is resolved else continue the remaining steps


2. Log in to the OEM console and select the Agents

3. Once you pulled the agents, select the 'Agent Unreachable' option

4. Now select the host against the blocked agent

5. From the LOV, choose the resynchronization option and continue the process


6. Once the sync is done, check the agent status

7. Now try to upload the agent. That's all and the issue is fixed.


****************************நன்றி****************************







Comments

Popular posts from this blog

Common R12.2 adcfgclone Issues

REP-3000: Internal error starting Oracle Toolkit

Error 404 -- Not Found From RFC 2068 hypertext Transfer Protocol -- HTTP/1.1