Przygotowanie do instalacji aplikacji czytelnika systemu dLibraW rozdziale "Wymagane oprogramowanie" na stronie Instalacja serwera omówiona zostały wymagania odnośnie oprogramowania które musi być dostępne na komputerze na którym będzie instalowana aplikacja czytelnika systemu dLibra. Instalacja i konfiguracja kontenera aplikacji Apache TomcatDodatkowo należy zainstalować kontener aplikacji Apache Tomcat w wersji 7.0. Zalecamy pobieranie tego programu bezpośrednio ze stron projektu Tomcat. Instalacja w wypadku serwerów Linuxowych sprowadza się do rozpakowania ściągniętego archiwum do docelowego katalogu w którym pracował będzie Apache Tomcat. Dla użytkowników Windows twórcy Apache Tomcat stworzyli wygodny instalator.
Po zainstalowaniu serwera Apache Tomcat należy skonfigurować parametry związane z połączeniami HTTPS które będą realizowane w trakcie działania aplikacji czytelnika. Szczegółowe omówienie tego zagadanienia można znaleźć w dokumencie SSL Configuration HOW-TO. Instalacja Aplikacji CzytelnikaNa stronie Instalacja serwera w rozdziale "Zawartość dystrybucji" omówiona została zawartość pakietu instalacyjnego systemu dLibra. Przed rozpoczęciem instalacji należy się zapoznać z tym opisem. 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-webapp.properties znajdujący się w głównym katalogu pakietu dystrybucyjnego.
Uruchomienie instalatoraAby uruchomić instalator aplikacji czytelnika należy w głównym katalogu pakietu instalacyjnego wydać polecenie ant apps. Po uruchomieniu skryptu instalacyjnego, 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 Please enter target directory for this installation: Należy wprowadzić katalog do którego zostaną skopiowane pliki aplikacji czytelnika np. /user/home/dlibra. Po zakończeniu instalacji w katalogu docelowym powinien znaleźć się podkatalog dlibra-webapp-5.0.x zawierający odpowiednio skonfigurowaną aplikacje czytelnika. Aplikacja Czytelnika w kontenerze Apache TomcatAby uruchomić aplikacje czytelnika należy dodać odpowiedni plik z jej opisem do serwera aplikacji Apache Tomcat. Plik ten należy umieścić w katalogu: katalog-tomcata/conf/Catalina/localhost, plik ten może mieć dowolną nazwę, jeżeli chcemy aby aplikacja czytelnika była serwowana jako aplikacja domyślna dla zainstalowanego serwera Apache Tomcat należy plik deskryptora nazwać ROOT.xml. Poniżej przykładowy plik ROOT.xml:
Pierwsze uruchomienie Aplikacji CzytelnikaBardzo przydatnym poleceniem przy administrowaniu aplikacją czytelnika jest tail (tail posiada swój windowsowy odpowiednik WinTail). Polecenie to pozwala śledzić pliki logów Apache Tomcat, będąc w katalogu głównym Tomcata należy wpisać : tail -f logs/catalina.out. Jeżeli plik catalina.out nie istnieje możemy go samodzielnie utworzyć. Należy teraz uruchomić Apache Tomcat i śledzić postęp pierwszego uruchomienia na konsoli gdzie wydane zostało polecenie tail. Gdy inicjalizacja serwera Tomcat zostanie zakończona : "server started up in" w pasku adresowym przeglądarki wpisujemy adres zgodny z tym co wpisaliśmy w sample-webapp.properties - http://webappDomain:httpPort/webappPath. Najczęstsze problemy występujące w czasie instalacjiBłędy podczas startu Apache Tomcat 7.0Przy próbie uruchomienia Aplikacji Czytelnika może zdarzyć się aplikacja nie będzie działała poprawnie, a w logach Tomcata znajdą się komunikaty o błędach zbliżone do poniższych:
Przyczyną takiej sytuacji jest błąd w JRE, który uniemożliwia wykorzystanie technologii RMI w aplikacjach uruchamianych w Tomcacie, jeżeli jest on zainstalowany w katalogu, który zawiera spacje (np. C:\Program Files\Apache Group\Jakarta Tomcat 7.0). Niestety obecnie jedyną znanym wyjściem z tej sytuacji jest ponowna instalacja Tomcata w katalogu, którego ścieżka nie zawiera znaków spacji. Szczegółowe informacje można znaleźć pod adresem: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4273532 Nie można się zalogować do panelu administracyjnegoPróba zalogowania lub wejscia na stronę admin kończy się niepowodzeniem, przeglądarka wyświetla komunikat o odrzuceniu połączenia. W takiej sytuacji należy sprawdzić czy konfiguracja HTTPS została przeprowadzona poprawnie.
Nie mogę uruchomić aplikacji redaktora
Do poprawnego uruchomienia aplikacji redaktora konieczne jest aby oba te narzędzia były dostępne. Jeżeli któregoś z nich nie można swobodnie wywołać z linii poleceń należy program ten zainstalować/dodać do zmiennej systemowej PATH. W przypadku gdy nie mamy możliwości modyfikacji zmiennej systemowej PATH należy zmodyfikować ścieżki do tych programów w pliku dlibra-webapp/WEB-INF/web.xml.
Zmiana w web.xml wymaga restart Apache Tomcat. Gdy oba narzędzia będą już dostępne dla aplikacji czytelnika należy:
Jeżeli mimo podjętych kroków aplikacja redaktora/administratora nie chce się uruchomić należy się skontaktować z twórcami oprogramowania dLibra. Błąd podczas startu aplikacji na DebianiePodczas uruchamiania Aplikacji Czytelnika w systemie operacyjnym Debian Etch może pojawić się błąd podobny do przedstawionego poniżej:
Problem dotyczy jedynie Javy Sun 1.5 zainstalowanej z pakietów dostępnych w Debianie. Może także dotyczyć innych wersji Debiana lub systemów bazujących na Debianie np. Ubuntu. Rozwiązanie tego problemu jest wykonanie następujących poleceń (dla systemów x86):
Szczegółowe informacje i inne możliwe rozwiązania można znaleźć pod adresem: https://bugs.launchpad.net/debian/+source/sun-java5/+bug/162232. Brak statystyk biblioteki cyfrowejJeżeli statystyki biblioteki cyfrowej nie są dostępne, może być to spowodowane przez błąd opisany wcześniej: Błąd podczas startu aplikacji na Debianie. |