Class RollingLogFile

java.lang.Object

com.netscape.certsrv.logging.LogEventListener

com.netscape.cms.logging.LogFile

com.netscape.cms.logging.RollingLogFile

All Implemented Interfaces:

IExtendedPluginInfo, EventListener

public class RollingLogFile
extends LogFile

A rotating log file for Certificate log events. This class loosely follows the Netscape Common Log API implementing rollover interval, size and file naming conventions. It does not yet implement Disk Usage.

Version:

$Revision$, $Date$

Field Summary

Fields

Modifier and Type	Field	Description
static org.slf4j.Logger	logger
protected long	mExpirationTime	The amount of time before a backed up log is removed in milliseconds
protected int	mMaxFileSize	The maximum file size in bytes
protected long	mRolloverInterval	The amount of time in miniseconds between log rotations

Fields inherited from class LogFile

filters, mandatoryEvents, mBufferSize, mBytesUnflushed, mBytesWritten, mConfig, mDate, mDatePattern, mFile, mFileName, mFlushInterval, mLevel, mLogDateFormat, mLogFileDateFormat, mLogSigning, mLogWriter, mOn, mRegister, mTrace, mType, selectedEvents

Fields inherited from class LogEventListener

engine

Fields inherited from interface IExtendedPluginInfo

HELP_TEXT, HELP_TOKEN

Constructor Summary

Constructors

Constructor	Description
RollingLogFile()	Construct a RollingLogFile

Method Summary

Modifier and Type	Method	Description
long	expire(long expirationSeconds)	Remove any log files which have not been modified in the specified time
protected String[]	fileList()	Get the log file list in the log directory
Vector<String>	getDefaultParams()	Return list of default config parameters for this log event listener.
String	getDescription()	Returns the description of this log event listener.
int	getExpirationTime()	Get the expiration time
String[]	getExtendedPluginInfo()	This method returns an array of strings.
String	getImplName()	Returns implementation name.
Vector<String>	getInstanceParams()	Return list of instance config parameters for this log event listener.
int	getRolloverTime()	Get the rollover interval
void	init(LoggerConfig config)	Initialize and open a RollingLogFile using the prop config store
void	log(LogEvent ev)	Write an event to the log file
NameValuePairs	retrieveLogList(Hashtable<String,String> req)	Retrieve log file list.
protected void	rl_init(int maxFileSize, String rolloverInterval, String expirationTime)	Convenience routine to initialized the RollingLogFile specific attributes.
void	rotate()	Rotate the log file to a backup file with timestamp
void	setExpirationTime(String expirationSeconds)	Set the file expiration time
void	setRolloverTime(String rolloverSeconds)	Set the rollover interval
void	shutdown()	Shutdown this log file.
void	startup()	Startup the instance

Methods inherited from class LogFile

base64Encode, close, deselectEvent, doLog, eval, eval, eval, eval, eval, eval, eval, filter, flush, getConfigStore, getLevel, getName, getOn, getType, init, init, logEvt2String, open, readEntry, replaceEvents, retrieveLogContent, selectEvent, setFlushInterval

Methods inherited from class LogEventListener

getCMSEngine, setCMSEngine

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

logger

public static org.slf4j.Logger logger

mMaxFileSize

protected int mMaxFileSize

The maximum file size in bytes

mRolloverInterval

protected long mRolloverInterval

The amount of time in miniseconds between log rotations

mExpirationTime

protected long mExpirationTime

The amount of time before a backed up log is removed in milliseconds

Constructor Details

RollingLogFile

public RollingLogFile()

Construct a RollingLogFile

Method Details

init

public void init(LoggerConfig config)
          throws IOException,
EBaseException

Initialize and open a RollingLogFile using the prop config store

Overrides:

init in class LogFile

Parameters:

config - The property config store to find values in

Throws:

IOException

EBaseException

rl_init

protected void rl_init(int maxFileSize,
 String rolloverInterval,
 String expirationTime)

Convenience routine to initialized the RollingLogFile specific attributes.

startup

public void startup()
             throws EBaseException

Description copied from class: LogFile

Startup the instance

• signed.audit LOGGING_SIGNED_AUDIT_AUDIT_LOG_STARTUP used at audit function startup

Overrides:

startup in class LogFile

Throws:

EBaseException - if an internal error occurred

shutdown

public void shutdown()

