Versions Compared

Key

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

...

Frequently Asked Questions

Table of Content Zone
locationtop
typelist
separatorbrackets


Info
titleZobacz także

Podobnych informacji szukaj w najczęściej zadawanych pytaniach dotyczących aplikacji czytelnika i
najczęstszych problemach związanych z instalacją aplikacji czytelnika.

Czy dLibra może zostać zainstalowana na wirtualnym serwerze?

Nie ma żadnych przeciwwskazań technicznych by dLibra chodziła na maszynie wirtualnej. Należy tylko pamiętać, że w przypadku gdy dLibra będzie bardzo obciążać serwer (duża liczba nowych publikacji, spory ruch użytkowników www) konieczne może okazać się wydzielenie dedykowanej maszyny fizycznej.

Jak dotąd miał miejsce jeden przypadek gdy jedna z dużych bibliotek cyfrowych musiała zrezygnować z wirtualizacji, po przeniesieniu dLibry do systemu gospodarza wszystko chodziło dużo lepiej. Nie mniej w przypadku małej biblioteki cyfrowej i mocnej maszyny, wirtualizacja może być dobrym pomysłem na zutylizowanie mocy serwera.

Jak dotąd dLibra była instalowana na wirtualnych serwerach tworzonych w oparciu o oprogramowanie VMWare oraz na platformie s390x/zLinux firmy IBM.

Czy dLibra sama przeprowadza backup? Które pliki/foldery powinny zostać zabezpieczone?

dLibra nie ma wbudowanych żadnych kompleksowych mechanizmów związanych z tworzeniem kopii zapasowych. Wszelkie działania w tym zakresie powinna podjąć osoba administrująca serwerem biblioteki cyfrowej.

dLibra przechowuje dane w dwóch miejscach, pierwszym z nich jest relacyjna baza danych, a drugim system plików. Jeżeli chodzi o bazę danych to większość współczesnych systemów bazodanowych pozwala na łatwe stworzenie kopii zapasowej zawartości. Szczegółów związanych z przeprowadzeniem tej operacji należy szukać w dokumentacji konkretnego systemu bazodanowego.

Odrębną kwestią jest zabezpieczenie systemu plików. Załóżmy następującą strukturę instalacji systemu dLibra:

You can look for similar information in the frequently asked questions about the reader application and the most frequent problems related to the installing of the reader application.

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 – the directory with the dLibra server,
  • webapp-work – the working directory of the reader application,
    • cache – the path to that directory is determined in the “dlibra-
  • dlibra-webapp - katalog z aplikacją czytelnika
  • dlibra-server - katalog z serwerem dLibry
  • webapp-work - katalog roboczy aplikacji czytelnika
    • 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.

Katalog content/index zawiera indeksy wyszukiwawcze. W przypadku utraty tych indeksów użytkownicy będą pozbawieni możliwości przeszukiwania zbiorów biblioteki cyfrowej. Tworząc kopie zapasową należy się upewnić, że serwer nie modyfikuje plików indeksów. Ponieważ jest to zadanie trudne w dLibre wbudowano mechanizm automatycznego tworzenia backupu indeksów. 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.

Jak szybko usunąć wartości atrybutów, które nie zostały użyte w żadnym opisie?

 

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
    • 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, a mechanism for automatic index backup creation has been built into the dLibra system. By default, the backup copies are created in the “index_backup” directory, every Sunday.

Indexes can also be recreated, however, an indexation of all resources burdens the server for a long time (depending on the power of the machine and the number and format of the publication files).

Backup copies of the “webapp-work/jcr” directory should also be made. The directory contains settings and content used by the reader application.

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


The tool for cleaning attribute dictionaries should be used.

What should be done when the character encoding in MySQL is set to UTF-8, and Polish diacritics are still not displayed correctly?


That is a rare occurrence. The problem may occur during the first start-up after the dLibra system has been installed, when the database is initiated; it can also occur later on. The solution is to add the following parameter at the end of the URL used for connecting with the database:

?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 In the case of the dLibra server, it should be done in the “database.properties” file in the “conf” directory. In the case of a change installer, it should be done in the “install-sql/mysql/mysql-db.properties” file.


Why does the new publication wizard generate an invalid thumbnail from a PDF document?

The problem occurs for documents using graphics in JPEG 2000 format. To solve it, you need to install ImageMagick version 6.8.9 or later on the Editor's computer. When ImageMagick software is available, the dLibra Editor's App automatically uses it to create thumbnails.

Installation in Windows

1. Install GhostScript https://www.ghostscript.com/download.html which is needed by ImageMagick to support PDF format
2. Install ImageMagick http://www.imagemagick.org/script/download.php#windows

Installatoin in Linux

1. sudo apt-get update
2. sudo apt-get install imagemagick