IsoQlog Version 1.7 #INSTALLATION for Multilog Systems UPGRADING ---------- if you are using version 1.5 or higher replace language file and isoqlog.pl with older ones if you are using older versions<=1.4, 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- if you installed qmail by reading LWQ Howto (http://www.lifewithqmail.org/lwq.html) you should have /var/qmail/supervise/qmail-send/log/run file and this file look like the following #!/bin/sh exec /usr/local/bin/setuidgid qmaill /usr/local/bin/multilog /var/log/qmail append !isoqlogappend parameter to the file as such: #!/bin/sh exec /usr/local/bin/setuidgid qmaill /usr/local/bin/multilog t !isoqlogappend /var/log/qmail if your file is in a different place or does not exist, give !isoqlogappend parameter to multilog command , or however you run it. Note:never give !!!! "ssize" parameter to multilog to change the size of log file The above ssize parameter is used by the multilog to set the maximum log file size, however, if you give that parameter, there appears a log file completely different from what IsoQlog expects. The drawback is that, IsoQlog will not be able to strip the date from the log file, and you will see 0's in your HTMLs :) isoqlogappend file looks like the following: #!/bin/sh /usr/local/bin/tai64nlocal >>/var/log/qmail/isolog it means , when /var/log/qmail/current file becomes 100 KB run tai64nlocal command and redirect output of tai64nlocal to /var/log/qmail/isoqlog , so isolog file will be human readable note:Please change /var/log/qmail directory , in isoqlogappend if your current file is in different location Copy isoqlogappend (under multilog directory ) to /bin change it's mode to 755 #cp multilog/isoqlogappend /bin #chmod 755 /bin/isoqlogappend and restart qmail 2- 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 ,Portuguese , German ,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/isoqlog That is All Enjoy ! for bugs and comments send mail to ismail@enderunix.org Ismail YENIGUL and R. Hutchinson hutch@midwales.com May 17, 2001 EnderUNiX Software Development Team Member http://www.enderunix.org