Page History

...

General information

Wszystkie pliki konfiguracyjne serwera dLibra znajdują się w podkatalogu conf w głównym katalogu 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:

All configuration files of the dLibra server are located in the “conf” subdirectory in the main server directory. The configuration for particular services is located in subdirectories with two-letter names which correspond to the abbreviated names of those services. The remaining files and catalogs contain more general server configuration. Most of the significant parameters in the configuration files have comments. Virtually all changes in the configuration files require a restart of the dLibra server before they become effective (it is recommended that the Reader Application be restarted together with the server).

The most important files/directories with the general configuration are:

• server.xml – the main configuration file of the server; it contains a list of the services of the dLibra server which are to be run and references to the remaining configuration files;
• database.properties – it contains the username, password, and database address used by the dLibra server, as well as the parameters which define the type of the used database;
• log4j.properties – the configuration file for the mechanism of server operation logging;
• smtp.properties – the configuration file for the mechanism of e-mail message sending (used optionally, depending on the configuration of the logging mechanism);
• lucene.properties – the configuration file for both the indexing and searching mechanisms;
• solr – the directory with the configuration for the “Solr” tool (which is used for indexing and searching); for more information about it, see Configuring Search Results; and
• wrapper – the directory with the configuration files for the “Wrapper” tool which is responsible for starting up the dLibra server in the service mode; the tool is documented in detail on the
• 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.
• log4j.properties - plik konfigurujący mechanizm logowania przebiegu pracy serwera.
• smtp.properties - plik konfigurujący mechanizm wysyłania wiadomości e-mail (wykorzystywany opcjonalnie, w zależności od konfiguracji mechanizmu logowania).
• lucene.properties - plik z konfiguracją wspólną dla mechanizmu indeksowania i wyszukiwania.
• solr - katalog z konfiguracją dla narzędzia Solr, wykorzystywanego do indeksowania i wyszukiwania. Więcej informacji w rozdziale [EN] 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 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 web page; one of the things which can be set here is the maximum use of memory by the dLibra server (the “wrapper.java.maxmemory w pliku ” parameter of the “base.conf” file).;
•  files with names ending with pliki z końcówką -yajsw.conf 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ć 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ą).

• are used when the dLibra system is run on the 64-bit version of Windows.

Every service run within the framework of the dLibra server has its own, separate configuration directory:

• cs – Content Server the content server, which is responsible for storing files with object content;
• em – Event Manager – the task manager, which controls the mechanism of sending messages about events between the remaining services;
• is – Index Server – the indexing server, which processes newly added and modified objects so that they can be searched quickly;
• me – Message Server – the message server, which stores messages sent between users (editors and users making use of self-archiving);
• ms – Metadata Server – the metadata server, which is responsible for storing information about collections, directories, objects, attributes, etc.;
• pp – Profile Provider – the profile provider, which stores information about reader profiles (settings, favorite objects, etc.);
• se – Search Server – the search server, which provides search results in response to users’ queries;
• ss – System Services – control the access of the remaining services to the whole system;
• ts – Text Server – is responsible for converting files with object content to a text format which can be searched;
• us – User Server – stores information about users (administrators/editors/readers) and permissions for objects; and
• ws – Web Service – the in-built web server for running the Reader Application (by default, it is switched off; only for demonstration purposes).

In most of the directories mentioned above, there are two most important configuration files:

• service.properties – a file with the general properties of the given service, often with links to other configuration files;
• jobs.xml - – a file with the definition of the periodic tasks run within the framework of the given service, that is, of operations run by the service on startup or at regular intervals; it makes it possible to, for example, switch off a selected task (by removing/commenting out the <job> tag) or by changing the hour at which the task is to be carried out (by modifying the <cron-expression> tag in accordance with the documentation).

The following subpages contain information about the configuration of various aspects of the operation of the dLibra serverNa kolejnych podstronach znajdują się informacje o konfiguracji różnych aspektów pracy serwera dLibra.