W celu podłączenia się do zdalnego interfejsu udostępnianego w technologii JMX trzeba zazwyczaj podać specjalnie sformatowany adres interfejsu oraz dane autoryzacyjne. W przypadku systemu dLibra adres interfejsu ma postać: In order to connet to the remote interface made available in the JMX technology, it is usually necessary to enter the address of the interface, specially formatted, and the authentication details. In the case of the dLibra system, the address has the following form: service:jmx:rmi:///jndi/rmi://[adres serwera]:[port serwera]/mx Jako dane autoryzacyjne należy podać nazwę użytkownika i hasło dla konta 'admin' zdefiniowanego w danym serwerze dLibra .

Poniższy rysunek przedstawia interfejs administracyjny systemu dLibra obsługiwany przy pomocy programu JConsole. Zakładka z widokiem ogólnym pozwala monitorować zużycie procesora i pamięci, liczbę wątków czy załadowanych klas. Szczegółowe informacje znajdują się na kolejnych zakładkach. 
Image Removed
W interfejsie administracyjnym systemu dLibra, poza standardowymi komponentami zarządzania udostępnianymi przez środowisko maszyny wirtualnej Java, dostępne są dedykowane komponenty zarządzania serwerem. Znajdują się one w ostatniej zakładce o nazwie MBeans. Komponenty te podzielone są na grupy odpowiadające strukturze wewnętrznej serwera. W ramach tych grup wyróżniony jest jeszcze podział funkcjonalny. Powstaje w ten sposób hierarchiczna, drzewiasta struktura komponentów. Zgodnie ze specyfikacją Java JMX każdy z komponentów może udostępniać własności oraz metody. Poniżej opisano najistotniejsze z udostępnianych elementów. Te elementy, które pominięto są zazwyczaj elementami przydatnymi tylko w wyjątkowych sytuacjach, wymagają bardzo głębokiej znajomości struktury wewnętrznej systemu dLibra i nie powinny być używane. W opisie zastosowano następującą notację:

The authentication data are the username and password for the ‘admin’ account defined in the dLibra server.

In the image below, the administrative interface of the dLibra system, managed with the help of the JConsole program, is shown. The tab with the general view makes it possible to monitor the usage of the server and memory, the number of threads, and the loaded classes. The details are presented in separate (following) tabs.

Image Added
Apart from the standard management components made available by the environment of the Java virtual machine, the dLibra system has dedicated components for server manament. They are in the last tab, which is called MBeans. Those components are divided into groups which correspond to the internal structure of the server. Those groups are further divided by function. The result is a hierarchical, tree-type structure of components. According to the JMX specification, each component can make properties and methods available. Below, the most important elements are described. The omitted elements are, for the most part, only useful in exceptional circumstances. They require in-depth knowledge of the internal structure of the dLibra system and should not be used. The following notation is used in the description:

• NazwaAtrybutu – the name of an attribute, the value of which can be read and (optionally) modified; and

• nazwaMetody(parametr1,parametr2) – a method (command) which can be called. Non-parameter methods are also possible.
  In general, attributes can be used for monitoring the operations of the server, and methods can be used for, for example, carrying out certain maintenance works, migrating data between version, or recovering some data lost because of a failure.

  Warning
  title Warning
  In the case of some components, it is relatively easy to make significant changes in the data stored in the digital library. Some of those operations may be very time-consuming – for example, a full re-indexation of the publications of a large digital library may take, depending on the efficiency of the server, up to a few weeks. The greatest caution is recommended when the administrative interface of the dLibra server is used

• NazwaAtrybutu - oznacza atrybut, którego wartość może być odczytywana i (opcjonalnie) modyfikowana.

