Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleUwaga!

Zaleca się zachowanie szczególnej ostrożności przy modyfikowaniu wszystkich opisanych poniżej plików i parametrów systemu dLibra.

...

Ogólne informacje

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.