$Id: README,v 1.6 2005/08/26 05:42:27 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).

3. Co zrobi jeli nie dziaa.

Jeli redirector nie dziaa w ogle, lub nie dziaa tak jak bymy chcieli, 
pierwsze co naley zrobi, to sprawdzi czy nasz system spenia wymagania LMSa,
oraz czy zrobilimy wszystko co jest wymagane podczas instalacji redirectora. 
Nastpnie, warto zajrze w logi Squida. Jeli znajdziemy w logach co takiego 
(99% przypadkw):

Mar 14 11:20:09 localhost squid[27459]: WARNING: redirector #1 (FD 7) exited 
Mar 14 11:20:09 localhost squid[27459]: WARNING: redirector #2 (FD 8) exited 
Mar 14 11:20:09 localhost squid[27459]: WARNING: redirector #3 (FD 9) exited 
Mar 14 11:20:09 localhost squid[27459]: Too few redirector processes are 
running 
Mar 14 11:20:09 localhost squid[27459]: The redirector helpers are crashing too 
rapidly, need help! 

to wszystkiemu winien jest sam redirector. Uruchamiamy wic redirector "z 
palca" czy te jak mwi inni - w trybie interaktywnym, czyli wydajemy komend:

./lms-squid

najlepiej bdc zalogowanym jako root. Wszystko co powinnimy teraz zobaczy, 
to migajcy kursor. Jeli widzisz jakie komunikaty, to radz dokadnie je 
przeczyta, gdy bd to komunikaty bdw i zarazem wskazwka czego brak. 
Jeli natomiast widzimy wesoo migajcy kursor, wpisujemy dowolny tekst, oraz 
naciskamy enter:

test

Redirector powinien wysa nam co w stylu 

302:http://adres_winetki/?oldurl=test

czyli adres przekierowania, oraz kontynuowa prac. Jeli redirector w tym 
momencie zamyka si, oraz wywietla komunikat bdu, mamy nastpn wskazwk. 
Jeli natomiast nadal pracuje wpisujemy:

http://lms.rulez.pl/ 192.168.0.1/-

gdzie 192.168.0.1 jest adresem z naszej sieci, ktry nie podlega przekierowaniu. 
Redirector powinien odpowiedzie dokadnie tym samym co wpisalimy. Jeli nie, 
kolejna wskazwka.

Jeli redirector nadal kontynuuje prac, sprbuj wykona powysze czynnoci na 
koncie na ktrym pracuje squid. Czyli robimy np.

su proxy
./lms-squid

Jeli na koncie na ktrym pracuje squid redirector dziaa poprawnie, naley 
sprawdzi jeszcze raz konfiguracj squida. Jeli to nadal nic nie daje, sprawd 
wszystkie nietypowe rzeczy w twoim systemie (by moe uywasz chroot, i w 
chrootowanym rodowisku brakuje bibliotek).
