<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="security" content="public" /> <meta name="Robots" content="index,follow" /> <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' /> <meta name="DC.Type" content="topic" /> <meta name="DC.Title" content="JKL Toy Company monitors Web server activity with logs on HTTP Server (powered by Apache)" /> <meta name="abstract" content="This scenario discusses how to monitor Web server activity with logs." /> <meta name="description" content="This scenario discusses how to monitor Web server activity with logs." /> <meta name="DC.Relation" scheme="URI" content="rzaiescenarios.htm" /> <meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" /> <meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" /> <meta name="DC.Format" content="XHTML" /> <meta name="DC.Identifier" content="rzaiejklmonitor" /> <meta name="DC.Language" content="en-us" /> <!-- All rights reserved. Licensed Materials Property of IBM --> <!-- US Government Users Restricted Rights --> <!-- Use, duplication or disclosure restricted by --> <!-- GSA ADP Schedule Contract with IBM Corp. --> <link rel="stylesheet" type="text/css" href="./ibmdita.css" /> <link rel="stylesheet" type="text/css" href="./ic.css" /> <title>JKL Toy Company monitors Web server activity with logs on HTTP Server (powered by Apache)</title> </head> <body id="rzaiejklmonitor"><a name="rzaiejklmonitor"><!-- --></a> <!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script> <h1 class="topictitle1">JKL Toy Company monitors Web server activity with logs on HTTP Server (powered by Apache)</h1> <div><p>This scenario discusses how to monitor Web server activity with logs.</p> <div class="important"><span class="importanttitle">Important:</span> Information for this topic supports the latest PTF levels for HTTP Server for i5/OS . It is recommended that you install the latest PTFs to upgrade to the latest level of the HTTP Server for i5/OS. Some of the topics documented here are not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div> <div class="section"><h4 class="sectiontitle">Scenario</h4><p>The JKL Toy Company (a fictitious company) wants to know who is visiting their Web site. The <strong>JKLTEST</strong> server is already using a combined access log, but the JKL Web administrator wants to create a new access log that can be altered without affecting the data in the default access log file. By using this method, the JKL Web administrator will have two logs that can be formatted to log specific information.</p> <p>The JKL Web administrator found that enabling the logging function has some advantages and some disadvantages. Enabling the logging function does cause a small performance hit on the server, but a wide range of information about who is visiting the Web site can be obtained. After reading the information on log formats, the JKL Web administrator has decided to use the Combined, or NCSA Extended, log format.</p> <p>See <a href="rzaiemod_log_config.htm">Module mod_log_config for HTTP Server (powered by Apache)</a> for advanced information.</p> </div> <div class="section" id="rzaiejklmonitor__prerequisites"><a name="rzaiejklmonitor__prerequisites"><!-- --></a><h4 class="sectiontitle">Prerequisites</h4><ul><li>It is assumed you have read <a href="rzaiescenarios.htm">Scenarios for HTTP Server</a>.</li> <li>It is assumed you have read and completed <a href="rzaiejklbasic.htm">JKL Toy Company creates an HTTP Server (powered by Apache)</a> or you have an existing HTTP Server (powered by Apache) configuration.</li> </ul> </div> <div class="section"><h4 class="sectiontitle">Start the <span>IBM<sup>®</sup> Web Administration for i5/OS™ interface</span></h4><div class="note"><span class="notetitle">Note:</span> Enter your <a href="rzaiesetauth.htm">Webmaster user profile username and password</a> when prompted.</div> <ol><li>Start a <a href="rzaieinstalling.htm#rzaieinstalling__web">Web browser</a>.</li> <li>Enter <strong>http://[iSeries_hostname]:2001</strong> in the location or URL field .<p>Example: http://jkl_server:2001</p> <div class="note"><span class="notetitle">Note:</span> If you have <a href="rzaiechangeport.htm">changed your port number for the <span>IBM Web Administration for i5/OS interface</span></a>, replace port 2001 with your port number.</div> </li> <li>Click <strong>IBM HTTP Server for iSeries</strong>.</li> </ol> <div class="note"><span class="notetitle">Note:</span> If the <span>IBM Web Administration for i5/OS interface</span> does not start, see <a href="rzaieinstalling.htm">Install and test the HTTP Server</a>.</div> </div> <div class="section"><h4 class="sectiontitle">Set up a log file</h4><ol><li>Click the <strong>Manage</strong> tab.</li> <li>Click the <strong>HTTP Servers</strong> subtab.</li> <li>Select your HTTP Server (powered by Apache) instance from the <strong>Server</strong> list.<p>Example: JKLTEST</p> </li> <li>Select <strong>Global configuration</strong> from the <strong>Server area </strong>list.</li> <li>Expand <strong>Server Properties</strong>.</li> <li>Click <strong>Logging</strong>.</li> <li>Click the <strong>Custom Logs</strong> tab in the form.</li> <li>Click <strong>Add</strong> under the <strong>Custom logs</strong> table.</li> <li>Enter a name for the new log in the <strong>Log</strong> column.<p>Example: logs/server_monitor</p> <div class="note"><span class="notetitle">Note:</span> The above example creates a log file named <strong>server_monitor</strong> in the <strong>/logs</strong> directory.</div> </li> <li>Select <strong>combined</strong> from the <strong>Log format</strong> list in the <strong>Attributes</strong> column.</li> <li><strong>Optional</strong>: Accept the default Environment variable condition or enter a new value.</li> <li><strong>Optional</strong>: Accept the default expiration of the log or enter a new value.</li> <li><strong>Optional</strong>: Accept the default maximum cumulative seize or enter a new value.</li> <li>Click <strong>Continue</strong>.</li> <li><strong>Optional</strong>: Click <strong>Log identity of client. This may significantly degrade performance of the web server. </strong> under <strong>Client identity logging</strong>.<div class="note"><span class="notetitle">Note:</span> The option to <strong>Log identity of client</strong> will impact server performance by requiring a Domain Name Server (DNS) lookup every time a new client is logged. If you do not log the identity of the client the IP address of the client will be logged instead of the domain name. Some log analysis tools can perform DNS lookup, allowing identity of clients without impacting your performance.</div> </li> <li>Click <strong>OK</strong>.</li> </ol> </div> <div class="section"><h4 class="sectiontitle">Restart your HTTP Server (powered by Apache)</h4><p>Select one of the following methods below:</p> <p><strong>Manage one server</strong></p> <ol><li>Click the <strong>Manage</strong> tab.</li> <li>Click the <strong>HTTP Servers</strong> subtab.</li> <li>Select your HTTP Server from the Server list.</li> <li>Click the <strong>Stop</strong> icon if the server is running.</li> <li>Click the <strong>Start</strong> icon.</li> </ol> <p><strong>Manage all servers</strong></p> <ol><li>Click the <strong>Manage</strong> tab.</li> <li>Click the <strong>HTTP Servers</strong> subtab.</li> <li>Select <strong>All Servers</strong> from the Server list.</li> <li>Click the <span class="uicontrol">All HTTP Servers</span> tab.</li> <li>Select your HTTP Server name in the table.<p>Example: JKLTEST</p> </li> <li>Click <strong>Stop</strong> if the server is running.</li> <li>Click <strong>Start</strong>.</li> </ol> <div class="note"><span class="notetitle">Note:</span> If your HTTP Server (powered by Apache) does not start, see <a href="rzaietrouble.htm">Troubleshoot</a>.</div> </div> <p>Logging will begin when the HTTP Server (powered by Apache) instance has started. The JKL Web administrator has decided to use the <a href="http://www-4.ibm.com/software/webservers/siteanalyzer/" target="_blank">IBM Tivoli--Web site Analyzer</a> <img src="www.gif" alt="" /> to generate usage reports. This product can read the log file and generate detailed reports that contain information such as the following: </p> <br /><img src="rzaie502.gif" alt="Log analyzer example." /><br /><div class="section"><h4 class="sectiontitle">Test your HTTP Server (powered by Apache)</h4><ol><li>Open a new Web browser.</li> <li>Enter <strong>http://[iSeries_hostname]:[port]</strong> in the location or URL field.<p>Example: http://jkl_server:1975</p> </li> </ol> <p>Review your log for HTTP Server (powered by Apache) activity.</p> </div> <div class="section"><h4 class="sectiontitle">View your HTTP Server (powered by Apache) configuration</h4><p>Your configuration will look similar if you used the given example in this and previous examples.</p> <ol><li>Click the <strong>Manage</strong> tab.</li> <li>Click the <strong>HTTP Servers</strong> subtab.</li> <li>Select your HTTP Server (powered by Apache) from the <strong>Server</strong> list.<p>Example: JKLTEST</p> </li> <li>Expand <strong>Tools</strong>.</li> <li>Click <strong>Display Configuration File</strong>.</li> </ol> </div> <div class="section"><pre>Listen *:1975 DocumentRoot /www/jkltest/htdocs ServerRoot /www/jkltest Options -ExecCGI -FollowSymLinks -SymLinksIfOwnerMatch -Includes -IncludesNoExec -Indexes LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined LogFormat "%{Cookie}n \"%r\" %t" cookie LogFormat "%{User-agent}i" agent LogFormat "%{Referer}i -> %U" referer LogFormat "%h %l %u %t \"%r\" %>s %b" common CustomLog logs/access_log combined CustomLog logs/server_monitor combined SetEnvIf "User-Agent" "Mozilla/2" nokeepalive SetEnvIf "User-Agent" "JDK/1\.0" force-response-1.0 SetEnvIf "User-Agent" "Java/1\.0" force-response-1.0 SetEnvIf "User-Agent" "RealPlayer 4\.0" force-response-1.0 SetEnvIf "User-Agent" "MSIE 4\.0b2;" nokeepalive SetEnvIf "User-Agent" "MSIE 4\.0b2;" force-response-1.0 <Directory /> Order Deny,Allow Deny From all </Directory> <Directory /www/jkltest/htdocs> Order Allow,Deny Allow From all </Directory></pre> </div> </div> <div> <div class="familylinks"> <div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiescenarios.htm" title="This topic provides information on how to use the IBM Web Administration for i5/OS interface to set up or manage your HTTP Server, step-by-step. Each task is specific and includes a usable HTTP Server configuration file when completed.">Scenarios for HTTP Server</a></div> </div> </div> </body> </html>