Instalacja programu w systemie Windows

Instalacja jest bardzo prosta i polega na uruchomieniu pliku instalacyjnego. W trakcie instalacji zostanie zainstalowana również baza danych Firebird. Jeżeli mamy zainstalowaną wersję Firebird'a starszą niż 1.5.0, należy ją uprzednio odinstalować. W trakcie instalacji nasz udział ograniczony jest do zatwierdzania kolejnych ekranów.

Instalacja programu w systemie Linux

Program posiada graficzny instalator, którego zadaniem jest maksymalne uproszczenie procesu instalacji. Po pobraniu pliku instalatora na dysk (zwykle nazywa się on lkmk-x.x.x-linux-installer.bin, gdzie x.x.x jest kolejnym numerem wersji) należy zmienić jego uprawnienia tak, aby była możliwość jego uruchomienia. Można tego dokonać na kilka sposobów:

Po nadaniu odpowiednich praw wystarczy kliknąć na pliku lub z konsoli wykonać polecenie

./lhmk-x.x.x-linux-installer.bin aby uruchomić instalator. Po uruchomieniu proces instalacji przebiega w sposób intuicyjny. Wystarczy podać katalog instalacyjny lub zostawić ścieżkę domyślną (/home/lhmkx.x/), kliknąć „Dalej”, i poczekać na rozpakowanie plików. Po tym pojawi się kreator połączenia z bazą danych. Należy kierować się instrukcjami w nim zawartymi. W większości przypadków wystarczy po prostu klikać "Dalej". Następnie otworzy się okno konsoli tekstowej z prośbą o podanie hasła root'a (które jest niezbędne do wykonania skryptu wygenerowanego przez kreatora. Jeśli podamy błędne hasło root'a możemy uruchomić kreatora ponownie za pomocą skryptu ./wizz.sh z katalogu instalacyjnego programu). Po zainstalowaniu programu w katalogu instalacyjnym pozostaje katalog FB, w którym jest wersja instalacyjna bazy danych. W razie problemów z instalacją bazy można powtórzyć proces ręcznie z konta root'a wybierając plik FB/install.sh

Prawa dostępu do plików bazy danych

Jako że właścicielem procesu serwera bazy danych jest inny użytkownik , mogą wystąpić problemy prawami dostępu do plików bazy danych. Jeśli chcemy przenosić pliki bazy danych "ręcznie" musimy pamętać, że użytkownik "firebird" musi mieć dostęp do odczytu i zapisu katalogów w których znajdują się pliki z bazą oraz do samych plików. Można zrobić to na dwa sposoby: ustawić pełne prawa dostępu do tych katalogów i plików (mało bezpieczne), lub zmienić właściciela plików i katalogów z bazą danych na użytkownika "firebird". Mniej doświadczonym użytkownikom zalecamy jednak korzystanie z kreatora.

Pamiętać należy aby przy wprowadzaniu wszelkich ścieżek wprowadzać odpowiednie separatory. W przypadku Linuksa jest to slash (/), natomiast w przypadku Windows jest to backslash (\).

Przenoszenie baz w inne miejsce

Po instalacji programu zalecamy przeniesienie bazy danych w inne odseparowane od katalogu programu miejsce i ustawienie odpowiednich praw do katalogów i ścieżek w programie. W przypadku Linuksa kreator automatycznie wybiera katalog poza miejscem instalacji. W przypadku Windows w chwili obecnej można to zrobić ręcznie. Mamy wtedy pewność, że każda kolejna wersja programu będzie korzystać z tych samych baz. Nie będzie konieczne ponowne dodawanie lub importowanie firm z poprzednich wersji programu.

Uruchomienie programu.

Po zainstalowaniu programu na pulpicie (Gnome oraz KDE) pojawi się skrót za pomocą którego możemy uruchomić program. Program można również uruchomić ręcznie wywołując skrypt lhmk.sh znajdujący się w głównym katalogu programu instalacyjnego. Jeśli po uruchomieniu nie pojawiła się plansza z logowaniem i wyborem firmy może to oznaczać jeden z następujących problemów:

  1. Baza danych została zainstalowana niepoprawnie. Należy wtedy przeinstalować bazę danych.

  2. Została ustawiona zła ścieżka dostępu do bazy danych. Należy wpisać poprawny adres IP serwera, lub nazwę hosta. W przypadku lokalnych połączeń jest to "localhost", oraz ścieżkę do pliku lh.gdb na serwerze. Jest to plik w którym znajdują się dane o firmach obsługiwanych przez system. Ustawiając ścieżkę dostępu do bazy danych należy pamiętać aby ZAWSZE wskazywała na ten plik. W przeciwnym razie program nie będzie działał poprawnie.

  3. Prawa dostępu do pliku z bazą danych są niewystarczające. Należy zmienić prawa dostępu tak aby odczyt i wykonywanie (czyli otwarcie) wszystkich kolejnych katalogów było możliwe. Ostatni katalog (zwykle katalog „/db” oraz plik „lh.gdb” powinien mieć również prawo do zapisu przez wszystkich.

Jeśli wszystkie te warunki zostaną spełnione po uruchomieniu programu powinna ukazać się plansza z logowaniem do programu.