Oracle: Install Cloud Control Agent on Windows

Oracle Cloud Control needs an agent on every system to be able to do monitoring. On Linux and UNIX systems, it's quite easy to install an agent: it can be deployed using SSH connection.

But on Windows, this is normally disabled. So another way must be used.

Oracle shows how to install it using Cygwin on the target Windows server. I don't like this solution as I'm not a fan of installing additional software on a server which is not mine...

Download Windows agent

If you're not using Oracle Cloud Control on Windows (you should not - it's a big pain!), you'll need to download it from within Cloud Control. Only the agent for the platform you installed Cloud Control on is included by default. But you can always download and load agents for other platforms and older versions (i. e. when you're still having platforms which are supported only by older Cloud Control versions).

Unload agent from Cloud Control

Login to Cloud Control using the Enterprise Manager Command Line Interface emcli:

# emcli login -username=sysman

Then, sync the local cache:

# emcli sync

Check for supported platforms:

# emcli get_supported_platforms

My Cloud Control is running on Linux, and I added the Windows agent:

-----------------------------------------------
Version = 13.5.0.0.0
 Platform = Linux x86-64
-----------------------------------------------
Version = 13.5.0.0.0
 Platform = Microsoft Windows x64 (64-bit)
-----------------------------------------------
Platforms list displayed successfully.

When the Cloud Control contains the agent platform you need, copy it to your local filesystem:

# emcli get_agentimage -destination=/tmp/agent/win64 -platform="Microsoft Windows x64 (64-bit)"

When you're having more than one version of your agent, or when you need a special version (not the latest), you can also specify the version like this:

# emcli get_agentimage -destination=/tmp/agent/win64 -platform="Microsoft Windows x64 (64-bit)" -version=13.5.0.0.0

Transfer

Copy these files to the Windows server and unzip them.

Deploy agent

The agent can now be deployed by executing this in an admin shell:

# agentDeploy.bat AGENT_BASE_DIR=C:\Oracle\AgentHome OMS_HOST=<OMS server> EM_UPLOAD_PORT=1159 AGENT_REGISTRATION_PASSWORD=<password> AGENT_PORT=3872 -responeFile=C:\tmp\agent\agent.rsp -force

ToDos after agent installation

The agent will connect to Cloud Control, and then you'll be able to start monitoring 😄 But keep in mind, that you still have to discover targets for monitoring on this system.