Ozzu Webmaster Forum
Free webmaster help for designing, programming, cgi, servers, linux, and more




Produced by Unmelted Enterprises


| FEATURES | INSTALLATION | MANUAL | DEMO | PURCHASE |



This installation page will walk you through the installation process for The Exterminator. There are basically two areas to the program. There is the part of the program that detects when a user is using an unauthorized program, and then there is the admin interface which allows you to view your banned IP list, and manually ban and remove IPs.


REQUIREMENTS
- Latest version of PERL installed on your server
- Are able to change permission to files
- Server must support the use of .htaccess files
- .htaccess file should support the LIMIT command
- Unix server recommended with Apache


FILES INCLUDED
.htaccess
.htaccess2
admin.cgi


adminlog.dat
error.jpg
exterminator.jpg
README.txt
stop.jpg
tpassword.dat
PERMISSION SETTINGS
.htaccess
chmod 777
tpassword.dat
chmod 777
admin.cgi
chmod 755
stop.jpg
chmod 755
adminlog.dat
chmod 733
.htaccess2
chmod 644
error.jpg
chmod 644
exterminator.jpg
chmod 644
README.txt
chmod 600


INSTALLATION STEPS
In the members area download The Exterminator zip file. You will need a program which can decompress zip files. I recommend WINZIP. After opening the zip file make sure the above files are all included in the package. Once you are sure they are all there make a directory on your server called "exterminator". To that "exterminator" directory upload the following files:

admin.cgi
adminlog.dat
error.jpg
exterminator.jpg
README.txt
tpassword.dat

Now you need to upload the script that really does the work. You need to create a directory that sounds like it has something to do with your site. This directory will contain the script that does all the work for detecting and banning users who have leeching programs. So for example if you have a wallpaper site that displays high resolution images you might create a directory called "wallpaper" or if that is already being used then maybe something else along that line. It is important to remember that this directory is only for the script you are about to upload. You cannot place any other files in this directory. Its bascially a fake directory that will act as the red herring to pull in the leechers. So for installation purposes lets say we called that directory "wallpaper". Now in the wallpaper directory upload the following two files:

.htaccess2
stop.jpg

You should now rename these two files in the directory. The .htaccess2 file should be renamed to ".htaccess". So basically remove the number 2 off the end. The other file "stop.jpg" should be renamed to something that sounds like it is also a part of your site. So if you have a wallpaper site you might rename stop.jpg to "wallpaper05.jpg".

The last file we will need to upload is the ".htaccess" file from the zip file. This .htaccess file is different from .htaccess2, so make sure you are uploading the right ones. Upload .htaccess to your root directory for your website. If you already are using a .htaccess file in that root directory you will need to combine the two so that the .htaccess directory that exists contains the stuff your old did and what our .htaccess file has.

Now that we have all our required files uploaded we need to modify a few paths and change the permissions to the files so that they can be operated correctly. The first path that you need to change is the path in admin.cgi. So open up admin.cgi and look for a variable that says $defaultpath. The stuff in the parenthesis is what needs to be changed to match your servers configuration. This server path should point to your websites root directory. So for example it might end up reading:

$defaultpath = "/usr/brian/public_html/bigwebmaster.com/";

Now you should open up stop.jpg with a text editor. Yes it is a text file, not a picture, and also edit the $defaultpath to be the same as it is in admin.cgi. The path should point to your websites root directory.

Now that you have edited all your paths be sure that you upload those changes to your server. Once that is done we need to change the permissions to some of these files. You can use the chart above to edit the permissions to the correct settings. If you are unsure how change permission to files you should visit the PERL LESSONS section.

The very last thing we need to do is place a few fake links throughout your websites so that the leeching programs will follow them to your red herring (stop.jpg or whatever you named it to). So for example on most sites the main page that people come to is index.html. So on that html page you should place a link towards the top of your page, preferrably right after the body tag somewhere. The link should be a regular link that links to nothing. So for example you might have it something like this:

<a href="wallpaper/wallpaper05.jpg"></a>

Notice how it doesn't really link to anything which is what we want. This means that it will not show up at all to your visitors, but programs like Paqrat and other leechers will still see this link and follow it to wallpaper05.jpg where it will attempt to download it. Once this wallpaper05.jpg is touched it will immediately update the .htaccess file to ban that user from your site. The last thing you should do is load your web browswer and goto

http://www.yoursite.com/exterminator/admin.cgi

where yoursite.com is actually your site. If you see a login screen then you are all set. The default password is admin, and one of the first things you should do is enter the script and change the password to something else. Good luck!!!

INSTALLATION HELP
If you feel uncomfortable installing the script we are available to install it for you for a small fee.




| PRIVACY STATEMENT | TERMS & CONDITIONS | CONTACT US |




Exterminator Supporters - Webmaster Resources - Webmaster Forum
Guestbook Script