Instalacja

Instalacja biblioteki RRDtool

Niektóre dystrybucje np. Mandrake posiadają już tą bibliotekę w postaci pakietów RPM. Zawsze możemy ją samodzielnie skompilować, w sposób opisany poniżej.
Ze strony autora ściągamy najnowszą wersję biblioteki RRDtool rrdtool.tar.gz.

Następnie rozpakowujemy archiwum poleceniem 

tar -xzvf rrdtool.tar.gz

zmieniamy bieżący katalog na rozpakowany np.: 

cd rrdtool-1.2.13

i wydajemy kolejno polecenia: 

./configure --disable-tcl --enable-perl-site-install --disable-python
make
make install

Uaktualnienie

Uaktualnienie programu do najnowszej wersji odbywa się poprzez instalację w tych samych katalogach. Utworzone poprzednio wykresy i strony nie zostaną utracone. Zauważ, że program instalowany z pakietu rpm umieszcza swoje dane w innym katalogu niż domyślny i nie nadpisuje pliku konfiguracyjnego dla Apache.

Osoby, które używały wersji 2.0 powinny przed zainstalowaniem nowej wersji usunąć z pliku konfiguracyjnego Apache (httpd.conf) wpisy dotyczące LinuxStat. Chodzi o linie znajdujące się między komentarzami added by LinuxStat

Nie ma możliwości aktualizacji programu z wersji 0.94. Obecna wersja jest zbyt rozbudowana. Przed jej instalacją należy usunąć źródła potencjalnych konfliktów. Choć możliwe jest jednoczesne używanie obu wersji programu zaleca się usunięcie poprzedniej wersji. W tym celu należy:

  1. usunąć linię wywołującą skrypt updaterrd z crontab

  2. usunąć wpisy dokonane w pliku konfiguracyjnych Apache (httpd.conf).

  3. usunąć katalog z danymi i programem (/usr/local/lstat-0.9)

Instalacja

Rozpakowujemy archiwum poleceniem 

tar -xzvf lstat-2.3.2.tar.gz

zmieniamy bieżący katalog na rozpakowany np.: 

cd lstat-2.3.2

następnie należy uruchomić plik configure z odpowiednimi opcjami, w zależności od potrzeb. Polecenie ./configure --help wyświetla pełną listę poleceń. 

./configure --iso-8859-2

Spowoduje to wygenerowanie typowej konfiguracji dla Apache, z wsparciem dla polskich literek kodowanych w ISO i pozwoli na późniejsze automatyczne uaktualnienie konfiguracji serwera WWW. LinuxStat domyślnie będzie zainstalowany w katalogu /usr/local/lstat
Następnie należy wykonać polecenia: 

make
make install

Jeżeli wszystko zakończyło się pomyślnie, to należy uruchomić usługę lstatd i przeładować serwer WWW np. dla dystrybucji Redhatopodobnych można to zrobić przez wywołanie poleceń: 

/etc/rc.d/init.d/lstatd start
/etc/rc.d/init.d/httpd restart
Dla innych dystrybucji został przygotowany plik startowy lstatd.rc znajdujący się typowo w katalogu /usr/local/lstat/bin
Aby uruchomić usługę należy go wywołać z parametrem start Ten plik można skopiować do skryptów startowych systemu. Dodatkowo należy zadbać, aby był on uruchamiany podczas startu systemu np. przez dopisanie wywołania tego skryptu do pliku rc.local

W przypadku problemów należy zajrzeć na stronę Problemy

Pierwsze uruchomienie

Statystyki można zobaczyć wpisując do swojej przeglądarki odpowiedni URL. Domyślnie jest to np. http://localhost/lstat/lstat.cgi
Adres localhost należy zastąpić adresem, na którym działa serwer WWW. Jeżeli instalacja przebiegła pomyślnie, to powinna się pokazać strona z wyborem wersji językowej. Następnie, w zależności od konfiguracji zabezpieczeń może się pokazać strona z ostrzeżeniem, że program jest zablokowany. Wtedy należy zapoznać się z konfiguracją zabezpieczeń. Bezpośrednio po instalacji statystyki są zawsze zablokowane
Jeżeli już zdecydujemy się na odpowiednią politykę dostępu do programu (lub jej brak) to pojawi się okienko z pustymi wykresami, które w miejscu wartości wyświetlają liczbę nan. Dzieje się tak, bo jeszcze program nie zdążył zebrać wystarczająco dużo informacji, aby móc ją narysować. Po kilku minutach pojawią się pierwsze zmiany. Nie polecam stosować proxy do połączeń z tym adresem. Często powoduje to brak odświeżenia wykresu.
Wszędzie tam gdzie pojawia się ikonka z znakiem zapytania warto zapoznać się z pomocą na ten temat.