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 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.

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

  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.
  

Content Server

ZipCache:

• CacheTimeSpan – 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 requests.

Event Manager

EventMonitoringBean:

• NoOfEveEvents – 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 event.

Metadata Server

MaintenanceTasks:

• reloadDCPatterns() – 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 file, in the conf subdirectory of the root directory of the server;
• expireAndDeleteTags() – 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) – 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

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.

ReindexTasks:

• 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.

ServiceWrapperManager:

• stop() - wyłącza serwer.
• restart() - restartuje serwer.