5 Locating and Configuring Enterprise Manager Log Files</t itle> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Language" content="en" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> <meta name ="robots" content="all" scheme="http://www.robotstxt.org/" /> <meta name="doctitle" content="Oracle® Enterprise Manager Advanced Configuration 10g Release 1 (10.1)" /> <meta name="partno" content="B12013-01" /> <meta name="docid" content="OEMCG" /> <link rel="St art" href="../../index.htm" title="Home" type="text/html" /> <link rel="Copyright" href="../../dcommon/html/cpyr.htm" title="Copyrigh t" type="text/html" /> <link rel="Stylesheet" href="../../dcommon/css/doccd.css" title="Default" type="text/css" /> <link rel="Conten ts" href="toc.htm" title="Contents" type="text/html" /> <link rel="Index" href="index.htm" title="Index" type="text/html" /> <link re l="Prev" href="apm.htm" title="Previous" type="text/html" /> <link rel="Next" href="repository.htm" title="Next" type="text/html" /> <link rel="alternate" href="../b12013.pdf" title="PDF version" type="application/pdf" /> </head> <body> <div class="header"> <p><a na me="top" id="top" href="#BEGIN">Skip Headers</a></p> <table summary="" cellspacing="0" cellpadding="0" width="100%"> <tr> <td align=" left" valign="top"><font color="#330099" face="Helvetica, Arial, sans-serif"><strong>Oracle® Enterprise Manager Advanced Configur ation<br /> 10<i>g</i> Release 1 (10.1)</strong><br /> Part Number B12013-01</font></td> <td valign="bottom" align="right"> <table s ummary="" cellspacing="0" cellpadding="0" width="270"> <tr> <td align="center" valign="top"><a href="../../index.htm"><img src="../.. /dcommon/gifs/prodicon.gif" alt="Go to Documentation Home" border="0" /><br /> <font size="-2">Home</font></a></td> <td align="center " valign="top"><a href="../../nav/portal_3.htm"><img src="../../dcommon/gifs/bookicon.gif" alt="Go to Book List" border="0" /><br /> <font size="-2">Book List</font></a></td> <td align="center" valign="top"><a href="toc.htm"><img src="../../dcommon/gifs/conticon.gif " alt="Go to Table of Contents" border="0" /><br /> <font size="-2">Contents</font></a></td> <td align="center" valign="top"><a href= "index.htm"><img src="../../dcommon/gifs/indxicon.gif" alt="Go to Index" border="0" /><br /> <font size="-2">Index</font></a></td> <t d align="center" valign="top"><a href="../../mix$101/b12039/toc.htm"><img src="../../dcommon/gifs/mix.gif" alt="Go to Master Index" b order="0" /><br /> <font size="-2">Master Index</font></a></td> <td align="center" valign="top"><a href="../../dcommon/html/feed back.htm"><img src="../../dcommon/gifs/feedback.gif" alt="Go to Feedback page" border="0" /><br /> <font size="-2">Feedback</font></a ></td></tr></table></td></tr></table> <hr /> <table summary="layout table" cellspacing="0" cellpadding="0" width="100%"> <tr> <td ali gn="left" valign="top"> <table summary="layout table" cellspacing="0" cellpadding="0" align="left" width="90"> <tr> <td align="center " valign="top"><a href="apm.htm"><img src="../../dcommon/gifs/larrow.gif" alt="Go to previous page" border="0" /><br /> <font size="- 2">Previous</font></a></td> <td align="center" valign="top"><a href="repository.htm"><img src="../../dcommon/gifs/rarrow.gif" alt="Go to next page" border="0" /><br /> <font size="-2">Next</font></a></td></tr></table></td> <td align="right" valign="top"><a href="../ b12013.pdf"><font size="-2">View PDF</font></a></td></tr></table> <a name="BEGIN" id="BEGIN"></a></div> <div class="IND"><a id="g1030101" name="g1030101"></a><a id="i1023926" name="i1023926"></a> <h1><font face="arial, helvetica, sans-serif" colo r="#330099"><span class="secnum">5</span> <a name="OEMCG0112" id="OEMCG0112"></a>Locating and Configuring Enterprise Manager <a id="s thref574" name="sthref574"></a><a id="sthref575" name="sthref575"></a>Log Files</font></h1> <p>When you install the Oracle Management Agent or the Oracle Management Service, Enterprise Manager automatically configures the system to save certain informational, warnin g, and error information to a set of log files.</p> <p>Log files can help you troubleshoot potential problems with an Enterprise Mana ger installation. They provide detailed information about the actions performed by Enterprise Manager and whether or not any warnings or errors occurred.</p> <p>This chapter not only helps you locate and review the contents of Enterprise Manager log files, but also includes instructions for configuring the log files to provide more detailed information to help in troubleshooting or to provide les s detailed information to save disk space.</p> <p>This chapter contains the following sections:</p> <ul> <li type="disc"> <p><a href= "#i1024060">Locating and Configuring Management Agent Log and Trace Files</a></p></li> <li type="disc"> <p><a href="#i1024065">Locati ng and Configuring Management Service Log and Trace Files</a></p></li></ul> <a id="i1024060" name="i1024060"></a> <div class="Sect1" ><a id="sthref576" name="sthref576"></a> <h2><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1</spa n> Locating and Configuring Management Agent Log and <a id="sthref577" name="sthref577"></a><a id="sthref578" name="sthref578"></a><a id="sthref579" name="sthref579"></a><a id="sthref580" name="sthref580"></a>Trace Files</font></h2> <p>The following sections provide information on the log and trace files for the Oracle Management Agent:</p> <ul> <li type="disc"> <p><a href="#i1024078">About the M anagement Agent Log and Trace Files</a></p></li> <li type="disc"> <p><a href="#i1021635">Locating the Management Agent Log and Trace Files</a></p></li> <li type="disc"> <p><a href="#i1024087">About Management Agent Rollover Files</a></p></li> <li type="disc"> <p><a href="#i1024127">Controlling the Size and Number of Management Agent Log and Trace Files</a></p></li> <li type="disc"> <p><a href="#i 1024385">Controlling the Size and Number of Fetchlet Log and Trace Files</a></p></li> <li type="disc"> <p><a href="#i1024390">Control ling the Contents of the Fetchlet Trace File</a></p></li></ul> <a id="i1024078" name="i1024078"></a> <div class="Sect2"><a id="sthre f581" name="sthref581"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1.1</span> About th e <a id="sthref582" name="sthref582"></a>Management Agent Log and Trace Files</font></h3> <p>Oracle Management Agent log and trace fi les store important information that support personnel can later use to troubleshoot problems. The Management Agent uses three types of log files:</p> <ul> <li type="disc"> <p>The Management Agent log file (<code><a id="sthref583" name="sthref583"></a>emagent.log</c ode>)</p> <p>The Agent saves information to the log file when the Agent performs an action (such as starting, stopping, or connecting to a Management Service) or when the Agent generates an error (for example, when the Agent cannot connect to the Management Service) .</p></li> <li type="disc"> <p>The Management Agent trace file (<code><a id="sthref584" name="sthref584"></a>emagent.trc</code>)</p> <p>The Management Agent trace file provides an advanced method of troubleshooting that can provide support personnel with even more i nformation about what actions the Agent was performing when a particular problem occurred.</p></li> <li type="disc"> <p>The Managemen t Agent startup log file (<code><a id="sthref585" name="sthref585"></a>emagent.nohup</code>)</p> <p>The Management Agent saves inform ation to the startup log file when there is a problem starting the agent. This file is updated by the Management Agent Watchdog Proce ss. When the Watchdog Process logs any problems it finds to this file.</p></li></ul> <div class="inftblNoteAlso"><br /> <table class= "NoteAlso" summary="This is a layout table to format a tip" title="This is a layout table to format a tip" dir="ltr" border="1" width ="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p><font face="arial, helvetica, sans-serif"><strong>See Also:</strong></font></p> <a href="postinstall_config.htm#i1025059">"About the Management Agent Watchdog Pro cess"</a></td></tr></tbody></table> <br /></div>  <p>In addition, Enterprise Manager also provides a lo g file and a trace file for the fetchlets, which are software programs used by the Management Agent for certain data-gathering tasks: </p> <ul> <li type="disc"> <p><code>emagentfetchlet.log</code></p></li> <li type="disc"> <p><code>emagentfetchlet.trc</code></p></li> </ul></div>  <a id="i1021635" name="i1021635"></a> <div class="Sect2"><a id="sthref586" name="sthref586"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1.2</span> Locating the Management <a id="sthre f587" name="sthref587"></a><a id="sthref588" name="sthref588"></a><a id="sthref589" name="sthref589"></a>Agent Log and Trace Files</f ont></h3> <p>The Management Agent log files are stored in the following directory when you install the Management Agent:</p> <pre xml :space="preserve">AGENT_HOME/sysman/log/ </pre> <div class="inftblNoteAlso"><br /> <table class="NoteAlso" summary="This is a layout table to format a tip" title="This is a layout table to format a tip" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p><font face="arial, helvetica, sans-serif"><strong>See Also:</stro ng></font></p> <a href="structure.htm#CACJCAII">Chapter 1, " Introduction to Enterprise Manager Advanced Configuration "</a> for info rmation about locating the Agent home directory.</td></tr></tbody></table> <br /></div>  </div>  <a id="i1024087" name="i1024087"></a> <div class="Sect2"><a id="sthref590" name="sthref590"></a> <h3><font face="ar ial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1.3</span> About Management Agent <a id="sthref591" name="sthref59 1"></a><a id="sthref592" name="sthref592"></a><a id="sthref593" name="sthref593"></a><a id="sthref594" name="sthref594"></a><a id="st href595" name="sthref595"></a>Rollover Files</font></h3> <p>Both the Management Agent log file and the Management Agent trace file ar e designed to increase in size over time as information is written to the files. However, they are also designed to reach a maximum s ize. When the files reach the predefined maximum size, the Management Agent renames (or rolls) the logging or trace information to a new file name and starts a new log or trace file. This process keeps the log files from growing too large.</p> <p>To be sure you have access to important log or trace file information, the Management Agent will rollover the log and trace files four times by default. When it rolls the log or trace file over the fourth time, the Agent deletes the oldest rollover file.</p> <p>As a result, you will o ften see a total of four log files and four trace files in the log directory. The following example shows three archived trace files and the current trace file in the <code>AGENT_HOME/sysman/log</code> directory:</p> <pre xml:space="preserve">emagent.trc emagent.trc .1 emagent.trc.2 emagent.trc.3 </pre> </div>  <a id="i1024127" name="i1024127"></a> <div class="Sect2"><a id=" sthref596" name="sthref596"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1.4</span> Con trolling the Size and Number of <a id="sthref597" name="sthref597"></a><a id="sthref598" name="sthref598"></a><a id="sthref599" name= "sthref599"></a><a id="sthref600" name="sthref600"></a>Management Agent Log and Trace Files</font></h3> <p>You can control how large the log file and the trace file can get before the Management Agent creates a rollover file. You can also control how many rollover f iles are created before the Management Agent deletes any logging or tracing data.</p> <p>To control the size and number of Management Agent Log and Trace Files:</p> <ol type="1" start="1"> <li> <p>Stop the Management Agent.</p> <div class="inftblNoteAlso"><br /> <ta ble class="NoteAlso" summary="This is a layout table to format a tip" title="This is a layout table to format a tip" dir="ltr" border ="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p><font face="arial, helvetica, sans-serif"><strong>See Also:</strong></font></p> <a href="structure.htm#i1027592">"Starting, Stopping, and Checking the S tatus of the Management Agent on UNIX"</a></td></tr></tbody></table> <br /></div>  </li> <li> <p>Locate the <code><a id="sthref601" name="sthref601"></a>emd.properties</code> file, which is located in the following directory:</p> <pre x ml:space="preserve">AGENT_HOME/sysman/config/ (UNIX) AGENT_HOME\sysman\config (Windows) </pre> </li> <li> <p>Use a text editor to op en the <code>emd.properties</code> file.</p></li> <li> <p>Use the information in <a href="#g1027745">Table 5-1</a> to locate and modi fy the Agent logging and tracing properties in the <code>emd.properties</code> file.</p></li> <li> <p>Restart the Management Agent.</ p></li></ol> <div class="tblFormal"><a id="sthref602" name="sthref602"></a><a id="g1027745" name="g1027745"></a> <p><strong><em><fon t face="arial, helvetica, sans-serif">Table 5-1 Management Agent Log and Trace File Properties</font></em></strong></p> <table class= "Formal" title="Management Agent Log and Trace File Properties" summary="This table is described in the preceding text" dir="ltr" bor der="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <thead> <tr align="left" valign="top"> <th align= "left" valign="bottom" id="r1c1-t5"><font face="Arial, Helvetica, sans-serif"><strong>Property</strong></font></th> <th align="left" valign="bottom" id="r1c2-t5"><font face="Arial, Helvetica, sans-serif"><strong>Purpose</strong></font></th> <th align="left" valign=" bottom" id="r1c3-t5"><font face="Arial, Helvetica, sans-serif"><strong>Example</strong></font></th></tr></thead> <tbody> <tr align="l eft" valign="top"> <td align="left" id="r2c1-t5" headers="r1c1-t5"> <pre xml:space="preserve">LogFilewithPID </pre> </td> <td align=" left" headers="r2c1-t5 r1c2-t5">When set to TRUE, this property appends the process ID of the Management Agent to the log file name. This makes it easier to identify the process ID of the Management Agent you are monitoring.</td> <td align="left" headers="r2c1-t5 r1 c3-t5"><code>LogFilewithPID=true</code></td></tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t5" headers="r1c1-t5"> <pr e xml:space="preserve">LogFileMaxSize </pre> </td> <td align="left" headers="r3c1-t5 r1c2-t5">When the Agent log file reaches this si ze (in kilobytes), the Management Agent <code>copies the logging data to a new rollover file and creates a new emagent.log</code> log ging file.</td> <td align="left" headers="r3c1-t5 r1c3-t5"><code>LogFileMaxSize=4096</code></td></tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t5" headers="r1c1-t5"> <pre xml:space="preserve">LogFileMaxRolls<a id="sthref603" name="sthref603"></a><a i d="sthref604" name="sthref604"></a> </pre> </td> <td align="left" headers="r4c1-t5 r1c2-t5">By the default, the Agent will rollover t he log file four times before it deletes any logging data. The number of rollover files is controlled by this property.</td> <td alig n="left" headers="r4c1-t5 r1c3-t5"><code>LogFileMaxRolls=4</code></td></tr> <tr align="left" valign="top"> <td align="left" id="r5c1- t5" headers="r1c1-t5"> <pre xml:space="preserve">TrcFileMaxSize<a id="sthref605" name="sthref605"></a><a id="sthref606" name="sthref6 06"></a> </pre> </td> <td align="left" headers="r5c1-t5 r1c2-t5">When the Agent trace file reach this size (in kilobytes), the Manage ment Agent <code>copies the logging data to a new rollover file and creates a new emagent.trc</code> logging file.</td> <td align="le ft" headers="r5c1-t5 r1c3-t5">TrcFileMaxSize=4096</td></tr> <tr align="left" valign="top"> <td align="left" id="r6c1-t5" headers="r1c 1-t5"><a id="sthref607" name="sthref607"></a><a id="sthref608" name="sthref608"></a>TrcFileMaxRolls</td> <td align="left" headers="r6 c1-t5 r1c2-t5">By the default, the Agent will rollover the trace file four times before it deletes any tracing data. The number of ro llover files is controlled by this property.</td> <td align="left" headers="r6c1-t5 r1c3-t5">TrcFileMaxRolls=4</td></tr></tbody></tab le> <br /></div>  </div>  <a id="i1026501" name="i1026501"></a> <div class="Sect2">< a id="sthref609" name="sthref609"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1.5</spa n> Controlling the Contents of the Management Agent Trace File</font></h3> <p>To modify the amount of information save<a id="sthref61 0" name="sthref610"></a><a id="sthref611" name="sthref611"></a><a id="sthref612" name="sthref612"></a><a id="sthref613" name="sthref6 13"></a>d in the Management Agent trace file:</p> <ol type="1" start="1"> <li> <p>Stop the Management Agent.</p> <div class="inftblNo teAlso"><br /> <table class="NoteAlso" summary="This is a layout table to format a tip" title="This is a layout table to format a tip " dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p>< font face="arial, helvetica, sans-serif"><strong>See Also:</strong></font></p> <a href="structure.htm#i1027592">"Starting, Stopping, and Checking the Status of the Management Agent on UNIX"</a></td></tr></tbody></table> <br /></div>  </ li> <li> <p>Locate the <code>emd.properties</code> file, which is located in the following directory:</p> <pre xml:space="preserve">< em>AGENT_HOME</em>/sysman/config </pre> </li> <li> <p>Open the <code>emd.properties</code> file using your favorite text editor and look for the following entries near the bottom of the file:</p> <pre xml:space="preserve">tracelevel.main=WARN tracelevel.emdSDK=WARN tracelevel.emdSDK.util=WARN tracelevel.ResMonitor=WARN tracelevel.Dispatcher=WARN tracelevel.ThreadPool=WARN tracelevel.pingManger=W ARN . . . </pre> <p>Each of these properties controls the level of logging detail for the various subcomponents of the Management A gent.</p></li> <li> <p>Modify the amount of information that is included in the trace file by replacing the WARN value for each prope rty to one of the values shown in <a href="#g1027805">Table 5-2</a>.</p> <div class="inftblNote"><br /> <table class="Note" summary=" This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsid es" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p><font face="arial, helvetica, sans-serif"><stro ng>Note:</strong></font></p> The values described in <a href="#g1027805">Table 5-2</a> are case-sensitive.</td></tr></tbody></table> <br /></div>  </li> <li> <p>Restart the Management Agent.</p></li></ol> <div class="tblFormal"><a id="sthre f614" name="sthref614"></a><a id="g1027805" name="g1027805"></a> <p><strong><em><font face="arial, helvetica, sans-serif">Table 5-2 Enterprise Manager Component <a id="sthref615" name="sthref615"></a>Tracing Levels</font></em></strong></p> <table class="Formal" tit le="Enterprise Manager Component Tracing Levels" summary="This table is described in the preceding text" dir="ltr" border="1" width=" 100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <thead> <tr align="left" valign="top"> <th align="left" valign=" bottom" id="r1c1-t8"><font face="Arial, Helvetica, sans-serif"><strong>Level</strong></font></th> <th align="left" valign="bottom" id ="r1c2-t8"><font face="Arial, Helvetica, sans-serif"><strong>Purpose</strong></font></th></tr></thead> <tbody> <tr align="left" valig n="top"> <td align="left" id="r2c1-t8" headers="r1c1-t8">ERROR</td> <td align="left" headers="r2c1-t8 r1c2-t8">Include only critical errors in the trace file. This setting generates the least amount of tracing data. The trace file will likely grow at a relatively sl ow rate when you select this logging level.</td></tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t8" headers="r1c1-t8"> WARN</td> <td align="left" headers="r3c1-t8 r1c2-t8">Include warning information, in addition to critical errors.</td></tr> <tr align ="left" valign="top"> <td align="left" id="r4c1-t8" headers="r1c1-t8">INFO</td> <td align="left" headers="r4c1-t8 r1c2-t8">Include in formational messages, in addition to warning and critical error information.</td></tr> <tr align="left" valign="top"> <td align="left " id="r5c1-t8" headers="r1c1-t8">DEBUG</td> <td align="left" headers="r5c1-t8 r1c2-t8">Include debugging information, as well as info rmational tracing, warning, and critical errors. This setting generates the greatest amount of tracing data. <p><strong>Note:</stron g> The trace file will likely grow at a relatively fast rate when you select this logging level.</p></td></tr></tbody></table> <br /> </div>  </div>  <a id="i1024385" name="i1024385"></a> <div class="Sect2"><a id="sthr ef616" name="sthref616"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1.6</span> Control ling the Size and Number of <a id="sthref617" name="sthref617"></a><a id="sthref618" name="sthref618"></a><a id="sthref619" name="sth ref619"></a><a id="sthref620" name="sthref620"></a>Fetchlet Log and Trace Files</font></h3> <p>Like the Management Agent log and trac e files, the Management Agent fetchlet log and trace files are designed to reach a maximum size before the Management Agent renames ( or rolls) the information to a new file name and starts a new log or trace file.</p> <p>To control the maximum size of the Management Agent fetchlet log and trace files, as well as the number of rollover files:</p> <ol type="1" start="1"> <li> <p>Stop the Management Agent.</p> <div class="inftblNoteAlso"><br /> <table class="NoteAlso" summary="This is a layout table to format a tip" title="This i s a layout table to format a tip" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tb ody> <tr> <td align="left"> <p><font face="arial, helvetica, sans-serif"><strong>See Also:</strong></font></p> <a href="structure.htm #i1027592">"Starting, Stopping, and Checking the Status of the Management Agent on UNIX"</a></td></tr></tbody></table> <br /></div> < !-- class="inftblNoteAlso --> </li> <li> <p>Locate the <code>emagentlogging.properties</code> file in the following directory:</p> <p re xml:space="preserve">AGENT_HOME/sysman/config </pre> </li> <li> <p>Open the <code><a id="sthref621" name="sthref621"></a>emagentl ogging.properties</code> file with a text editor and modify the entries described in <a href="#g1027705">Table 5-3</a>.</p></li> <li> <p>Restart the Management Agent.</p></li></ol> <div class="tblFormalWide"><a id="sthref622" name="sthref622"></a><a id="g1027705" na me="g1027705"></a> <p><strong><em><font face="arial, helvetica, sans-serif">Table 5-3 Management Agent Servlet Log and Trace File Pr operties</font></em></strong></p> <table class="FormalWide" title="Management Agent Servlet Log and Trace File Properties" summary="T his table is described in the preceding text" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspa cing="0"> <thead> <tr align="left" valign="top"> <th align="left" valign="bottom" id="r1c1-t10"><font face="Arial, Helvetica, sans-se rif"><strong>Property</strong></font></th> <th align="left" valign="bottom" id="r1c2-t10"><font face="Arial, Helvetica, sans-serif">< strong>Purpose</strong></font></th> <th align="left" valign="bottom" id="r1c3-t10"><font face="Arial, Helvetica, sans-serif"><strong> Example</strong></font></th></tr></thead> <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t10" headers="r1c1-t10"><a id="sthref623" name="sthref623"></a><a id="sthref624" name="sthref624"></a><a id="sthref625" name="sthref625"></a>log4j.appender. em agentlogAppender. MaxFileSize</td> <td align="left" headers="r2c1-t10 r1c2-t10">When the fetchlet log file reaches this size, the Man agement Agent copies the logging data to a new rollover file and creates a new <code>emagentfetchlet.log</code> file.</td> <td align= "left" headers="r2c1-t10 r1c3-t10">log4j.appender. emagentlogAppender. MaxFileSize=20000000</td></tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t10" headers="r1c1-t10"><a id="sthref626" name="sthref626"></a><a id="sthref627" name="sthref627"></a><a id ="sthref628" name="sthref628"></a>log4j.appender. emagentlogAppender. MaxBackupIndex</td> <td align="left" headers="r3c1-t10 r1c2-t10 ">This optional property indicates how many times the Management Agent will rollover the fetchlet log file to a new file name before deleting logging data. <p><strong>Note:</strong> Because the log file does not contain as much data as the trace file, it is usually not necessary to create more than one rollover file. As a result, this entry is not included in the properties file by default.</p>< /td> <td align="left" headers="r3c1-t10 r1c3-t10">log4j.appender.emagentlogAppender. MaxBackupIndex=1</td></tr> <tr align="left" vali gn="top"> <td align="left" id="r4c1-t10" headers="r1c1-t10"><a id="sthref629" name="sthref629"></a>log4j.appender. emagenttrcAppender . MaxFileSize</td> <td align="left" headers="r4c1-t10 r1c2-t10">When the fetchlet trace file reaches this size, the Management Agent copies the logging data to a new rollover file and creates a new <code>emagentfetchlet.trc</code> log file.</td> <td align="left" hea ders="r4c1-t10 r1c3-t10">log4j.appender. emagenttrcAppender. MaxFileSize=5000000</td></tr> <tr align="left" valign="top"> <td align=" left" id="r5c1-t10" headers="r1c1-t10"><a id="sthref630" name="sthref630"></a>log4j.appender. emagenttrcAppender. MaxBackupIndex</td> <td align="left" headers="r5c1-t10 r1c2-t10">This property indicates how many times the Management Agent will rollover the trace fil e to a new file name before deleting tracing data.</td> <td align="left" headers="r5c1-t10 r1c3-t10">log4j.appender. emagenttrcAppend er. MaxBackupIndex=10</td></tr></tbody></table> <br /></div>  </div>  <a id="i102 4390" name="i1024390"></a> <div class="Sect2"><a id="sthref631" name="sthref631"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.1.7</span> Controlling the Contents of the <a id="sthref632" name="sthref632"></a>Fetchlet Tr ace File</font></h3> <p>By default, the Management Agent will save all critical and warning messages generated by the Management Agen t fetchlets to the <code>emagentfetchlet.trc</code> file. However, you can adjust the amount of logging information that the fetchlet s generate.</p> <p>To change the amount of tracing information generated by the Management Agent fetchlets:</p> <ol type="1" start="1 "> <li> <p>Stop the Management Agent.</p> <div class="inftblNoteAlso"><br /> <table class="NoteAlso" summary="This is a layout table to format a tip" title="This is a layout table to format a tip" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpa dding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p><font face="arial, helvetica, sans-serif"><strong>See Also:</strong></fo nt></p> <a href="structure.htm#i1027592">"Starting, Stopping, and Checking the Status of the Management Agent on UNIX"</a></td></tr>< /tbody></table> <br /></div>  </li> <li> <p>Locate the <code>emagentlogging.properties</code> file in t he following directory:</p> <pre xml:space="preserve">AGENT_HOME/sysman/config </pre> </li> <li> <p>Open the <code>emagentlogging.pr operties</code> file with a text editor and locate the following entry:</p> <pre xml:space="preserve"><a id="sthref633" name="sthref6 33"></a><a id="sthref634" name="sthref634"></a>log4j.rootCategory=WARN, emagentlogAppender, emagenttrcAppender </pre> </li> <li> <p> Change the value of the <code>log4j.rootCategory</code> parameter to one of the values shown in <a href="#g1027805">Table 5-2</a>.</p > <div class="inftblNote"><br /> <table class="Note" summary="This is a layout table to format a note" title="This is a layout table to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td al ign="left"> <p><font face="arial, helvetica, sans-serif"><strong>Note:</strong></font></p> The the values described in <a href="#g102 7805">Table 5-2</a> are case-sensitive.</td></tr></tbody></table> <br /></div>  </li> <li> <p>Restart the M anagement Agent.</p></li></ol></div>  </div>  <a id="i1024065" name="i1024065"></a> <div class="Sect1"><a id="sthref635" name="sthref635"></a> <h2><font face="arial, helvetica, sans-serif" color="#330099"><span class="se cnum">5.2</span> Locating and Configuring <a id="sthref636" name="sthref636"></a><a id="sthref637" name="sthref637"></a><a id="sthref 638" name="sthref638"></a>Management Service Log and Trace Files</font></h2> <p>The following sections describe how to locate and con figure the Management Service log files:</p> <ul> <li type="disc"> <p><a href="#i1024105">Locating the Management Service Log and Tra ce Files</a></p></li> <li type="disc"> <p><a href="#i1024110">Controlling the Size and Number of Management Service Log and Trace Fil es</a></p></li> <li type="disc"> <p><a href="#i1024115">Controlling the Contents of the Management Service Trace File</a></p></li></u l> <div class="Sect2"><a id="sthref639" name="sthref639"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span cl ass="secnum">5.2.1</span> About the <a id="sthref640" name="sthref640"></a>Management Service Log and Trace Files</font></h3> <p>Orac le Management Service log and trace files store important information that support personnel can later use to troubleshoot problems. The Management Service uses three types of log files:</p> <ul> <li type="disc"> <p>The Management Service log file (<code><a id="sthr ef641" name="sthref641"></a>emoms.log</code>)</p> <p>The Oracle Management Service saves information to the log file when the Managem ent Service performs an action (such as starting or stopping) or when the Management Service generates an error.</p></li> <li type="d isc"> <p>The Management Service trace file (<code><a id="sthref642" name="sthref642"></a>emoms.trc</code>)</p> <p>The Management Serv ice trace file provides an advanced method of troubleshooting that can provide support personnel with even more information about wha t actions the Management Service was performing when a particular problem occurred.</p></li></ul></div>  <a id= "i1024105" name="i1024105"></a> <div class="Sect2"><a id="sthref643" name="sthref643"></a> <h3><font face="arial, helvetica, sans-s erif" color="#330099"><span class="secnum">5.2.2</span> Locating the Management Ser<a id="sthref644" name="sthref644"></a><a id="sthr ef645" name="sthref645"></a><a id="sthref646" name="sthref646"></a>vice Log and Trace Files</font></h3> <p>The Management Service log and trace files are stored in the following directory inside the Oracle Application Server Home where the Oracle Management Service is installed and deployed:</p> <pre xml:space="preserve">AS_HOME/sysman/log/ </pre> </div>  <a id="i1024110" na me="i1024110"></a> <div class="Sect2"><a id="sthref647" name="sthref647"></a> <h3><font face="arial, helvetica, sans-serif" color=" #330099"><span class="secnum">5.2.3</span> Controlling the Size and Number of <a id="sthref648" name="sthref648"></a><a id="sthref649 " name="sthref649"></a><a id="sthref650" name="sthref650"></a>Management Service Log and Trace Files</font></h3> <p>The Management Se rvice log and trace files increases in size over time as information is written to the files. However, the files are designed to reac h a maximum size. When the files reach the predefined maximum size, the Management Service renames (or rolls) the logging information to a new file name and starts a new log or trace file. This process keeps the log and trace files from growing too large.</p> <p>As a result, you will often see multiple log and trace files in the Management Service log directory. The following example shows one ar chived log file and the current log file in the <code>AS_HOME/sysman/log</code> directory:</p> <pre xml:space="preserve"><a id="sthre f651" name="sthref651"></a>emoms.log emoms.log.1 </pre> <p>To control the maximum size of the Management Service log and trace file s, as well as the number of rollover files:</p> <ol type="1" start="1"> <li> <p>Stop the Management Service.</p> <div class="inftblNo teAlso"><br /> <table class="NoteAlso" summary="This is a layout table to format a tip" title="This is a layout table to format a tip " dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p>< font face="arial, helvetica, sans-serif"><strong>See Also:</strong></font></p> <a href="structure.htm#i1030849">"Controlling the Orac le Management Service"</a></td></tr></tbody></table> <br /></div>  </li> <li> <p>Locate the <code><a id ="sthref652" name="sthref652"></a>emomslogging.properties</code> file in the following directory:</p> <pre xml:space="preserve">AS_HO ME/sysman/config </pre> </li> <li> <p>Open the <code>emomslogging.properties</code> file with a text editor and modify the entries d escribed in <a href="#g1027773">Table 5-4</a>.</p></li> <li> <p>Restart the Management Service.</p></li></ol> <div class="tblFormalWi de"><a id="sthref653" name="sthref653"></a><a id="g1027773" name="g1027773"></a> <p><strong><em><font face="arial, helvetica, sans-s erif">Table 5-4 Management Service Log File Properties in the emomslogging.properties File</font></em></strong></p> <table class="For malWide" title="Management Service Log File Properties in the emomslogging.properties File" summary="This table is described in the p receding text" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <thead> <tr align="le ft" valign="top"> <th align="left" valign="bottom" id="r1c1-t14"><font face="Arial, Helvetica, sans-serif"><strong>Property</strong>< /font></th> <th align="left" valign="bottom" id="r1c2-t14"><font face="Arial, Helvetica, sans-serif"><strong>Purpose</strong></font>< /th> <th align="left" valign="bottom" id="r1c3-t14"><font face="Arial, Helvetica, sans-serif"><strong>Example</strong></font></th></t r></thead> <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t14" headers="r1c1-t14"><a id="sthref654" name="sthref654 "></a><a id="sthref655" name="sthref655"></a><a id="sthref656" name="sthref656"></a>log4j.appender.emlogAppender. MaxFileSize</td> <t d align="left" headers="r2c1-t14 r1c2-t14">When the Management Service log file reaches this size, the Management Service copies the logging data to a new rollover file and creates a new <code>emoms.log</code> log file.</td> <td align="left" headers="r2c1-t14 r1c3-t 14">log4j.appender.emdAppender. MaxFileSize=20000000</td></tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t14" headers= "r1c1-t14"><a id="sthref657" name="sthref657"></a><a id="sthref658" name="sthref658"></a><a id="sthref659" name="sthref659"></a>log4j .appender.emlogAppender. MaxBackupIndex</td> <td align="left" headers="r3c1-t14 r1c2-t14">This optional property indicates how many t imes the Management Service will rollover the log file to a new file name before deleting logging data. <p><strong>Note:</strong> Be cause the log file does not contain as much data as the trace file, it is usually not necessary to create more than one rollover file . As a result, this entry is not included in the properties file by default.</p></td> <td align="left" headers="r3c1-t14 r1c3-t14">lo g4j.appender.emdAppender. MaxBackupIndex=1</td></tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t14" headers="r1c1-t14" ><a id="sthref660" name="sthref660"></a>log4j.appender.emtrcAppender. MaxFileSize</td> <td align="left" headers="r4c1-t14 r1c2-t14">W hen the Management Service trace file reaches this size, the Management Service copies the logging data to a new rollover file and cr eates a new <code>emoms.trc</code> log file.</td> <td align="left" headers="r4c1-t14 r1c3-t14">log4j.appender.emtrcAppender. MaxFileS ize=5000000</td></tr> <tr align="left" valign="top"> <td align="left" id="r5c1-t14" headers="r1c1-t14"><a id="sthref661" name="sthref 661"></a>log4j.appender.emtrcAppender. MaxBackupIndex</td> <td align="left" headers="r5c1-t14 r1c2-t14">This property indicates how m any times the Management Services will rollover the trace file to a new file name before deleting tracing data.</td> <td align="left" headers="r5c1-t14 r1c3-t14">log4j.appender.emtrcAppender. MaxBackupIndex=10</td></tr></tbody></table> <br /></div>  </div>  <a id="i1024115" name="i1024115"></a> <div class="Sect2"><a id="sthref662" name="sthref6 62"></a> <h3><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">5.2.4</span> Controlling the Contents of the <a id="sthref663" name="sthref663"></a><a id="sthref664" name="sthref664"></a>Management Service Trace File</font></h3> <p>By de fault, the Management Service will save all critical and warning messages to the <code>emoms.trc</code> file. However, you can adjust the amount of logging information that the Management Service generates.</p> <p>To change the amount of logging information generate d by the Management Service:</p> <ol type="1" start="1"> <li> <p>Stop the Management Service.</p> <div class="inftblNoteAlso"><br /> <table class="NoteAlso" summary="This is a layout table to format a tip" title="This is a layout table to format a tip" dir="ltr" bor der="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p><font face="aria l, helvetica, sans-serif"><strong>See Also:</strong></font></p> <a href="structure.htm#i1030849">"Controlling the Oracle Management S ervice"</a></td></tr></tbody></table> <br /></div>  </li> <li> <p>Locate the <code>emomslogging.propert ies</code> file in the following directory:</p> <pre xml:space="preserve">AS_HOME/sysman/config </pre> </li> <li> <p>Open the <code> <a id="sthref665" name="sthref665"></a>emomslogging.properties</code> file with a text editor and locate the following entry:</p> <pr e xml:space="preserve"><a id="sthref666" name="sthref666"></a>log4j.rootCategory=WARN, emlogAppender, emtrcAppender </pre> </li> <li > <p>Modify the value of the <code>log4j.rootCategory</code> parameter to one of the values shown in <a href="#g1027805">Table 5-2</a >.</p> <div class="inftblNote"><br /> <table class="Note" summary="This is a layout table to format a note" title="This is a layout t able to format a note" dir="ltr" border="1" width="80%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <tbody> <tr> < td align="left"> <p><font face="arial, helvetica, sans-serif"><strong>Note:</strong></font></p> The the values described in <a href=" #g1027805">Table 5-2</a> are case-sensitive.</td></tr></tbody></table> <br /></div>  </li> <li> <p>Restart the Management Service.</p></li></ol></div>  </div>  </div> <div class="footer"> <hr /> < table summary="" cellspacing="0" cellpadding="0" width="100%"> <tr> <td style="width: 33%;" align="left"> <table summary="layout tabl e" cellspacing="0" cellpadding="0" align="left" width="90"> <tr> <td align="center" valign="top"><a href="apm.htm"><img src="../../dc ommon/gifs/larrow.gif" alt="Go to previous page" border="0" /><br /> <font size="-2">Previous</font></a></td> <td align="center" vali gn="top"><a href="repository.htm"><img src="../../dcommon/gifs/rarrow.gif" alt="Go to next page" border="0" /><br /> <font size="-2"> Next</font></a></td></tr></table></td> <td style="width: 34%;" align="center"><img src="../../dcommon/gifs/oracle.gif" alt="Oracle" / ><br /> <a href="../../dcommon/html/cpyr.htm"><font size="-2">Copyright © 2003 Oracle Corporation</font></a> <br /> <font size="-2">All Rights Reserved.</font></td> <td style="width: 33%;" align="right"> <table summary="" cellspacing="0" cell padding="0" width="270"> <tr> <td align="center" valign="top"><a href="../../index.htm"><img src="../../dcommon/gifs/prodicon.gif" al t="Go to Documentation Home" border="0" /><br /> <font size="-2">Home</font></a></td> <td align="center" valign="top"><a href="../../ nav/portal_3.htm"><img src="../../dcommon/gifs/bookicon.gif" alt="Go to Book List" border="0" /><br /> <font size="-2">Book List</fon t></a></td> <td align="center" valign="top"><a href="toc.htm"><img src="../../dcommon/gifs/conticon.gif" alt="Go to Table of Contents " border="0" /><br /> <font size="-2">Contents</font></a></td> <td align="center" valign="top"><a href="index.htm"><img src="../../dc ommon/gifs/indxicon.gif" alt="Go to Index" border="0" /><br /> <font size="-2">Index</font></a></td> <td align="center" valign="top"> <a href="../../mix$101/b12039/toc.htm"><img src="../../dcommon/gifs/mix.gif" alt="Go to Master Index" border="0" /><br /> <font size= "-2">Master Index</font></a></td> <td align="center" valign="top"><a href="../../dcommon/html/feedback.htm"><img src="../../dcom mon/gifs/feedback.gif" alt="Go to Feedback page" border="0" /><br /> <font size="-2">Feedback</font></a></td></tr></table></td></tr>< /table></div> </body> </html>