Instalacja

1. Wstęp

Program Billans jest aplikacją webową - używa się jej za pomocą dowolnej przeglądarki internetowej. Ma to tą zaletę, że instalując program na serwerze stron WWW mamy do niego dostęp tak jak do każdego innego serwisu internetowego. Aby więc zainstalować Billans niezbędne są - serwer stron WWW z iterpreterem języka PHP (w tym języku napisana została aplikacja) oraz serwer bazy danych MySQL, na którym przechowywane będą wprowadzane dane.

Wszystkie te funkcje może spełniać nasz domowy komputer niezależnie czy jest na nim zainstalowany system Windows czy Linux.

Jeżeli Posiadasz już stronę WWW na serwerze to prawdopodobnie na nim bez problemu zainstalujesz program. Dowiedz się tylko u swojego dostawcy czy serwer obsługuje język PHP i bazę danych MySQL.

Opis instalacji przygotowany został dla osób słabo zaawansowanych w tematykę serwerów WWW, niektórym może wydać się śmiesznie prosty, a te osoby, które mimo wszystko będą miały kłopot - odsyłam do nieograniczonych wręcz zasobów internetu - proponuję zacząć jak zwykle od Google.

2. Przygotowanie serwera

Jak już wspomniano powyżej aplikacja Billans potrzebuje odpowiedniego serwera stron WWW. Jeżeli mamy już stronę WWW na serwerze, który udostępnia niezbędne nam usługi to już połowa sukcesu. Możemy przejść od razu do punktu 4.

Jeżeli nie mamy serwera to istnieją dwie możliwości - instalować program na serwerze zewnętrznym lub na naszym komputerze domowym. Jeżeli wybieramy pierwszą ewentualność to należy zgłosić się do wybranego prowidera usług internetowych i zarządać wymienionych w punkcie 1 możliwości serwera - usługa taka nie jest droga a przy okazji możesz założyć własną stronę WWW. Przykładowo na naszym serwerze miesięczny koszt utrzymania takiego konta to 29,99 zł netto. Na rynku dostępni sš usługodawcy, którzy oferują darmowe utrzymanie wirtualnych serwerów WWW z obsługą PHP i MySQL - warto ich wybrać jeżeli zamierasz traktować to obecnie jako naukę lub zabawę. Z pewnością znajdziesz ich w Google.

W przypadku gdy chcesz instalować program na własnym komputerze z systemem Windows (zakładam, że jeżeli posiadasz Linuksa, sam go zainstalowałeś i skonfigurowałeś to możesz przejść do punktu 4).

3. Instalacja serwera Apache na systemie Windows

Instalacja serwera w systemie Windows jest niezwykle prosta i w zasadzie sprowadza się do uruchomienia programu instalacyjnego PHPTriad dostępnego w dziale DOWNLOAD.

Program jest uniwersalny - działa zarówno pod Windows 98 jak i Windows 2000 oraz XP.

Po jego uruchomieniu zawartość plików serwera zostanie "wrzucona" do domyślnego katalogu c:\apache

Teraz możesz już uruchomić swój serwer

c\apache\apache.exe

oraz serwer MySQL c:\apache\mysql\bin\winmysqladmin.exe

Przy pierwszym uruchomieniu serwera MySQL zostaniesz zapytany o login i hasło użytkownika bazy. Jeżeli nie masz doświadczenia w zarządzaniu bazą, to proponuję wcisnąć anuluj a naszym loginem zostanie: root natomiast hasło będzie puste. Przy następnym starcie komputera usługi te powinny uruchomić się automatycznie, jeżeli nie - dodaj ich skróty do folderu "AUTOSTART" dostępnego z menu "START/PROGRAMY".

Jak zapewne zauważysz - w trakcie działania serwera Apache - wyświetla się okienko dosowe. Nie zamykaj go a jedynie zminimalizuj.

W tej chwili jesteś już posiadaczem własnego serwera stron WWW z obsługa PHP i MySQL. Kiedy tylko nabierzesz więcej doświadczenia - postaraj się uaktualnić wersje PHP, Apache i MySQL do najnowszych.

Jeżeli teraz uruchomisz przeglądarkę internetową i w adres wpiszesz: http://localhost powinieneś uzyskać ekran powitalny.

