06.05.2013 Views

The eG Installation Guide - eG Innovations

The eG Installation Guide - eG Innovations

The eG Installation Guide - eG Innovations

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Installing and Configuring on Windows Environments<br />

4. Upon restarting, the following files will be automatically created in the<br />

\agent\logs directory:<br />

<strong>The</strong> agentout.log file, which records details of the tests run and measures reported by the agent<br />

to the manager<br />

<strong>The</strong> agenterr.log and error_log files to which the runtime errors encountered by the <strong>eG</strong> agent are<br />

logged<br />

<strong>The</strong> agentupgrade.log file which provides the agent upgrade status.<br />

5. <strong>The</strong> errors (if any) will be logged in the error_log file that will be automatically created in the<br />

\agent\logs directory.<br />

You can ‘switch off’ error logging if so required, by running the debugoff.bat file in the<br />

\lib directory.<br />

3.19 Performance Impact of the <strong>eG</strong> Agent<br />

<strong>The</strong> resource utiliation of an <strong>eG</strong> agent is dependent on various factors including:<br />

the number of components that are being monitored by the <strong>eG</strong> agent;<br />

the specific component types to be monitored;<br />

the frequency of monitoring;<br />

whether the agent is monitoring applications in an agent-based or an agentless manner;<br />

For an internal agent monitoring a single application on the server at a 5 minute frequency, the agent<br />

typically consumes 0.1-0.3% of CPU. Network traffic generated by the agent is about 0.05 – 0.2 kbps.<br />

<strong>The</strong> size of the agent on disk is about 100 MB. When the agent is started, its memory footprint will be<br />

about 10-15 MB additional to that of the Java Virtual Machine. In total, the <strong>eG</strong> agent process<br />

consumes 30 – 50 MB of memory.<br />

For an agent that monitors multiple applications on a server, or for an agent that monitors<br />

components in an agentless/external manner, the CPU, memory, and network bandwidth usage will be<br />

higher.<br />

3.20 Increasing the Memory of the <strong>eG</strong> Agent<br />

<strong>The</strong> <strong>eG</strong> agent runs as a Java process. <strong>The</strong> maximum heap memory that can be allocated to a 32-bit<br />

<strong>eG</strong> agent process is limited to 1.5 GB. <strong>The</strong> maximum heap memory allocation to a 64-bit <strong>eG</strong> agent<br />

process on the other hand, is limited to 3 GB. If an <strong>eG</strong> agent has been configured to monitor many<br />

components, then, you may have to allocate more heap memory to the <strong>eG</strong> agent. In such a case,<br />

follow the steps below for a Windows agent:<br />

1. Login to the <strong>eG</strong> agent host.<br />

2. Edit the debugon.bat or debugoff.bat file in the \lib directory.<br />

3. Look for the entry -Xmx in the file. You will find the following entry:<br />

-Xmx128M<br />

4. From the Xmx specification, you can infer that by default, a maximum of 128 MB of memory has<br />

been allocated to the <strong>eG</strong> agent. If you want to increase the heap memory allocation to say, 256<br />

MB, then your specification should be changed as indicated below:<br />

-Xmx256M<br />

308

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!