Przygotowanie do instalacji serwera systemu dLibra

Wymagane oprogramowanie

Aby zainstalować i uruchomić serwer systemu dLibra niezbędne jest następujące oprogramowanie:

• Maszyna Wirtualna Java Development Kit (JRE lub JDK) - w wersji 1.6, dostępne na stronie Sun Microsystems Inc.8, implementacja Oracle lub OpenJDK. Oprogramowanie to musi być zainstalowane na każdym komputerze, na którym ma być uruchomiony serwer systemu dLibra oraz instalator systemu. Należy pamiętać o ustawieniu zmiennej systemowej JAVA_HOME na katalog w którym zainstalowano JDKJRE, oraz dodaniu do zmiennej systemowej PATH podkatalogu bin katalogu, w którym została zainstalowano JDKJRE.
• Apache Ant - w wersji co najmniej 1.7.0, dostępne na stronie Apache. Oprogramowanie to musi być zainstalowane na komputerze, na którym uruchamiany będzie instalator systemu. Należy pamiętać o ustawieniu zmiennej systemowej ANT_HOME na katalog w którym zainstalowano Apache Ant, oraz dodaniu do zmiennej systemowej PATH podkatalogu bin katalogu, w którym został zainstalowany Apache Ant.
• Baza danych - niezbędna, aby uruchomić serwer systemu dLibra. Aktualnie wspierane są następujące typy baz danych: Oracle w wersji od 9.2.x, PostgreSQL w wersji 8 9.x, MariaDB w wersji 5.5 oraz MySQL w wersji 5.x5. W szczególnych przypadkach można zrezygnować z zewnętrznej bazy danych i wykorzystać wbudowaną w serwer dLibra bazę danych Derby - szczegółowe informacje poniżej.

...

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.

Zawartość dystrybucji

Pakiet dystrybucyjny dostępny jest na stronie projektu dLibra poprzez kanał RSS Nowe wersje Image Removed. Pobieranie plików jest możliwe po podaniu nazwy użytkownika oraz hasła, które można uzyskać kontaktując 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:

...

• sample-server.properties - szablon konfiguracji instalatora serwera systemu dLibra.
• sample-webapp.properties - szablon konfiguracji instalatora Aplikacji Czytelnika.

Parametry instalacyjne

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.

...

Proces instalacji

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.

Uruchomienie instalatora

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.

...

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.

Rozmieszczenie serwera

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.

...