Teraz ważna uwaga:
Pliki Twoich stron internetowych znajdować się będą w katalogu c:\apache\htdocs. Jednak nie wpisuj tego adresu do przeglądarki bo w przypadku tych stron, używających języka PHP - nie będą funkcjonowały poprawnie. Tworząc podkatalogi w katalogu c:\apache\htdocs na przykład "test" (czyli: c:\apache\htdocs\test) uzyskujesz do niego dostęp wpisując do przeglądarki http://localhost/test/
Zaglądając do wspomnianego katalogu zauważysz zapewne, że jest już tam podkatalog o nazwie PHPMyAdmin - wpisz w przeglądarkę http://localhost/PHPMyAdmin - jest to bardzo praktyczne narządzie do administrowania Twoją bazą MySQl, możesz tam tworzyć i edytować bazy, tabele oraz dodawać treści do tabel.

Nie jest to kurs obsługi serwera WWW ani MySQL (radzę jednak znaleŸć coś takiego w internecie i poczytać), więc przejdźmy do następnego punktu instalacji.

4. Przygotowanie bazy danych MySQL

Program Billans korzysta z bazy danych MySQL - jeżeli Ty jesteś administratorem serwera - utwórz bazę dla programu, jeżeli zaś nie, to zdobądź od Twojego dostawcy tych usług niezbędne dane bazy:

adres serwera bazy MySQL	(w przypadku wyżej opisanej instalacji serwera w systemie Windows będzie to localhost)
nawę użytkownika bazy danych	(w przypadku wyżej opisanej instalacji serwera w systemie Windows będzie to root)
hasło użytkownika bazy danych	(w przypadku opisanej instalacji serwera w systemie Windows będzie puste)
nazwę bazy danych	(w przypadku opisanej instalacji serwera w systemie Windows jest już przykładowa baza o nazwie test - możesz też utworzyć nową bazę korzystając z opisanego narzędzia PHPMyAdmin)

5. Przygotowanie katalogu programu

Po pobraniu najnowszej wersji programu należy ją rozpakować do dowolnego katalogu a następnie skopiować do miejsca docelowego. Jeżeli posiadasz wykupione miejsce na serwerze WWW - musisz posłużyć się do tego klientem FTP (np. TotalCommander) - jak to zrobić z pewnością dowiesz się u swojego dostawcy usług serwerowych.

Jeżeli program działa na serwerze zainstalowanym w Twoim systemie Windows, skopiuj wszystkie pliki do katalogu:

c:\apache\htdocs

wówczas dostęp do programu będzie w postaci:

http://localhost

lub do podkatalogu we wspomnianej lokalizacji np:

c:\apache\htdosc\billans

wówczas dostęp do programu będzie w postaci:

http://localhost/billans

Teraz ważna uwaga dotycząca tylko użytkowników systemu Linux:
Po skopiowaniu plików do ich docelowej lokalizacji należy nadać prawa do odczytu i zapisu dla wszystkich użytkowników dla katalogu:

lib/

znajdującego się w katalogu głównym programu.

6. Pierwsze uruchomienie

Możemy teraz wywołać juz nasz program. Będzie to po prostu wpisanie w przeglądarkę internetową adresu naszego serwera (np. http://localhost lub dodatkowo z podkatalogiem jeżeli w nim umieściliśmy nasze pliki). Należy teraz przejść do instalacji programu a w nim wprowadzać wszystkie niezbędne dane które juz zgromadziliśmy. Na koniec podajemy hasło i login które zapewnią nam bezpieczeństwo gromadzonych w programie danych (w przyszłości po zalogowaniu do programu będzie można utworzyć więcej użytkowników mających dostęp do programu).

Po prawidłowym przebiegu instalacji i po ponownym wejściu do programu powinno ukazać się okno logowania. Możemy juz wejśc do programu podając login i hasło administrator które wybraliśmy w czasie instalacji.

7. Jeżeli program działa prawidłowo...

Jeżeli program działa prawidłowo, możesz zalogować się do programu i nie ukazują się żadne komunikaty o błędach, oznacza to, że program został zainstalowany poprawnie. Warto usunąć teraz katalog "install", gdyż pozostawiajšc go, dajemy możliwość skasowania wszystkich znajdujących się tam danych przez niepowołane osoby.

8. Jeżeli program nie działa prawidłowo...

Jeżeli program działa nieprawidłowo... no cóż... Jeżeli to Twój pierwszy kontakt z serwerem WWW - poczytaj trochę w internecie na ten temat, potem zainstaluj program ponownie, następnie znowu poczytaj w internecie itd... aż uruchomisz program.
No chyba że natrafisz na dziurę lub błąd w programie i będziesz o tym przekonany - w tedy skontaktuj się z nami i wspólnie naprawimy błąd.