Aby zainstalować i uruchomić serwer systemu dLibra niezbędne jest następujące oprogramowanie:
Kodowanie UTF-8
Baza danych, która będzie wykorzystywana do działania systemu dLibra powinna być tak skonfigurowana, aby przechowywała dane w kodowaniu UTF-8 lub zgodnym.
W przypadku bazy danych MySQL konieczne może okazać się poprawienie domyślnego sposobu porównywania znaków przy kodowaniu UTF-8. Szczegółowe informacje znaleźć można w sekcji Niewłaściwe porównywanie znaków diakrytycznych w bazie MySQL.
Działanie bez zewnętrznej bazy danych
Możliwe jest działanie systemu dLibra bez zewnętrznej bazy danych. Wykorzystuje on wtedy wbudowaną bazę Apache Derby. Należy pamiętać, że rozwiązanie z zewnętrzną bazą danych zapewnia lepszą wydajność i stabilność systemu w przypadku zwiększonego obciążenia. Z tego powodu rozwiązanie z bazą wbudowaną zalecane jest tylko do mniejszych instalacji wykorzystywanych w celach demonstracyjnych czy testowych.
Link umożliwiający pobranie pakietu dystrybucyjnego oraz login i hasło będą dostępne po podpisaniu umowy. Aby je otrzymać, należy skontaktować się z pomocą techniczną zespołu dLibra (help@dlibra.psnc.pl).
Struktura katalogów dystrybucji systemu dLibra zawiera katalogi bezpośrednio związane z systemem dLibra:
Równolegle w katalogu dystrybucyjnym znajdują się pliki i katalogi instalatora systemu dLibra:
Dodatkowo w głównym katalogu pakietu instalacyjnego znajdują się następujące pliki:
Przed przystąpieniem do instalacji należy przygotować plik tekstowy zawierający parametry konfiguracji instalacji serwera systemu dLibra. Plik ten zawiera kolejne wpisy w postaci: <nazwa>=<wartosc>. Każdy wpis powinien znajdować się w osobnej linijce. Szablon tego pliku, zawierający przykładowe wartości niektórych parametrów to wspomniany wcześniej plik sample-server.properties znajdujący się w głównym katalogu pakietu dystrybucyjnego. Znaczenie poszczególnych parametrów zawiera Dodatek A. Parametry konfiguracyjne instalatora systemu dLibra.
Często popełnianym błędem jest pozostawienie na końcu wartości wpisu w pliku konfiguracyjnym instalatora nadmiarowych znaków spacji. Znaki te nie są ignorowane, tak więc jeżeli np. w pliku konfiguracyjnym serwera podane zostanie hasło administratora z nadmiarowym znakiem spacji na końcu, to przy logowaniu do systemu niezbędne będzie podanie go również z tym nadmiarowym znakiem. |
Warto zachować pliki konfiguracyjne wykorzystane w procesie instalacji. Mogą one być później wykorzystane przy migracji do nowszych wersji oprogramowania dLibra. |
Po zainstalowaniu niezbędnego oprogramowania zewnętrznych dostawców (patrz punkt Wymagane oprogramowanie), można rozpocząć proces instalacji systemu dLibra. Składa się on z opisanych poniżej dwóch kroków. Pierwszy z nich to uruchomienie instalatora w celu zebrania odpowiednich informacji i przygotowania odpowiednio skonfigurowanych pakietów oprogramowania. Drugi krok polega na odpowiednim rozmieszczeniu wygenerowanych przez instalator pakietów oprogramowania.
Instalator serwera uruchamia się poprzez uruchomienie interpretera skryptów Apache Ant w katalogu głównym pakietu instalacyjnego (polecenie ant) z parametrem server. W procesie instalacji serwera generowane jest hasło dostępowe niezbędne w procesie Aplikacji Czytelnika. Istotne jest więc, aby najpierw zainstalować serwer, a dopiero później Aplikację Czytelnika.
Interpreter automatycznie wczyta znajdujący się tam skrypt instalatora i rozpocznie wykonywanie odpowiednich operacji. Po uruchomieniu tego skryptu, niezależnie od wybranej opcji użytkownik będzie musiał odpowiedzieć na przedstawione poniżej pytania:
Please enter configuration file name:
Odpowiedzią na to pytanie powinna być nazwa pliku (wraz z pełną ścieżką), który zawiera parametry instalacyjne serwera.
Please enter target directory for this installation:
Odpowiedź na powyższe pytanie określa katalog docelowy, do którego zostanie skopiowane skonfigurowany serwer.
Po podaniu katalogu instalator rozpocznie faktyczny proces instalacji, w trakcie którego nastąpi stworzenie plików konfiguracyjnych oraz skopiowanie skonfigurowanych komponentów do katalogu docelowego.
Po zakończeniu instalacji w katalogu docelowym powinien znaleźć się podkatalog dlibra-server-5.0.x zawierający przygotowany do uruchomienia serwer dLibra.
Dodatkowo na końcu procesu instalacji serwera na ekranie wyświetlone zostanie wygenerowane w trakcie tej instalacji hasło dostępowe Aplikacji Czytelnika. Hasło to należy zapisać jako wartość parametru psPasswd w pliku konfiguracyjnym instalatora Aplikacji Czytelnika.
Po poprawnym zakończeniu działania instalatora i zainicjalizowaniu bazy danych należy przenieść skonfigurowany serwer we właściwą lokalizację. Czynność ta została poniżej krótko opisana.
W wyniku instalacji w docelowym katalogu powstaje podkatalog o nazwie dlibra-server-numer.wersji, zwany dalej katalogiem głównym serwera. numer.wersji powinien zaczynać się od "5.0." po czym powinien znajdować sie numer instalowanej wersji (np. "5.0.2"). Zawiera on przygotowany do uruchomienia serwer systemu dLibra. Serwer może być uruchomiony bezpośrednio w katalogu, w którym został umieszczony w procesie instalacji. Można też przenieść ten katalog w dowolne inne miejsce na dysku. Dopuszczalna jest zmiana nazwy katalogu z dlibra-server-numer.wersji na dowolną inną.