Configuring Logging Support

Cerberus FTP Server logging is implemented through the Apache Log4cxx framework, a robust logging package modeled after log4j. The default logging logs up to 5000KB of data to a single file and then rolls over to a new log file. The 5 past log files are kept by default but log file size, naming, and history are all completely configurable through the log4j.xml file.

The log is under:

C:\ProgramData\Cerberus LLC\Cerberus FTP Server\log on Windows Vista, Windows 2008 and above

and

C:\Documents and Settings\Application Data\Cerberus LLC\Cerberus FTP Server\log on Windows 2003, XP, and 2000.

The log4j.xml configuration file is one level above in the "Cerberus FTP Server" folder. An example log4j.xml file is below:

 <?xml version="1.0" encoding="UTF-8" ?>
 <log4j:configuration xmlns:log4j='http://logging.apache.org/' debug="false">
  
	<appender name="FILE" class="org.apache.log4j.rolling.RollingFileAppender">
		<rollingPolicy class="org.apache.log4j.rolling.FixedWindowRollingPolicy" >
			<param name="activeFileName" value="log/server.log" />
			<param name="fileNamePattern" value="log/server.%i.log" />
			<param name="minIndex" value="1" />
			<param name="maxIndex" value="5" />
		</rollingPolicy>
		<triggeringPolicy class="org.apache.log4j.rolling.SizeBasedTriggeringPolicy">
			<param name="maxFileSize" value="5000KB" />
		</triggeringPolicy>
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" 
				value="[%d{yyyy-MM-dd HH:mm:ss}]:%7.7p [%6.6x] - %m%n" />
		</layout>
	</appender>  

	<appender name="ERROR_FILE" class="org.apache.log4j.rolling.RollingFileAppender">          
		<rollingPolicy class="org.apache.log4j.rolling.FixedWindowRollingPolicy">
			<param name="activeFileName" value="log/server_error.log"/>
			<param name="fileNamePattern" value="log/server_error.%i.log"/>
		</rollingPolicy>
		<triggeringPolicy class="org.apache.log4j.rolling.SizeBasedTriggeringPolicy">
			<param name="maxFileSize" value="5000KB"/>
		</triggeringPolicy>
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss}]:%7.7p [%6.6x]
				 - %m%n"/>
		</layout>
		<filter class="org.apache.log4j.varia.LevelRangeFilter">
			<param name="LevelMin" value="ERROR" />
		</filter>
	</appender>

		 
	<root>
		<level value="INFO" class="org.apache.log4j.xml.XLevel" />
		<appender-ref ref="FILE"/>
		<appender-ref ref="ERROR_FILE"/>
	</root>
 </log4j:configuration>

Possible values for the <level value="level" class="org.apache.log4j.xml.XLevel" /> tag's level parameter are:

TRACE
DEBUG
INFO
WARN
ERROR

Screen Logging Settings

Logging settings page

In addition to the file-based log, Cerberus also displays the current log output to the graphical user interface while the server is running. Options for the screen-based logging can be controlled through the Logging settings tab of the Server Manager.

Log messages to screen - Enable logging messages to the screen
Onscreen log length - The number of lines of on-screen logging that should be saved