------------------------------------------------------------------------------
                         LAN Managment System 1.0pre1
------------------------------------------------------------------------------
                         Krtki podrcznik instalacji
------------------------------------------------------------------------------

Witaj.  Zanim  zaczniesz  instalowa  LMS w swojej sieci, powi prosz kilka
minut  na  przeczytanie tego tekstu. Zminimalizuje to do minimum ble porodowe
jakie  moesz  odczuwa podczas instalacji LMS. Tak wic zaparz sobie kawy lub
signij  bo  butelk  ze swoim ulubionym napojem, usid wygodnie i rozpocznij
lektur.

0. Intro - czyli co bdzie Ci potrzebne.

Po pierwsze: serwer WWW.

Generalnie,   LMS   wymaga   PHP,  wic  jakikolwiek  serwer  WWW  obsugujcy
interpreter  PHP.  Oczywicie  preferowany to Apache 1.3.26 (czyli najnowszy),
ale na starszych nie powinno by najmniejszych problemw.

Po drugie: interpreter PHP.

Tutaj  wymagania s troch wysze. Wielce prawdopodobne jest i LMS pjdzie na
kadym  PHP  4.2.x  ktre  bdzie  miao  obsug sesji, wyrae regularnych i
mysql'a.  W praktyce nawet nie chciao mi si bawi w sprawdzanie ze starszymi
interpreterami   ni  PHP-4.2.3.  Prawdopodobnie  po  zrobieniu  kilku  maych
przerbek  LMS  pracowaby  take z PHP-4.1.x, ale wybaczcie, ja wystarczajco
duo czasu powiciem na to by LMS wogle powsta. Reszta naley do was :)

Po trzecie: serwer MySQL.

Aua. Tutaj to ja ju wogle zielony jestem. Pisaem cao korzystajc z MySQL
3.23.53 i nie mam pojcia ktra wersja jest wymagana.

I tyle by byo na temat wymaga samego LMS'a. Na koniec co do dystrybucji -
LMS zosta odpalony na:
- PLD 1.0 Ra
- Debianie 3.0 Woody
- Windowsie z najnowszym EasyPHP (tak, jestem masochista :>)
- Slackware 8.1 (2.4.20), Apache 1.3.27, PHP 4.2.3, MySQL 2.35.53

I  prawdopodobnie  pjdzie  na  czymkolwiek  (wcznie z lodwk) o ile to co
bdzie  potrafio  zgry  MySQL'a  i  serwer  WWW z PHP. Bd take wdziczny
kademu o przesanie info o konfiguracji o ile uda mu si LMS'a odpali.

1. Possijmy co.

Nie,  to  nie  porno  film. eby LMS'a chcie trzeba go mie. A e {$chcie eq
$mc}  wic  cignijmy  LMS'a. Jako e w momencie pisania tego tekstu LMS nie
zosta jeszcze ukoczony, opisz jak pobra wersj z CVS'a.

Przez WWW, korzystajc z interfejsu viewCVS mona pobra LMS'a pod adresem:

http://cvs.rulez.pl/viewcvs.cgi/lms/lms.tar.gz?tarball=1

Uywajc CVS'a, wykona z shella komend:

cvs -d :pserver:cvs@cvs.rulez.pl:/home/cvsroot get lms

Po cigniciu (i ewentualnym rozpakowaniu) naley LMS'a przenie do katalogu
docelowego, np. do /var/www/htdocs/ ewentualnie do /home/httpd/html. Czynnoci
tej  nie  bd  opisywa  gdy  jeeli  nie potrafisz wykona takiej bzdury to
wogle sobie daruj.

2. Setting UP :)

Oki, jestemy w katalogu LMS'a i teraz przydaoby si go przygotowa do pracy.
Zacznijmy  od  docignicia biblioteki Smarty i umieszczenia jej w odpowiednim
miejscu, tj w katalogu lib. Ta czynno wyglda mniej wicej tak:

cd lib
wget http://smarty.php.net/distributions/Smarty-2.3.1.tar.gz
tar -xzf Smarty-2.3.1.tar.gz
mv Smarty-2.3.1 Smarty

Pozostaje  nam  zmieni  waciciela  katalogu  templates_c  na  uytkownika z
ktrego  uruchominy  jest  serwer  www  (np.  http  albo apache). Voila. Teraz
przygotujmy  serwer  MySQL.  Wejd  do  katalogu w ktrym masz LMS'a i uruchom
shell mysql'a:

mysql -u[tutaj wpisz uytkownika z penym dostpem do bazy] -p
Enter password:[podaj haso]
mysql> create database lms;
mysql> grant usage on lms.* to lms@localhost;
mysql> grant select,insert,update,delete,create on lms.* to lms@localhost
       identified by 'haslo';
mysql> flush privileges;
mysql> use lms;
mysql> source doc/lms.mysql;

Teraz,  przydaoby  si  utworzy pierwsze konto administratora. Tak, wiem, to
jest  pokrcone i bardzo user-friendly, ale sorry, jako nie doszedem jeszcze
do napisania wizarda ktry wszystko zrobi adnie za uytkownika:

mysql> insert into admins (login, passwd) values ('login', 'haso')

Teraz   kilka   sw   wyjanie.   Login,   to  oczywicie  login  pierwszego
administratora   w   systemie,   natomiast   haso   to   haso  tego  admina
przepuszczonego przez PHP'ow funkcj crypt(). Nie jest to niestety zbyt atwe
do osignicia, ale nie pozostawiam was na lodzie :P

Metoda pierwsza (wymaga shella php) - odpalamy z shella PHP i wpisujemy:

php -q
<? echo crypt("haso")."\n"; ?>
[wciskamy na klawiaturze Ctrl+D]
$1$AUXO7o/A$.6I0VmetRlZ7NT6YUHQ7e.

Te  krzaczki,  to  wanie cryptnite haso, ktre naley wpisac do MySQL'a :)
Proste? Nie? :) No to zapraszam do drugiej metody.

Metoda druga (wymaga przegldarki internetowej):

Naley wej na stron http://twoj.serwer.pl/katalog_gdzie_masz_lms/crypt.php.

Dalej jest dosy intuicyjnie :)

Oki.  Wic  mamy  LMS'a.  Wchodzimy na WWW i si logujemy. Teraz mona porobi
porzdek,  posprzta  w  adminach,  doda uyszkodnikw i komputery do bazy i
zacz  si  rozglda  za LMSd - czyli czym co bdzie konfigurowa serwer na
podstawie danych zawartych w bazie.

I to (narazie) na tyle.

$Id: INSTALL,v 1.2 2002/12/14 15:29:06 lukasz Exp $
