Page History

...

...

Ogólne informacje

Konfiguracja podstawowa

Wszystkie pliki konfiguracyjne systemu serwera dLibra znajdują się w podkatalogu conf w głównym katalogu głównego serwera oraz jego podkatalogach. W każdym z plików istotne parametry konfiguracyjne zostały opatrzone komentarzem. Pliki znajdujące się bezpośrednio w katalogu conf dotyczą wszystkich usług serwera systemu dLibra. Pliki znajdującie się w podkatalogach tego katalogu zawierają indywidualne ustawienia poszczególnych usług. Dostępne są następujące pliki konfiguracyjne:serwera. Konfiguracja związana z poszczególnymi serwisami znajduje się w podkatalogach o dwuliterowych nazwach odpowiadających skrótowej nazwie danego serwisu. Pozostałe pliki i katalogi zawierają bardziej ogólną konfigurację serwera. Większość istotnych parametrów w plikach konfiguracyjnych jest opatrzona komentarzem. Praktycznie wszystkie zmiany w plikach konfiguracyjnych wymagają restartu Serwera dLibra, zanim odniosą skutek (zaleca się restartowanie Aplikacji Czytelnika razem z Serwerem).

Do ważniejszych plików/katalogów z ogólną konfiguracją zaliczyć można:

• server.xml - główny plik konfiguracyjny serwera. Zawiera on listę usług serwera dLibra, które mają być uruchomione, oraz wskazania na pozostałe pliki konfiguracyjne.
• database.properties - zawiera nazwę użytkownika, hasło oraz adres bazy danych wykorzystywanej przez serwer dLibra oraz parametry definiujące rodzaj wykorzystywanej bazy danych.
• default-service.properties - zawiera domyślne wspólne parametry konfiguracyjne usług serwera dLibra. Zdefiniowane w tym pliku wartości mogą być nadpisywane w plikach service.properties poszczególnych usług.
• diacritic.properties.xml - plik określający zasady transformacji znaków diakrytycznych na potrzeby indeksowania i wyszukiwania.
• ehcache.properties,*.dtd - pliki konfiguracyjne mechanizmu dostępowego do bazy danych.
• log4j.properties - plik konfigurujący mechanizm logowania przebiegu pracy serwera.
• lucene.properties - plik konfigurujący mechanizm indeksowania i wyszukiwania.
• server.xml - główny plik konfiguracyjny serwera. Zawiera on listę usług serwera dLibra, które mają być uruchomione oraz wskazania na pozostałe pliki konfiguracyjne.
• smtp.properties - plik konfigurujący mechanizm wysyłania wiadomości e-mail (wykorzystywany opcjonalnie, w zależności od konfiguracji mechanizmu logowania).
• stopwordslucene.properties - plik zawierający listę słów ignorowanych podczas z konfiguracją wspólną dla mechanizmu indeksowania i wyszukiwania.wrapper/base.conf, wrapper/java.conf, wrapper/logging.conf, wrapper/troubleshooting.conf, wrapper/windows.conf - zestaw plików konfiguracyjnych mechanizmu
• solr - katalog z konfiguracją dla narzędzia Solr, wykorzystywanego do indeksowania i wyszukiwania. Więcej informacji w rozdziale Konfiguracja wyników wyszukiwania.
• wrapper - katalog z plikami konfiguracyjnymi narzędzia Wrapper, odpowiedzialnego za uruchomienie serwera dLibra w trybie usługi. Szczegółowa dokumentacja tego pliku narzędzia znajduje się na stronie http://wrapper.tanukisoftware.org/doc/english/properties.html. Można tu m.in. ustawić maksymalne zużycie pamięci przez serwer dLibra (parametr wrapper.java.maxmemory w pliku base.conf).wrapper/java
  wrapper/base-yajsw.conf,
  • pliki z końcówką -yajsw.conf
  - pliki konfiguracyjne mechanizmu odpowiedzialnego za uruchomienie serwera dLibra w trybie usługi w przypadku 64-bitowego systemu operacyjnego.
  • ??/quartz.properties - plik konfigurujący mechanizm zadań okresowych.
  • pliki ??/jobs.xml - pliki konfigurujące zadania okresowe na poziomie poszczególnych usług serwera dLibra.
  • ??/service.properties - plik zawierający parametry konfiguracyjne specyficzne dla poszczególnych usług.
  • cs/zip_readme.txt - szablon informacji tekstowej dołączanej do archiwów z treścią publikacji.
  • ms/bibtex-export.properties, ms/dc-export.properties, ms/dcterms-export.properties, ms/etd-export.properties, ms/highwire-export.properties, ms/ris-export.properties - pliki określający zasady transformacji metadanych do różnych schematów atrybutów.
  • mx/xls - katalog zawierający pliki wykorzystywane do generowania interfejsu administracyjnego serwera.
  • se/searchConfig.properties - plik konfigurujący atrybuty wykorzystywane przy generowaniu wyników wyszukiwania.

  Konfiguracja Self-Archiving

  W serwerze w pliku /conf/ms/service.properties można ustawić dostępność kreatora publikacji dla wszystkich czytelników. Służy do tego flaga wwwPublicationAllowed, którą należy ustawić na "true". Jako, że tworzone przez kreator publikacje są lokowane w konkretnych folderach w systemie dLibra konieczne jest również wskazanie takiego folderu poprzez ID w parametrze publicDirectoryId.

  ...

  • • w nazwie są wykorzystywane w przypadku, gdy dLibra jest uruchamiana na 64-bitowej wersji systemu operacyjnego Windows.

  Każdy serwis uruchamiany w ramach serwera dLibra ma swój odrębny katalog konfiguracyjny:

  • cs - Content Server - serwer treści, odpowiada za przechowywanie plików z treścią obiektów
  • em - Event Manager - menedżer zdarzeń, kontroluje mechanizm przesyłania wiadomości o zdarzeniach pomiędzy pozostałymi serwisami
  • is - Index Server - serwer indeksujący, przetwarza nowo dodane i zmodyfikowane obiekty, aby można było je szybko przeszukiwać
  • me - Message Server - serwer wiadomości, przechowuje wiadomości przesyłane pomiędzy użytkownikami (redaktorami i użytkownikami korzystającymi z self-archiving)
  • ms - Metadata Server - serwer metadanych, odpowiada za przechowywanie informacji o kolekcjach, katalogach, obiektach, atrybutach, itp.
  • pp - Profile Provider - dostawca profili, przechowuje informacje o profilach czytelników (ustawieniach, ulubionych obiektach, itp.)
  • se - Search Server - serwer wyszukiwawczy, dostarcza wyniki wyszukiwania w odpowiedzi na zapytania użytkowników
  • ss - System Services - kontroluje dostęp pozostałych serwisów do całego systemu
  • ts - Text Server - odpowiada za konwertowanie plików z treścią obiektów do postaci tekstowej, która może być przeszukiwana
  • us - User Server - przechowuje informacje o użytkownikach (administratorach/redaktorach/czytelnikach) i uprawnieniach do obiektów
  • ws - Web Service -wbudowany serwer www, do uruchamiania Aplikacji Czytelnika (domyślnie wyłączony, tylko do celów demonstracyjnych)

  W większości wyżej wymienionych katalogów znajdują się dwa najważniejsze pliki konfiguracyjne:

  • service.properties - plik z ogólnymi właściwościami danego serwisu, często z odnośnikami do innych plików konfiguracyjnych
  • jobs.xml - plik z definicją zadań okresowych uruchamianych w ramach danego serwisu, czyli operacji wykonywanych przez serwis przy starcie lub w regularnych odstępach czasu. Pozwala np. wyłączyć wybrane zadanie (poprzez usunięcie/zakomentowanie taga <job>), lub zmianę godziny, o której ma być wykonywane (poprzez modyfikację taga <cron-expression> zgodnie z dokumentacją).

  Na kolejnych podstronach znajdują się informacje o konfiguracji różnych aspektów pracy serwera dLibra.