IsoQlog Version 1.7 UPGRADING ---------- if you are using version 1.5 or higher replace language file and isoqlog.pl with older ones Sorry , if you are using older versions, you can not upgrade :((, define new isolog directory for version 1.7 INSTALLATION ------------ # tar -zxvf isoqlog-1.7.tar.gz # cd isoqlog-1.7 1- edit /etc/syslog.conf and add following line if it is not exit mail.* /var/log/syslog or mail.* /var/log/maillog Probably, one of the above lines is already present in your syslog.conf run #ps aux|grep syslog #kill -HUP syslog.pid syslog.pid is the process id of syslog daemon 2- if you use splogger for logging qmail or if you want to use splogger, add splogger parameter your /var/qmail/rc file will look like following *************************************************** exec env - PATH="/var/qmail/bin:$PATH" \ qmail-start ./Maildir splogger qmail ************************************************ You MUST have the splogger parameter in your rc script. This is to check whether your rc file has it inside. If not, add it, if so, just leave as it is. 3- if you are an ISP or some big company, your qmail logfile becomes bigger than 30-40MB or so daily, it is necessary to rotate it . To use IsoQlog you MUST rotate your qmaillog file daily . Because IsoQlog looks at the beginning of logfile , if i wanted to test all the lines in the file for date it would spend so much memory. You can rotate your logfile via isoqlog-rotate.sh script under multilog directory.. you should also change the content of isoqlog-rotate.sh according to your logfile name and log directory. 3-Edit the isoqlog.conf file to change - output directory, - images directory, - logfile - your company - your domains and - your language file path. Default language is English you can translate it easily to another language,by changing lang.conf file . Now There is only Turkish ,English, German, Portuguese,Spanish Language Support. Note:If you want to translate isoqlog to another language. Edit english language file according to your language and send it to me :) 5- Create a directory , i recommend /usr/local/isoqlog # mkdir /usr/local/isoqlog Copy the isoqlog.pl, multilog/isoqlog-rotate.sh , isoqlog.conf and language file (that use choose under lang directory) to /usr/local/isoqlog 7-run the following command to edit crontab #crontab -e and add two following line 5 0 * * * /usr/local/isoqlog/isoqlog-rotate.sh 10 0 * * * /usr/bin/perl /usr/local/isoqlog/isoqlog.pl /usr/local/isoqlog/isoqlog.conf change above values if your files are not in /usr/local/isoqlog and your perl is not at /usr/sbin/perl 8- Copy to images to $imgurl (that you define in isoqlog.conf )for ex: /isoqlog/images 9 - After making changing values according to your system and your decision to test isoqlog , run # /usr/local/bin/tai64nlocal /var/log/qmail/isolog and run the following command in /usr/local/isoqlog directory #perl isoqlog.pl isoqlog.conf ,it will create html files on your system for example if your $isoqlogdir="/www/htdocs/isoqlog" you can see your log result at http://yourhost.com/maillog That is All Enjoy ! for bugs and comments send mail to Ismail YENIGUL ismail@enderunix.org EnderUNiX Software Development Team Member http://www.enderunix.org and R. Hutchinson hutch@midwales.com May 17, 2001