analytics/configuration/ipfCSTclientconfig.xml.sample

<?xml version="1.0" encoding="UTF-8"?>
<!--
    Licensed Materials - Property of IBM

    IBM Cognos Products: cst

    (C) Copyright IBM Corp. 2008, 2010

    US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
-->
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
	<renderer renderedClass="com.cognos.indications.LogIndication" renderingClass="com.cognos.indications.LogIndicationRenderer"/>
	<renderer renderedClass="com.cognos.indications.LogAuditIndication" renderingClass="com.cognos.indications.LogAuditRenderer"/>
	<renderer renderedClass="com.cognos.indications.LogAuditAccessIndication" renderingClass="com.cognos.indications.LogAuditAccessRenderer"/>
	<renderer renderedClass="com.cognos.indications.LogPerfIndication" renderingClass="com.cognos.indications.LogPerfRenderer"/>
	<renderer renderedClass="com.cognos.indications.LogTraceIndication" renderingClass="com.cognos.indications.LogTraceRenderer"/>
	<renderer renderedClass="com.cognos.indications.LogValueTraceIndication" renderingClass="com.cognos.indications.LogValueTraceRenderer"/>
	<appender name="AuditAppender" class="org.apache.log4j.RollingFileAppender">
		<!-- The setting for the File parameter below has been tested with IBM Cognos 8 while 
			running under Tomcat.Because of their 'current working directory', 
			other application servers (e.g. WebLogic), may require that an absolute path 
			to the log file be specified. Ensure the log directory is writable.
		-->
		<param name="File" value="../logs/CST_Audit.log"/>
		<param name="MaxBackupIndex" value="1"/>
		<param name="MaximumFileSize" value="10485760"/>
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" value="%m%n"/>
		</layout>
	</appender>
	<appender name="PerfAppender" class="org.apache.log4j.RollingFileAppender">
		<!-- The setting for the File parameter below has been tested with IBM Cognos 8 while 
			running under Tomcat.Because of their 'current working directory', 
			other application servers (e.g. WebLogic), may require that an absolute path 
			to the log file be specified. Ensure the log directory is writable.
		-->
		<param name="File" value="../logs/CST_Perf.log"/>
		<param name="MaxBackupIndex" value="1"/>
		<param name="MaximumFileSize" value="10485760"/>
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" value="%m%n"/>
		</layout>
	</appender>
	<appender name="clientRemote" class="com.cognos.indications.LogLocalUDPAppender">
		<!-- Change the Port value below to match the Log Server Port Number in Cognos Configuration -->
		<param name="Port" value="9362"/>
	</appender>
	<appender name="clientTCP" class="com.cognos.indications.LogTCPSocketAppender">
		<param name="remoteHost" value="127.0.0.1"/>
		<!-- Change the Port value below to match the Log Server Port Number in Cognos Configuration -->
		<param name="Port" value="9362"/>
		<param name="LocationInfo" value="false"/>
		<param name="ReconnectionDelay" value="30000"/>
	</appender>
	<appender name="ipfLocalFileWithFilter" class="org.apache.log4j.RollingFileAppender">
		<!-- The setting for the File parameter below has been tested with IBM Cognos 8 while 
			running under Tomcat.Because of their 'current working directory', 
			other application servers (e.g. WebLogic), may require that an absolute path 
			to the log file be specified. Ensure the log directory is writable.
		-->
		<param name="File" value="../logs/crnclientWarn.log"/>
		<param name="MaxBackupIndex" value="1"/>
		<param name="MaximumFileSize" value="10485760"/>
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" value="%m%n"/>
		</layout>
		<filter class="org.apache.log4j.varia.LevelRangeFilter">
			<param name="LevelMin" value="WARN"/>
			<param name="LevelMax" value="WARN"/>
		</filter>
	</appender>
	<appender name="clientSTDOUT" class="org.apache.log4j.ConsoleAppender">
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" value="%m%n"/>
		</layout>
	</appender>
	<!-- ***************THIS SECTION CONTAINS THE Audit APPENDER *********************-->
	<category name="Audit" class="com.cognos.indications.LogTypedLogger">
		<level value="warn"/>
		<!-- Change the appender refence below to match the Log Server Enable TCP in Cognos Configuration
	    	If Enable TCP is False, use clientRemote; otherwise use clientTCP
		-->
		<!--appender-ref ref="ipfLocalFile"/-->
		<appender-ref ref="clientRemote"/>
	</category>
	<!-- ***************THIS SECTION CONTAINS THE Trace APPENDER *********************-->
	<category name="Trace" class="com.cognos.indications.LogTypedLogger">
		<level value="off"/>
	</category>
	<!-- ***************THIS SECTION CONTAINS THE Perf APPENDER *********************-->
	<category name="Perf" class="com.cognos.indications.LogTypedLogger">
		<level value="off"/>
	</category>
	<!-- ************THIS SECTION CONTAINS CST SPECIFIC APPENDERS ***************-->
	<!--
		The following is a list of logging levels from most to least verbose:
		
			{debug, info, error, fatal, off}

			'fatal', 'error' and 'info' levels are for logging failed scenarios

			'fatal' = fatal exception message
			'error' = exception message + SOAP request
			'info' = exception message + SOAP request + SOAP response

			'debug' level is for logging all SOAP requests and responses.

		For stability and performance related issues, turn on Perf.CST to "debug" level.  This 
		helps Cognos understand the usage patterns. 

		For functionality problems, turn Audit.RTUsage.CST "info" or "debug" level.
	-->
	<category name="Perf.CST" class="com.cognos.indications.LogTypedLogger">
		<level value="debug"/>
		<appender-ref ref="PerfAppender"/>
	</category>
	<!-- enable the level you need for debugging -->
	<category name="Audit.RTUsage.CST" class="com.cognos.indications.LogTypedLogger">
		<level value="info"/>
		<appender-ref ref="AuditAppender"/>
	</category>
	<categoryFactory class="com.cognos.indications.LogTypedFactory"/>
</log4j:configuration>