Instrukcja obsługi systemu dLibra 5.0 oraz dMuseion 1.0

Skip to end of metadata
Go to start of metadata

Aby zakualizować system dLibra przy użyciu aktualizatora do wersji 5.3.0, należy w pliku konfiguracyjnym updater.properties w nowej linii dodać następujący wpis:

Zabezpieczenie istniejącej instalacji

Icon

Nowa wersja systemu dLibra posiada zmienioną strukturę bazy danych względem poprzednich wersji. Podczas procesu aktualizacji aktualizator automatycznie wykona odpowiednie skrypty zmieniające strukturę bazy danych. Przed rozpoczęciem aktualizacji należy zabezpieczyć bieżącą instalację systemu dLibra poprzez wykonanie kopii zapasowej bazy danych oraz katalogu serwera dLibry oraz aplikacji czytelnika.

Zmiany w mechanizmie gromadzenia statystyk

W wydaniu 5.3.0 zmianie uległ mechanizm gromadzenia statystyk. Pierwotnie statystyki składowane były w kontenerze JCR, dołączonym do każdej aplikacji czytelnika. W najnowszym wydaniu statystyki są gromadzone przez serwer dLibra i składowane w bazie danych. Przeniesienie statystyk do serwera dLibra powinno przekładać się na zwiększoną wydajność systemu, zwiększoną dostępność do danych (dla tych administratorów, którym zależy na generowaniu własnych raportów) oraz zmniejszone ryzyko utraty danych. 

Przy pierwszym uruchomieniu aplikacji czytelnika, po migracji do wersji 5.3, automatycznie zostanie wykonany proces migracji dotychczas zgromadzonych statystyk do serwera. Każde kolejne uruchomienie będzie już pomijało ten proces. W razie potrzeby istnieje możliwość zmiany tego ustawienia poprzez zmianę parametru "jcr.migrate.force" na "true" w pliku /WEB-INF/conf/stats.properties. Należy jednak pamiętać, iż każdorazowe uruchomienie aplikacji czytelnika z "jcr.migration.force" ustawionym na "true" będzie powodowało zwiększanie wartości dla duplikatów próbek statystyk (wartości z tą samą datą, z dokładnością do dnia, w kontenerze JCR i w bazie danych).

Statystyki w bazie danych są gromadzone w tabeli MET_STATISTICS.

Z tego względu, iż funkcja składowania statystyk z dokładnością do godziny nie była w większym stopniu wykorzystywana, zwiększała zaś zapotrzebowanie na pamięć i moc obliczeniową, w najnowszej wersji dLibry została ona usunięta (wraz z funkcjonalnością generowania wykresów godzinnych). Obecnie próbki statystyk składowane są z dokładnością do dnia. W razie potrzeby administratorzy mogą wesprzeć się korzystając z narzędzi takich jak AWStats bądź Google Analitycs.

Uwagi dotyczące procesu aktualizacji

Aktualizacja dlibra-server

  • dlibra-server/conf/server.xml - jedyną zmianą jest nowy numer wersji dla wszystkich usług - serviceVersion="5.3"

Aktualizacja dlibra-webapp

  • dlibra-webapp/WEB-INF/components.xml - do komponentów CollectionStatisticsComponent i BasicCollectionStatsComponent dodano parametr force.publication.refresh
  • dlibra-webapp/WEB-INF/conf/resource-managers.xml - dodano wpis dotyczący nowe sposobu przechowywania statystyk
  • dlibra-webapp/WEB-INF/formats/dvju_browser/message_en.xml - zaktualizowano odnośnik do pluginu djvu

Zmienione pliki

Lista najważniejszych plików które zostały zmienione.

Pliki zmienione w dlibra-server

*.xml

dlibra-server/conf/server.xml

Pliki zmienione/dodane w dlibra-webapp

*.xml

dlibra-webapp/WEB-INF/components.xml
dlibra-webapp/WEB-INF/conf/resource-managers.xml
dlibra-webapp/WEB-INF/formats/dvju_browser/message_en.xml

*.properties

dlibra-webapp/WEB-INF/conf/stats.properties

Pliki zmienione w dlibra/dlibra-webapp/WEB-INF/lib/dcore-web-components.jar

*.xml

SendPermissionRequestAction_en.xml
SendPermissionRequestAction_pl.xml

  • No labels