This chapter contains information on the requirements for creating and configuring the Oracle Communications Offline Mediation Controller Syslog Collection Cartridge Pack.
The file /etc/syslog.conf contains information used by syslogd, the syslog daemon process, to forward a system message to appropriate log files and/or users. The syntax is explained below.
The configuration entry is composed of two tab-separated fields:
Syntax: <selector> <action>
Example 1:
mail.alert /var/adm/messages
Example 2:
mail.alert @10.13.3.28
The shell script newsyslog rotates the log file that is run by the cron job. This script is provided by Sun as part of the Solaris package. You can either edit this file or create your own script and add it to the cron tab. The file location is: /usr/lib/newsyslog.
Here is a sample newsyslog shell script:
#! /bin/sh
LOG=TestLog
EXT=complete
cd /var/adm
if test -s $LOG
then
test -f $LOG"_2."$EXT && mv $LOG"_2."$EXT $LOG"_3."$EXT
test -f $LOG"_1."$EXT && mv $LOG"_1."$EXT $LOG"_2."$EXT
test -f $LOG"_0."$EXT && mv $LOG"_0."$EXT $LOG"_1."$EXT
test -f $LOG && mv $LOG $LOG"_0."$EXT
cp /dev/null $LOG
chmod 644 $LOG
fi
The logadm is a general log rotation tool that is run by the cron job. You need to specify the configuration options for the logadm in the /etc/logadm.conf file. Then you can configure the cron job to run the rotation tool every hour, or for another specified time period.
The syntax is: <log name> <options>
For example: /var/adm/messages -C 10 -t '/var/adm/messages_$N.complete'
The necessary rotation options for a log file are as follows:
-s size: use b for bytes, k for kilobytes, m for megabytes, or g for gigabytes
-C count
-t template: specify the template to use when renaming log files:
$file - The full path name of the file to be rotated.
$n - The version number, 0 is most recent, 1 is next most recent, and so on.
$N - The same as $n, but starts at 1 instead of zero.
There are additional options but the above options are the only necessary ones for this cartridge pack.
If you are using the default configuration for the logadm, you need to configure the cron job as follows:
0 * * * * /usr/sbin/logadm
If you are using your own configuration for the logadm, you need to configure the cron job as follows:
0 * * * * /usr/sbin/logadm -f <config file name>
Using the example: /var/adm/messages -C 10 -t '/var/adm/messages_$N.complete', the log file will be rotated and renamed every hour as follows:
/var/adm/messages_1.complete, /var/adm/messages_2.complete, /var/adm/messages_3.complete
........up to
/var/adm/messages_10.complete
The file /etc/syslog.conf contains information used by syslogd and the syslog daemon process, to forward a system message to appropriate log files or users or both. Since AIX has no logrotate daemon running, you must adapt syslogd to do the syslog rotation. The format would be
Syntax: <selector> <action> <rotate_info>
Example 1:
mail.debug /var/log/mail rotate size 100k files 4 # 4 files, 100kB each
Example 2:
user.debug /var/log/user rotate files 12 time 1h # 12 files, hourly rotate
Rotation can be based on size or time or both.
Size: This keyword specifies that rotation is based on size. It is followed by a number and either a k (kilobytes) or m (megabytes).
Time: This keyword specifies that rotation is based on time. It is followed by a number and either a h(hour) or d(day) or w(week) or m(month) or y(year).