Description:
This guide provides a detailed, step-by-step process for installing and configuring the Oracle Enterprise Manager (OEM) 13.5 Management Agent on target servers. It starts with the initial OMS login and environment setup, followed by downloading the agent image for the correct platform using emcli. The blog then walks through transferring the agent image to target hosts, preparing the response file (agent.rsp), deploying the agent with agentDeploy.sh, and performing necessary post-installation tasks. Special emphasis is placed on securing the agent using emctl secure agent and verifying its operational status. Clear commands, sample outputs, and configuration file entries are provided for each step to help administrators perfor m the installation without missing critical actions.
OEM Installation:
Follow up below link for OEM installation step by step explanation.
Agent Installation:
Step 1:
Login to the OMS server
Set the OMS.env and navigate to <middleware_home>/bin and execute below command.
[oracle@OEM bin]$ ./emcli login -username=sysman -password=password1
Login successful
[oracle@OEM bin]$ ./emcli sync
Synchronized successfully
[oracle@OEM bin]$ ./emcli get_supported_platforms
———————————————–
Version = 13.5.0.0.0
Platform = Linux x86-64
———————————————–
Platforms list displayed successfully.
Step 2:
[oracle@OEM bin]$ ./emcli get_agentimage -destination=/tmp/agentimage -platform=”Linux x86-64″ -version=13.5.0.0.0
=== Partition Detail ===
Space free : 19 GB
Space required : 1 GB
Check the logs at /u01/app/oracle/gc_inst/em/EMGC_OMS1/sysman/emcli/setup/.emcli/get_agentimage_2025-08-14_06-22-19-AM.log
Downloading /tmp/agentimage/13.5.0.0.0_AgentCore_226.zip
File saved as /tmp/agentimage/13.5.0.0.0_AgentCore_226.zip
Downloading /tmp/agentimage/13.5.0.0.0_Plugins_226.zip
File saved as /tmp/agentimage/13.5.0.0.0_Plugins_226.zip
Downloading /tmp/agentimage/unzip
File saved as /tmp/agentimage/unzip
Executing command: /tmp/agentimage/unzip /tmp/agentimage/13.5.0.0.0_Plugins_226.zip -d /tmp/agentimage
Archieving agentImage and plugins.
Exit status is:0
Agent Image Download completed successfully.
[oracle@OEM bin]$
Step 3:- Server copy the agent file to all target server and unzip it.
[oracle@OEM agentimage]$ pwd
/tmp/agentimage
[oracle@OEM agentimage]$ ls -lrt 13.5.0.0.0_AgentCore_226.zip
-rw-r–r–. 1 oracle dba 788151257 Aug 14 06:22 13.5.0.0.0_AgentCore_226.zip
[oracle@xomp-oem01 agentimage]$
[oracle@OEM agentimage]
Scp /tmp/agentimage13.5.0.0.0_AgentCore_226.zip username/<target-host>
Connect to target host and follow the below steps:
Step 4:-
[oracle@Target soft] unzip 13.5.0.0.0_AgentCore_226.zip
unzip 13.5.0.0.0_AgentCore_226.zip
Archive: 13.5.0.0.0AgentCore_226.zip
inflating: unzip
inflating: agentDeploy.sh
inflating: agentimage.properties
inflating: agent.rsp
extracting: agentcoreimage.zip
Add the following entry in agent.rsp file
Step 5:-
[oracle@Target soft] vi agent.rsp
#——————————————————————————-
#EM_INSTALL_TYPE=”AGENT”
EM_INSTALL_TYPE=”AGENT”
OMS_HOST= <OMS-server-hostname-entry>
EM_UPLOAD_PORT=4903
AGENT_BASE_DIR=/usr/local/oracle/soft/agent_13.5_new
AGENT_INSTANCE_HOME=/usr/local/oracle/soft/agent_13.5_new/agent_inst
AGENT_PORT=3872
ORACLE_HOSTNAME=<target/local-server-hostname-entry>
“agent.rsp” 75L, 4586C
Run the agentDeploye script
Step 6:-
[oracle@Target soft]
/usr/local/oracle/soft/agentDeploy.sh RESPONSE_FILE=/usr/local/oracle/soft/agent.rsp
Step 7:-
Post Installation
Will suggest the execute root.sh after the “Agent Configuration completed successfully” message. –> we need to run in as root user.
Once successfully completed the Agent installation we need to run the secure agent from target server.
Navigate to Agent instance home:-
[oracle@Target soft]$ cd /usr/local/oracle/soft/agent_13.5_new/agent_inst/bin
[oracle@Target bin]$ ./emctl secure agent
Oracle Enterprise Manager Cloud Control 13c Release 5
Copyright (c) 1996, 2021 Oracle Corporation. All rights reserved.
Agent successfully stopped… Done.
Securing agent… Started.
Enter Agent Registration Password :
Agent successfully restarted… Done.
Securing agent… Successful.
[oracle@Target bin]$ ./emctl status agent
Oracle Enterprise Manager Cloud Control 13c Release 5
Copyright (c) 1996, 2021 Oracle Corporation. All rights reserved.
—————————————————————
Agent Version : 13.5.0.0.0
OMS Version : 13.5.0.0.0
Protocol Version : 12.1.0.1.0
Agent Home : /usr/local/oracle/soft/agent_13.5_new/agent_inst
Agent Log Directory : /usr/local/oracle/soft/agent_13.5_new/agent_inst/sysman/log
Agent Binaries : /usr/local/oracle/soft/agent_13.5_new/agent_13.5.0.0.0
Core JAR Location : /usr/local/oracle/soft/agent_13.5_new/agent_13.5.0.0.0/jlib
Agent Process ID : 2336827
Parent Process ID : 2336604
Agent URL : https://<target-host-name>:3872/emd/main/
Local Agent URL in NAT : https://<target-host-name>:3872/emd/main/
Repository URL : https://<OEM-host-name>:4903/empbs/upload
Started at : 2025-08-14 06:55:53
Started by user : oracle
Operating System : Linux version 4.18.0-553.51.1.el8_10.x86_64 (amd64)
Number of Targets : 5
Last Reload : (none)
Last successful upload : 2025-08-14 06:57:04
Last attempted upload : 2025-08-14 06:57:04
Total Megabytes of XML files uploaded so far : 0.01
Number of XML files pending upload : 0
Size of XML files pending upload(MB) : 0
Available disk space on upload filesystem : 37.33%
Collection Status : Collections enabled
Heartbeat Status : Ok
Last attempted heartbeat to OMS : 2025-08-14 06:56:57
Last successful heartbeat to OMS : 2025-08-14 06:56:57
Next scheduled heartbeat to OMS : 2025-08-14 06:57:57
—————————————————————
Agent is Running and Ready
Conclusion:
By following these steps, administrators can ensure a smooth and secure deployment of the OEM 13.5 Management Agent across target environments. This installation process not only registers the agent correctly with the OMS but also secures communication channels, enabling reliable monitoring, management, and metric collection. With the agent running and ready, the OEM environment can fully leverage its monitoring and automation capabilities, ensuring consistent visibility and proactive management of enterprise systems.
