Cisco Systems H.323 manual Logging, Rotating Log Files, Convention for Naming the Log File

Chapter 4 Managing the Cisco HSI

Logging

Logging

The logging level of one or more service packages is set using the set-logMML command. For more information about this command, see Appendix A, “MML User Interface and Command Reference.”

Rotating Log Files

Log files are rotated at system startup or when either of the following conditions occurs:

•The size limit for the corresponding file is reached. The size of the corresponding log file is equal to or greater than the value that the LOGFILEROTATESIZE configuration parameter specifies. The default value for this parameter is 10 Mb (see Chapter 3, “Provisioning the Cisco HSI”).

•The age limit for the corresponding file is reached. The corresponding log file is equal to or older than the interval that the LOGFILEROTATEINTERVAL parameter specifies. The default value for this parameter is 1440 minutes (24 hours). See Chapter 3, “Provisioning the Cisco HSI,” for more information about this parameter.

Convention for Naming the Log File

Log rotation occurs when the system ceases to write to the current log file and commences to write to a new log file. The LOGFILENAMEPREFIX parameter defines the name of the active log file (see Chapter 3, “Provisioning the Cisco HSI”). The default is platform.log.

When log rotation is triggered, the existing file (for example, platform.log) is renamed with the format platform_yyyymmddhhmmss.log (see Table 4-4). For example, a platform error file rotated on September 30, 1999 at 12:36:24 is renamed platform_19990930123624.

Table 4-4 Log Filename Format

Format	Definition
LOGFILENAMEPREFIX	Provisioned filename (default is platform.log)
yyyy	Year
mm	Month
dd	Day
hh	Hour
mm	Minute
ss	Second

Note The time stamp is the coordinated universal time (CUT) from the machine at the time of rotation.

Log File Location

The LOGDIRECTORY parameter defines the directory for active log files and rotated log files (see Chapter 3, “Provisioning the Cisco HSI”). The default is $GWHOME/var/log/.

	Cisco H.323 Signaling Interface User Guide
OL-4806-01 Rev. A14		4-9