X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=htdocs%2Fdocs%2Fsession.html;h=bd8edbab401c7f5b782d3ab5c7571261ede10534;hp=161be9846528c79f1b72714e01df70950b2a8044;hb=d220c8a4bfa1aee8f17ed71c2dba655160dd3595;hpb=2cdaa48390786a61eb9973b66ef771430351c8f8 diff --git a/htdocs/docs/session.html b/htdocs/docs/session.html index 161be9846..bd8edbab4 100644 --- a/htdocs/docs/session.html +++ b/htdocs/docs/session.html @@ -4,12 +4,11 @@

Session monitor

Installation

-For security reasons, the client portion of the session montior may run on an -external public machine. On this machine, install: +For security reasons, the client portion of the session montior may run on one +or more external public machine(s). On these machines, install:

Perl (at l -east 5.004_05 for the 5.004 series or 5.005_03 for the 5.005 series. Don't enab -le experimental features like threads or the PerlIO abstraction layer.) +east 5.004_05 for the 5.004 series or 5.005_03 for the 5.005 series. Don't enable experimental features like threads or the PerlIO abstraction layer.)
FS::SessionClient (copy the fs_session/FS-SessionClient directory to the external machine, then: perl Makefile.PL; make; make install)

Then: @@ -28,6 +27,11 @@ Then:

RADIUS
Web +
- Copy FS-SessionClient/cgi/login.cgi and logout.cgi to your web + server's document space. +
- Use suEXEC or setuid (see install.html for details) to run login.cgi and logout.cgi as the freeside user. +
Command-line
```
freeside-login username ( portnum | ip | nasnum nasport )
```
- portnum, ip or nasport and nasnum uniquely identify a port in the port database table.

Callbacks

Sesstion start - The command(s) specified in the session-start configuration file are executed on the Freeside machine. The contents of the file are treated as a double-quoted perl string, with the following variables available: $ip, $nasip and $nasfqdn, which are the IP address of the starting session, and the IP address and fully-qualified domain name of the NAS this session is on. +
Session end - The command(s) specified in the session-stop configuration file are executed on the Freeside machine. The contents of the file are treated as a double-quoted perl string, with the following variables available: $ip, $nasip and $nasfqdn, which are the IP address of the starting session, and the IP address and fully-qualified domain name of the NAS this session is on. +

Dropping expired users

+Run

bin/freeside-session-kill username

periodically from cron. - - - - - - +