Top 10 Agent parameters
By emdg on Mar 10, 2010
Agent configuration parameters
The main file on the Agent side of things with configuration parameters is the emd.properties file. This file is located in the <EMHOME>/sysman/config directory.
A lot of parameters are quite useful in an enterprise environment. Just to hi-light some of these, I've compiled a list of 10 common parameters that can get potentially changd and tweaked.
The EMHOME directory is the directory the Agent will use for all files it needs at runtime. The value of that directory can be obtained by issuing this command:
$ emctl getemhome
Use this parameter in combination with the
All PERL metrics scripts the Agent executes can be told to provide more tracing details in the emagent_perl.trc file with this parameter.
The default setting for the PERL tracing is WARN
The URL the Agent will use to identify itself with. This is the unique identifier the OMS and repository will use to contact this Agent. The value of this parameter is determined at install time, and should never be changed afterwards.
The name of the Agent (oracle_emd target) should match the host and port part of this URL.
If the Agent is secured, both this EMD_URL and REPOSITORY_URL parameter should both be using the HTTPS URI.
A boolean flag to indicate whether or not the extra listener to display and show the metrics of the Agent is enabled or not. This is a debugging feature designed to check and verify on the Agent metrics.
Under normal conditions, this extra http listener should not be enabled: It uses extra resources of the Agent, and can also consume extra incoming connections, depending on the number of people accessing the metric browser.
The default value for this parameter is FALSE.
The maximum number of incoming concurrent connections from an OMS the Agent will handle. If the OMS tries to establish more connections, the extra requests will have to wait until one of the active ones terminates.
The default value for this parameter is 25. This value can be increased if more than 25 monitored targets of the same type discovered. Increasing this value beyond 50 is not recommended.
6. proxyHost / proxyPort / dontProxyFor
These three parameters should be used together. They control the proxy settings the Agent will use for the monitoring operations. Typically beacons will be accessing URL and webpages outside the scope of the local monitoring. To allow these web operations to complete successfully, these proxy parameters can be used.
The amount in seconds the Agent will wait for a response before timing out a command send to the OMS. Every command the Agent sends (an API call to the OMS) should return within this time period.
On a busy system, with thousands of Agents, and several OMS machines active, this value can be increased if there is evidence found of timeout failures.
If the Agent times out an operation, a message like this will be written in the emagent.trc file:
The remote api of typeIncreasing it above 10 minutes (600 seconds) is not recommended.
has timed out
Default value is 300 seconds (5 minutes)
The URL the Agent will use to initiate contact with the OMS. This needs to point to a valid address of either the OMS itself, or an SLB if there are several OMS machines in an HA-deployed infrastructure.
If the Agent is secured, both this URL and EMD_URL parameter should both be using the HTTPS URI.
3. REPOSITORY_PROXYHOST / REPOSITORY_PROXYPORT
And also: REPOSITORY_PROXYPWD, REPOSITORY_PROXYREALM, and REPOSITORY_PROXYUSER.
All these parameters control the proxy behavior for the Agent when talking to the OMS. These parameters are ONLY used all the communication based on the REPOSITORY_URL, and are not used for the monitoring of targets (eg: Beacons)
2. TrcFileMaxRolls / TrcFileMaxSize
The Agent will rotate the trace files based on these settings. After a certain size is reached (TrcFileMaxSize), the Agent will roll-over the active trace file (emagent.trc) to emagent.trc.1, and decrement the numbers of any existing emagent.trc.<num> upto the maximum allowed number of files (TrcFileMaxRolls).
If the maximum number of trace files is reached, the oldest one (emagent.trc.5 by default) will be removed prior to rolling-over the current trace file.
The same applies for the Agent log files. Those files can be controlled with these parameters: LogFileMaxRolls and LogFileMaxSize.
The default values for these files are 256Kb per log/trace file (MaxSize), with a maximum of 5 files (MaxRolls) kept before removing the oldest one.
This is not exactly a single parameter, but all logging and tracing settings are controlled by this one set of parameters.
All out-of-the-box tracing should be done using the default value of 'WARN'. Only when debugging or investigating an issue, should this level be changed, and only for the duration of the testing/debugging.