Page History

Can the dLibra system be installed on a virtual server?

There are no technical contraindications to running the dLibra system on a virtual machine. Still, it should be remembered that if the dLibra system is a great burden on the server (there are many new publications or there is heavy user traffic), it may be necessary to have a separate, dedicated physical machine.

So far, there has only been one case when a large digital library had to give up virtualization. When the dLibra system was moved to the host system, everything started going much more smoothly. In the case of a small digital library, though, and a strong machine, virtualization can be a good idea for utilizing the power of the server.

Heretofore, the dLibra system has been installed on virtual servers created on the basis of the VMWare software and on the s390x/zLinux platform of the IBM company.

Does the dLibra system do backups itself? Which files/folders should be protected?

The dLibra system does not have any built-in complex mechanisms for creating backup copies. Any backup actions should be carried out by the person who administers the server of the digital library.

The dLibra system stores data in two places: the relational database and the file system. As regards the database, most contemporary database systems enables easy content backup creation. For details about that operation, see the documentation of the database system.

Protecting the file system is a separate issue. Let us assume the following structure of an installation of the dLibra system:

• dlibra-webapp – the directory with the reader application,
• dlibra-server - katalog z serwerem dLibryserver – the directory with the dLibra server,
• webapp-work - katalog roboczy aplikacji czytelnika– the working directory of the reader application,
  
  • cache – the path to that directory is determined in the “dlibra-
  • cache - ścieżka do tego katalogu określona jest w pliku dlibra-webapp/WEB-INF/conf/cache.propertiesproperties” file,
  • jcr - ścieżka do tego katalogu określona jest w pliku dlibra-– the path to that directory is determined in the “dlibra-webapp/WEB-INF/conf/jcr.propertiesproperties” file,
  • ..
• content - katalog z plikami i indeksami wyszukiwawczymi
  – the directory with search files and indexes,
  
  • files – the path to directory is determined in the “dlibrafiles - ścieżka do tego katalogu określona jest w pliku dlibra-server/conf/cs/service.properties w zmiennej contentDirectoryproperties” file, in the “contentDirectory” variable,
  • index/main - ścieżka do tego katalogu określona jest w pliku dlibra- – the path to that directory is determined in the “dlibra-server/conf/solr/main/core.properties w zmiennej dataDirproperties” file, in the “dataDir” variable, and
  • index/synonym - ścieżka do tego katalogu określona jest w pliku dlibra-– the path to that directory is determined in the “dlibra-server/conf/solr/synonym/core.properties w zmiennej dataDir
    

Dane, które dLibra składuje poza bazą danych znajdują się w katalogach content/files i content/index. Katalog content zawiera wszystkie publikacje i ich pliki, katalog ten należy backupować we własnym zakresie - przed wykonaniem należy się upewnić, że nikt akurat nie dodaje nowych dokumentów do repozytorium.

• • properties” file, in the “dataDir” variable.
    

The data stored by the dLibra system outside of the database are located in the “content/files” and “content/index” directories. The “content/files” directory contains all publications and their files. Backup copies of it should be created by the user. Before making a backup copy, the user should make sure that no one is adding a documents to the repository at the given moment.

The “content/index” directory contains search indexes. If the indexes are lost, users will not be able to search the resources of the digital library. When creating a backup copy of them, the user should make sure that the server is not modifying the index files. Since it is a difficult task,  Kopia zapasowa jest tworzona domyślnie w katalogu index_backup w każdą niedzielę.

Istnieje również możliwość odtworzenia indeksów jednak indeksacja wszystkich zasobów wiąże się (w zależności od mocy maszyny i ilości oraz formatu plików publikacji) z długotrwałym obciążeniem serwera.

Oprócz wspomnianych powyżej katalogów należy również wykonać kopię katalogu webapp-work/jcr przechowywane są w nim ustawienia i treści wykorzystywane przez aplikację czytelnika.

How fast should the attribute values which have not been used in any description be removed?

Należy skorzystać z narzędzia do czyszczenia słownika atrybutów

Co zrobić, gdy kodowanie znaków w MySQL ustawione jest na UTF-8 a mimo to polskie znaki nie są wyświetlane poprawnie?

Sytuacja taka występuje rzadko. Problem dotyczy zarówno pierwszego uruchomienia po instalacji dLibry, podczas którego inicjowana jest baza danych jak i dalszego użytkowania dLibry. Rozwiązaniem jest dopisanie na końcu URL-a wykorzystywanego do połączenia z bazą danych poniższego parametru:

?characterEncoding=UTF-8

W przypadku serwera dLibry należy to zrobić w pliku database.properties znajdującym się w katalogu conf. W przypadku instalatora zmiany należy wprowadzić do pliku install-sql/mysql/mysql-db.properties.