• nazwaMetody(parametr1,parametr2) - oznacza metodę (polecenie), która może być wywołana. Mogą również występować metody bezparametrowe.
  Ogólnie można założyć, że atrybuty mogą być wykorzystywane do monitorowania pracy serwera, a metody do wykonywania pewnych czynności konserwacyjnych, migracji danych między wersjami lub też np. odtwarzania części danych utraconych na skutek awarii.

  Warning
  title Ostrzeżenie
  Część komponentów pozwala na stosunkowo łatwe dokonanie poważnych zmian w danych przechowywanych w bibliotece cyfrowej. Część z operacji może też być bardzo czasochłonna - przykładowo operacja pełnej reindeksacji publikacji dużej biblioteki cyfrowej w zależności o wydajności serwera może trwać nawet kilka tygodni. Zaleca się zachowanie najwyższej ostrożności przy wykorzystywaniu interfejsu administracyjnego serwera dLibra.

  
  

Content Server

ZipCache:

• CacheTimeSpan - Czas życia w cache najstarszego wydania (w godzinach).
• CurrentZipCacheSize - Aktualny rozmiar cache (w bajtach).
• CurrentZipCacheSize - Aktualny rozmiar cache w stosunku do rozmiaru maksymalnego (w procentach).
• MaxZipCacheSize - Maksymalny rozmiar cache (w bajtach).
• NoOfCachedZipFiles - Liczba plików zip w cache.
• NoOfZipCacheHits - Liczba "trafień" w cache.
• NoOfZipCacheMisses - Liczba "chybień" w cache.
• OldestAccessDate - Data dostępu do najstarszego pliku w cache.
•  – the life time in the cache of the oldest release (in hours),
• CurrentZipCacheSize – the actual cache size (in bytes),
• CurrentZipCacheSize – the actual cache size in relation to the maximum size (as a percentage),
• MaxZipCacheSize – the maximum cache size (in bytes),
• NoOfCachedZipFiles – the number of files in the ZIP format in the cache,
• NoOfZipCacheHits – the number of ‘hits’ in the cache,
• NoOfZipCacheMisses – the number of ‘misses’ in the cache,
• OldestAccessDate – the date of the access to the oldest file in the cache, and
• ZipCacheHitRatio – the ratio of the ‘hits’ in the cache to the general number of requestsZipCacheHitRatio - Stosunek liczby "trafień" w cache do ogólnej liczby żądań.

Event Manager

EventMonitoringBean:

• NoOfEveEvents- pokazuje liczbę zdarzeń, jakie zostały jeszcze do obsłużenia usługom serwera dLibra. Zdarzenia to np. dodanie nowej publikacji czy modyfikacja opisu, a obsługa ich może polegać np. na aktualizacji indeksów wyszukiwawczych. Liczba zdarzeń powinna przynajmniej raz na dobę (ewentualnie raz na tydzień) spadać do zera. Jeżeli tak nie jest, oznacza to, że serwer dLibra jest przeciążony i nie jest w stanie na bieżąco obsłużyć zadań generowanych przez użytkowników biblioteki.
• EventProcessingDelay - Opóźnienie w przetwarzaniu zdarzeń (w godzinach).
• – shows the number of events which are yet to be handled by the services of the dLibra server; an event can be adding a new publication or modifying a description, and the handling of it may consist in, for example, updating search indexes; the number of tasks should go down to zero at least once a day (or once a week); if that is not the case, it means that the dLibra server is overworked and is not capable of handling the tasks generated by library users on an ongoing basis;
• EventProcessingDelay – an event processing delay (in hours); and
• OldestEventDate – the date of the oldest unhandled eventOldestEventDate - Data najstarszego nieobsłużonego zdarzenia.

Metadata Server

MaintenanceTasks:

