$Id: README,v 1.2 2005/05/05 06:19:43 alec Exp $

0. Co to?

Ten may zestaw narzdzi pozwala za pomoc squida w dosy elegancki sposb 
wywietla wiadomoci administracyjne oraz w razie potrzeby blokowa dostp
do w3cache. Oczywicie aby to dziaao w 100%, wszyscy klienci musz 
korzysta ze squida.

1. Instalacja.

Mona wyrni 3 etapy:

a) konfiguracja squida
b) konfiguracja redirectora
c) konfiguracja serwera wirtualnego

Ad a.

Do squid.conf dodajemy dwie linie:
------
redirector_bypass on
redirect_program /sciezka/do/lms-squid
------
ktre informuj squida aby dla kadego adresu uywa naszego redirectora.

Ad b.

Otwieramy w naszym ulubionym edytorze plik lms-squid i praktycznie wszystko 
co mona ustawi w naszym redirectorze to:
------
my $configfile = '/etc/lms/lms.ini';
------
Czyli pooenie pliku konfiguracyjnego. Reszta konfiguracji ustawiana jest 
w lms.ini, gdzie dopisujemy:
------
[redirector]
redirect        = http://nasz.serwer.pl/winetka/
------
Czyli adres winetki.

Ad c.

Do katalogu gdzie ma by widoczna winetka kopiujemy index.php, message.html 
i zawarto katalog img.

2. W dziaaniu.

Kluczowym elementem jest redirector. Odpowiada on za to, aby w momencie 
ustawienia dla danego komputera flagi warn lub no access, przekierowywa 
wszystkie dania wysyane do squida na nasz, ustalony wczeniej adres. 
Przekierowaniu nie ulegaj adresy zawierajce adres naszej winetki, tak aby 
umoliwi zaadowanie si obrazkw.

Jeli komputer ma ustawion flag warn, to po przekierowaniu uytkownik ma 
moliwo oznaczenia wiadomoci jako przeczytanej, po czym skrypt automatycznie 
kieruje przegldark na pierwotnie wywoywany URL, w przypadku oznaczeniu danego 
komputera jako wyczony, uytkownik bdzie zawsze przekierowywany na adres 
winetki, bez moliwoci oznaczenia wiadomoci jako przeczytanej.

Po drodze nigdzie nie s wykorzystywane adne reguki firewalla, ani aden
daemon nie jest przeadowywany. Skrypty podczas dziaania nie modyfikuj
adnych plikw. Jedyn wad moe by nieznaczne spowolnienie pracy squida
(przykadowo, na moim Athlonie 1.2 przetworzenie 2000 adresw, z czego poowa 
podlegaa przekierowaniu, a druga nie trwao 0,774 sekundy, co daje czas 
przetwarzania okoo 0,000387 sekundy na adres. W momencie pisania tego tekstu
strona gwna Wirtualnej Polski skadaa si z 62 elementw, przez co 
redirector zwikszy jej czas adowania o 0,023994 sekundy).