Rozwiązywanie problemów

Instalacja biblioteki RRDtool

LinuxStat korzysta z tylko z fragmentu pakietu RRDtool. Do pracy wymaga pakietu RRDs.pm, który powinien znajdować się w katalogu na liście modułów PERLa (@INC). Listę katalogów aktualnie przeszukiwanych można wyświetlić poleceniem 

perl -V

Niektóre z pakietów rpm tej biblioteki instalują ją w innym miejscu (np. w katalogach poprzedniej wersji PERLa). W takim przypadku wystarczy odpowiednie pliki ręcznie przekopiować do właściwego katalogu.

Wstępna konfiguracja

Skrypt configure posiada wiele przydatnych przełączników. Ich pełna lista dostępna jest po wywołaniu 

./configure --help

Kompilacja i instalacja

Aby dostosować program do pracy z ekranem o rozdzielczości 800x600 (lub innym) można przeskalować wszystkie wykresy za pomocą ustawienia odpowiednich współczynników w ustawieniach programu (Parametry globalne)

Podczas instalacji z Apache, instalator może automatycznie uaktualnić httpd.conf, dopisując tam niezbędne linie. Można to wyłączyć, dopisując do listy parametrów configure przełącznik --noupdate_apache_conf. W takim przypadku należy samodzielnie dopisać następujące linie: 

#automatically added by LinuxStat installer
Alias /lstat/ /usr/local/lstat/www/

< Directory "/usr/local/lstat/www/">
#for execute CGI files
Options ExecCGI
AddHandler cgi-script .cgi
AllowOverride AuthConfig Limit

</Directory>
#end LinuxStat configuration

Warto zauważyć, że między cgi-script a .cgi jest SPACJA.

Pierwsze uruchomienie

Jeżeli po uruchomieniu lstatd pojawiają się błędy w rodzaju 
Software error:
Can't locate RRDs.pm in @INC (@INC contains: /usr/local/lstat/lib/
to znaczy, że biblioteka RRDtool nie została prawidłowo zainstalowana. Należy ją poprawnie zainstalować (zobacz instalacja biblioteki RRDTool)
Błąd 
Starting lstatd: Can't locate CGI.pm
oznacza brak bliblioteki CGI do perla. W niektórych dystrybucjach należy zainstalować pakiet perl-CGI lub pobrać ta bibliotekę z CPAN

Jeżeli po wpisaniu URLa do przeglądarki serwer nie chce pokazać żadnej strony, to należy sprawdzić poprawność URLa. A może Apache nie został przeładowany?

Jeżeli pojawia się tylko górny pasek menu z przyciskami i brak jakichkolwiek wykresów, to należy sprawdzić, czy została uruchomiona usługa lstatd.

Błąd podczas pierwszego uruchomienia, zawierający 

unable to graph /usr/local/lstat/www/statimg/load1_1d.png
ma taki sam powód jak wyżej.

Natomiast 

Software error: Cant open configfile /usr/local/lstat/etc/pages/user.config :
Permission denied at /usr/local/lstat/lib//Misc.pm line 169
spowodowane jest niewłaściwym ustawieniem praw do zapisu i odczytu. Instalator nie poradził sobie z wykryciem jakiego użytkownika używa serwer Apache. Należy mu to wskazać poprzez dodatkowe przełączniki podczas uruchomienia
./configure --with-wwwuser=USERNAME --with-wwwgroup=GROUPNAME
gdzie USERNAME i GROUPNAME to nazwa uzytkownika i grupy, ktora wykorzystuje Apache (przeważnie linia User i Group w httpd.conf)
Nie polecam ręcznego ustawiania tych praw.
Jeżeli jednak ktoś nie ma wyjścia, to prawa do plików i katalogów powinny być ustawione następująco: 
/usr/local/lstat drwxr-xr-x root
		|_bin drwxr-xr-x root
		|_etc drwxr-xr-x root
		   |_ objects drwx------ www
		   |_ pages  drwx------ www
		   	|_ lstat.soc srw-rw-rw- root

		|_lib drwxr-xr-x root
		|_www drwxr-xr-x root
		   |_ statimg  drwx------ www
www oznacza użytkownika i grupę, jaką używa serwer www. Jeżeli nie podano inaczej, to pliki i podkatalogi powinny mieć takie same prawa jak nadrzędne katalogi.

Inne problemy

Przy wykrywaniu problemów pomocne są logi błędów serwera WWW. Np. dla Apache może być to plik /var/log/httpd/error_log Tam można odnaleźć przyczynę braku wyświetlania się wykresów.
Przyczyną braku możliwości obserwacji na bieżąco może być niedziałająca usługa lstatd. Aby sprawdzić czy działa można przejrzeć listę procesów usług (polecenie ps x) lub uruchamiając polecenie /etc/rc.d/init.d/lstatd status Ta sama usługa odpowiada za uaktualnianie danych na wykresach.