Shutdown this log file.

Overrides:

shutdown in class LogFile

setRolloverTime

public void setRolloverTime(String rolloverSeconds)

Set the rollover interval

Parameters:

rolloverSeconds - The amount of time in seconds until the log is rotated. A value of 0 will disable log rollover.

getRolloverTime

public int getRolloverTime()

Get the rollover interval

Returns:

The interval in seconds in which the log is rotated

setExpirationTime

public void setExpirationTime(String expirationSeconds)

Set the file expiration time

Parameters:

expirationSeconds - The amount of time in seconds until log files are deleted

getExpirationTime

public int getExpirationTime()

Get the expiration time

Returns:

The age in seconds in which log files are delete

rotate

public void rotate()
            throws IOException

Rotate the log file to a backup file with timestamp

Throws:

IOException

expire

public long expire(long expirationSeconds)
            throws ELogException

Remove any log files which have not been modified in the specified time

NOTE: automatic removal of log files is currently NOT supported!

• signed.audit LOGGING_SIGNED_AUDIT_LOG_DELETE used AFTER audit log expires (authorization should not allow, but in case authorization gets compromised make sure it is written AFTER the log expiration happens)

Parameters:

expirationSeconds - The number of seconds since the expired files have been modified.

Returns:

the time in milliseconds when the next file expires

Throws:

ELogException

log

public void log(LogEvent ev)
         throws ELogException

Write an event to the log file

Overrides:

log in class LogFile

Parameters:

ev - The event to be logged.

Throws:

ELogException

retrieveLogList

public NameValuePairs retrieveLogList(Hashtable<String,String> req)
                               throws jakarta.servlet.ServletException,
IOException,
EBaseException

Retrieve log file list.

Overrides:

retrieveLogList in class LogFile

Throws:

jakarta.servlet.ServletException

IOException

EBaseException

fileList

protected String[] fileList()

Get the log file list in the log directory

Returns:

an array of filenames with related path to cert server root

getImplName

public String getImplName()

Description copied from class: LogEventListener

Returns implementation name.

Overrides:

getImplName in class LogFile

Returns:

String name of event listener implementation.

getDescription

public String getDescription()

Description copied from class: LogEventListener

Returns the description of this log event listener.

Overrides:

getDescription in class LogFile

Returns:

String with listener description.

getDefaultParams

public Vector<String> getDefaultParams()

Description copied from class: LogEventListener

Return list of default config parameters for this log event listener.

Overrides:

getDefaultParams in class LogFile

Returns:

Vector of default parameters.

getInstanceParams

public Vector<String> getInstanceParams()

Description copied from class: LogEventListener

Return list of instance config parameters for this log event listener.

Overrides:

getInstanceParams in class LogFile

Returns:

Vector of instance parameters.

getExtendedPluginInfo

public String[] getExtendedPluginInfo()

Description copied from interface: IExtendedPluginInfo

This method returns an array of strings. Each element of the array represents a configurable parameter, or some other meta-info (such as help-token) there is an entry indexed on that parameter name Where: type_info is either 'string', 'number', 'boolean', 'password' or 'choice(ch1,ch2,ch3,...)' If the marker 'required' is included after the type_info, the parameter will has some visually distinctive marking in the UI. 'description' is a short sentence describing the parameter 'choice' is rendered as a drop-down list. The first parameter in the list will be activated by default 'boolean' is rendered as a checkbox. The resulting parameter will be either 'true' or 'false' 'string' allows any characters 'number' allows only numbers 'password' is rendered as a password field (the characters are replaced with *'s when being types. This parameter is not passed through to the plugin. It is instead inserted directly into the password cache keyed on the instance name. The value of the parameter 'bindPWPrompt' (see example below) is set to the key. In addition to the configurable parameters, the following magic parameters may be defined: HELP_TOKEN;helptoken - a pointer to the online manual section for this plugin HELP_TEXT;helptext - a general help string describing the plugin For example: "username;string;The username you wish to login as" "bindPWPrompt;password;Enter password to bind as above user with" "algorithm;choice(RSA,DSA);Which algorithm do you want to use" "enable;boolean;Do you want to run this plugin" "port;number;Which port number do you want to use"

Specified by:

getExtendedPluginInfo in interface IExtendedPluginInfo

Overrides:

getExtendedPluginInfo in class LogFile