==============================================
Plik opisuje sposob instalacji klienta Mediator
na maszynie z systemem Linux. Zakładamy, że
serwer Mediator jest już zainstalowany i pracuje
w sieci.
==============================================

1. Ściągnij z sieci klienta Mediator dla xHarbour/Harbour.
Plik nazywa się medclhbpl.tar.gz i zawiera biblioteki
i programy wykonywalne klienta xHarbour i Harbour.
Plik dostępny jest na stronie www.otc.pl

Biblioteki klienta Mediator zostały przetestowane ns RedHat
Linux 7.3 (gcc 2.96) i RedHat Linux 9 (gcc 3.2.2)


2. Wybierz katalog w którym mają być zainstalowane pliki klienta
Mediator. Zalecamy katalog medcl w Twoim 'home directory'. Kolejne
kroki instalacji zakładają, że został wybrany właśnie ten katalog.


3. Skopiuj plik medclhbpl.tar.gz do wybranego katalogu, rozpakuj go
i ustaw prawa do wykonywania binariów:

$ cd
$ cp ???/medclhbpl.tar.gz .
$ tar -xzvf medclhbpl.tar.gz
$ chmod -R u+x medcl/xhb/bin
$ chmod -R u+x medcl/hb/bin
$

4. Pliki są już zainstalowane w podkatalogu medcl Twojego 'home directory'.
Klient xHarbour znajduje się w katalogu medcl/xhb, klient Harbour -
w katalogu medcl/hb

5. Następnie prosimy o uważne przeczytanie licencji znajdującej
się w katalogu medcl/doc. Jeżeli nie zgadzasz się z warunkami
licencji prosimy o bezzwłoczne usunięcie plików z komputare.
W przeciwnym przypadku możemy kontynuawać instalację.

6. Przeglądnij pliki które możesz wykorzystać do
budowy (kompilacji i linkowania) Twoich aplikacji. Są to:

medcl/xhb/bin/buildXX/xmbld.sh
medcl/xhb/bin/buildXX/xmbldmt.sh
medcl/hb/bin/buildXX/xmbld.sh

Pierwsze dwa skrypty zakładają, że xHarbour jest zainstalowany
w następujących katalogach:

/usr/bin
/usr/lib/xharbour
/usr/include/xharbour

Ostatni plik zakłada, że Harbour jest zainstalowany w:

/usr/bin
/usr/lib/harbour
/usr/include/harbour

Zazwyczaj korzysta się tylko z jednego kompilatora.
Jeżeli jednak zamierzasz korzystać z dwóch kompilatorów
równocześnie, jeden z nich powinien być zainstalowany
w innym katalogu aby uniknąć konfliktów nazw plików
umieszczanych w /usr/bin

Jeżeli wszystko przebiegło poprawnie, powinno się udać zbudować
testową aplikację (test.prg) poleceniem typu:

xmbld.sh test


7. Zanim jednak będzie można uruchomić testową aplikację
konieczne jest zdefiniowanie parametrów połączenia do serwera
Mediator. Parametry te są wykorzystywane przez aplikację do
zlokalizowania i połączenia się z serwerem Mediator w trybie
automatycznego nawiązywania połączenia. Jeżeli do aplikacji
dołączony został plik noautlog.o, wówczas procedura automatycznego
połączenia nie jest wykonywana i programista jest odpowiedzialny
za nawiązanie połączenia z serwerem Mediator przez wywołanie
w programie funkcji MedLogin()

Zakładając, że nie dołączyliśmy do aplikacji pliku noautlog.o,
procedura nawiązania połączenia spróbuje odczytać parametry
ze środowiska aplikacji. Przykładowe uruchomieni aplikacji
może wyglądać następująco:

$ export MEDNODEADDR=10.1.1.1
$ export MEDUSER=test
$ export MEDPASSWD=test
$ export MEDCS=odbc_source
$
$ ./test

Oczywiście wartości parametrów należy zmienić na dostosowane
do Twojej instalacji.

Jeżeli aplikacji nie uda się odczytać niezbędnych parametrów
ze środowiska, podjęta zostanie próba ich odczytania z pliku
medapp.ini, który powinien się znajdować w bieżącym katalogu
aplikacji. Przykładowy plik medapp.ini znajduje się w katalogu
medcl/xhb/bin/buildXX

Jeżeli wciąż brakuje informacji niezbędnych do nawiązania
połączenia, aplikacja wyświetli ekran logowania, gdzie można
wprowadzić dane niezbędne do jego nawiązania.


8. Proszę przeczytać plik hbreadmepl.txt znajdujący się w katalogu
medcl/xharbour (medcl/harbour).

9. Życzymy miłego korzystania z oprogramowania Mediator.