• reloadDCPatterns() - przeładowuje informacje na temat mapowania zestawu atrybutów zdefiniowanego w bibliotece cyfrowej na schemat DublinCore. Informacje te zawarte są w pliku  – reloads the information about mapping the attribute set defined in the digital library to the DublinCore schema; the information is in the dc-pattern.properties w podkatalogu conf katalogu głównego serwera. file, in the conf subdirectory of the root directory of the server;
• expireAndDeleteTags() - uruchamia zadanie sprawdzenia tagów użytkowników, które dezaktualizuje tagi starsze niż 30 dni oraz usuwa tagi starsze niż 60 dni. Zadania to jest również wykonywane cyklicznie przez serwer. – runs the task of user tag checking, which makes tags older than 30 days obsolete and removes tags older than 60 days; that task is also carried out cyclically by the server; and
• normalizeAttributeValues(String rdfName, Integer type) - normalizuje wartości dla zadanych atrybutów oraz dla określonego typu. Argument type przyjmuje następujące wartości: – normalizes values for the given attributes and for the particular type. The argument takes the following values:
  
  • type
    • 1 – normalization to the date form
    • 2 – normalization to the language form
    • 3 – normalization to a form of a particular type
  • type
    • 1 - normalizacja do postaci daty
    • 2 - normalizacja do postaci jezyka
    • 3 - normalizacja do postaci określonego typu

Search Server

IndexBackupTasks:

• backupIndex(mode) - powoduje utworzenie kopii zapasowej indeksu w zależności od podanych wartości paramterów. Mogą one przyjmować wartości:
  • mode:
    • 0 - nie tworzy kopii zapasowej żadnego z indeksów,
    • 1 - tworzy kopię zapasową indeksu głównego,
    • 2 - tworzy kopię zapasową indeksu synonimów,
    • 3 - 1 i 2,
• restoreIndex(mode) - usuwa bieżące indeksy i odtwarza je z kopii zapasowej w zależności od podanych wartości parametrów. Parametry mają identyczne znaczenie jak przy funkcji backupIndex.
• synchronizeIndices(mode) - synchronizuje bieżące indeksy wyszukiwawcze z indeksami wykorzystywanymi przez Index Server w zależności od podanych wartości parametrów. Parametry mają identyczne znaczenie jak przy funkcji backupIndex.

Index Server

IndexBackupTasks:

• backupIndex(mode) - powoduje utworzenie kopii zapasowej indeksu w zależności od podanego parametru. Może on przyjmować wartości:
  • mode:
    • 0 - nie tworzy kopii zapasowej żadnego z indeksów,
    • 1 - tworzy kopię zapasową indeksu głównego,
    • 2 - tworzy kopię zapasową indeksu synonimow,
    • 3 - 1 i 2,
• restoreIndex(mode) - usuwa bieżące indeksy i odtwarza je z kopii zapasowej w zależności od podanych wartości parametrów. Parametry mają identyczne znaczenie jak przy funkcji backupIndex.

...

• reindexAll(indexMode) - powoduje reindeksację całej zawartości biblioteki cyfrowej.
  • indexMode:
    • 0 - nie przeprowadza reindeksacji,
    • 1 - reindeksuje wydania (metadane i zasoby),
    • 2 - reindeksuje publikacje (planowane, grupowe, metadane),
    • 4 - indeksuje synonimy,
    • 7 - 1, 2 i 4
• checkIndexesConsistency(indexMode, fix) - sprawdza i naprawia spójność indeksów wyszukiwawczych. Parametry: 
  • indexMode działa tak samo jak w przypadku reindexAll.
  • fix:
    • true - naprawia niespójności,
    • false - pozostawia niespójności nienaprawione.
• reindexEditions(editionsIds) - powoduje reindeksację wydań o podanych identyfikatorach. Wartość parametru editionsIds powinna wskazywać identyfikatory wydań do reindeksacji oddzielone od siebie przecinkami.

dLibra JMX Management Service

RMIConnectionsInfo:

• NoOfRMIThreads - liczba zewnętrznych połączeń do serwera dLibra.
• RMIConnectionIPs - adresy IP komputerów, z których obecnie nawiązane są połączenia do serwera dLibra.

...