...

katalog cs pozostawiamy bez zmian
katalog em pozostawiamy bez zmian
kopiujemy katalog binaries\dlibra-server\conf\me do bieżącego katalogu
w katalogu ms wykonujemy następujące czynności:
- pliki jobs.xml i quartz.properties pozostawiamy bez zmian
- plik service.properties zastępujemy plikiem binaries\dlibra-server\conf\ms\service.properties
- w pliku service.properties modyfikujemy wartości kluczy publicDirectoryId i wwwPublicationsAllowed tak, by pierwszy z nich wskazywał na identyfikator katalogu publicznego a drugi informował czy dodawanie publikacji z poziomu aplikacji czytelnika jest możliwe (więcej informacji na temat konfiguracji mechanizmu self archiving można uzyskać tutaj)
- jeśli plik dc-export.properties nie był modyfikowany zastępujemy go plikiem binaries\dlibra-server\conf\ms\dc-export.properties; w przeciwnym wypadku należy nowy plik dc-export.properties zmodyfikować w taki sposób, by uwzględniał zmiany dokonane dla wersji 4.0
- pozostałe pliki binaries\dlibra-server\conf\ms/*.properties kopiujemy do katalogu ms
katalog mx pozostawiamy bez zmian
katalog oh kasujemy
w katalogu pp nadpisujemy plik jobs.xml plikiem binaries\dlibra-server\conf\pp\jobs.xml

kopiujemy katalog binaries\dlibra-server\conf\is do bieżącego katalogu i wykonujemy poniższe czynności:

plik service.properties modyfikujemy w taki sposób, aby klucze, które pokrywają się z kluczami pliku se\service.properties miały te same wartości

dla kluczy pl.psnc.dlibra.index.VersionIndexer.indexCollections, pl.psnc.dlibra.index.AVSEditionIndexer.indexCollections, pl.psnc.dlibra.index.AVSPublicationIndexer.indexCollections, pl.psnc.dlibra.index.DCEditionIndexer.indexCollections, pl.psnc.dlibra.index.DCPublicationIndexer.indexCollections należy ustawić taką wartość jak w pliku se\service.properties dla odpowiadających im kluczy pl.psnc.dlibra.search.server.index.VersionIndexer.indexCollections, pl.psnc.dlibra.search.server.index.AVSEditionIndexer.indexCollections, pl.psnc.dlibra.search.server.index.AVSPublicationIndexer.indexCollections, pl.psnc.dlibra.search.server.index.DCEditionIndexer.indexCollections, pl.psnc.dlibra.search.server.index.DCPublicationIndexer.indexCollections

Note

title	UWAGA

Należy zwrócić uwagę na zmianę wartości domyślnych dla kluczy związanych z indeksowaniem informacji o kolekcjach. W wersji 4.0 dLibry domyślną wartością jest true natomiast w wersji 5.0 false. Oznacza to, że jeśli w poprzedniej wersji określone klucze były zakomentowane używając wartości domyślnej, w obecnej wersji należy usunąć komentarz i ustawić wartość true.

jeśli plik se\jobs.xml w wersji 4.0 był dostosowywany do potrzeb biblioteki cyfrowej podobne zmiany należy wykonać w pliku jobs.xml jednak nie jest możliwe nadpisanie tego pliku poprzednią wersją z uwagi na zmiany nazw parametrów

w katalogu se wykonujemy poniższe czynności:

kopiujemy plik binaries\dlibra-server\conf\se\searchConfig.properties do bieżącego katalogu
plik service.properties należy nadpisać plikiem binaries\dlibra-server\conf\se\service.properties

w pliku service.properties wartości kluczy związanych z indeksowaniem informacji o kolekcjach należy zmodyfikować w taki sposób, aby pokrywały się z odpowiadającymi im kluczami znajdującymi się w pliku is\service.properties

Warning

title	WAŻNE

Jeśli wartości kluczy związanych z indeksowaniem informacji o kolekcjach ustawione dla usługi wyszukującej nie będą pokrywały się z odpowiadającymi im kluczami w usłudze indeksującej może to skutkować brakiem wyników wyszukiwania lub też wyniki będą niepoprawne.

plik jobs.xml zastępujemy plikiem binaries\dlibra-server\conf\se\jobs.xml; jeśli plik jobs.xml był w wersji 4.0 modyfikowany należy naniesione wcześniej zmiany przenieść do nowego pliku jobs.xml

katalog ss pozostawiamy bez zmian
katalog us pozostawiamy bez zmian
przechodzimy do katalogu wrapper i wykonujemy następujące czynności:
- plik base.conf pozostawiamy bez zmian
- plik java.conf zastępujemy plikiem binaries\dlibra-server\conf\wrapper\java.conf
- kopiujemy pliki binaries\dlibra-server\conf\wrapper*-yajsw.conf do bieżącego katalogu, przy czym w pliku base-yajsw.conf należy ustawić parametry javy takie jak w base.conf (wiecej na temat uruchamiania serwera w środowisku 64-bitowym w dokumentacji)
- pozostałe pliki pozostawiamy bez zmian
plik log4j.properties zastępujemy plikiem binaries\dlibra-server\conf\log4j.properties; jeśli plik log4j.properties był w wersji 4.0 modyfikowany należy naniesione wcześniej zmiany przenieść do nowego pliku log4j.properties
plik lucene.properties zastępujemy plikiem binaries\dlibra-server\conf\lucene.properties; jeśli plik lucene.properties był w wersji 4.0 modyfikowany należy naniesione wcześniej zmiany przenieść do nowego pliku lucene.properties (należy zwrócić uwagę na ścieżki do katalogu z plikami indeksów wyszukiwawczych i katalogu z kopią zapasową indeksów wyszukiwawczych)

plik server.xml zastępujemy plikiem binaries\dlibra-server\conf\server.xml modyfikując jednocześnie parametry serverPort i systemServicesUrl tak, by zawierały te same wartości, które były w poprzedniej wersji; jako wartość parametru serverHost należy podać adres IP serwera lub jego nazwę domenową

Info

title	Adres IP/nazwa domenowa zawarty w parametrze _serverHost_

Adres IP/nazwa domenowa zawarty w parametrze serverHost jest wykorzystywany przez serwer do komunikacji z aplikacjami klienckimi. Tak więc powinien tam być zawarty taki adres, który będzie mógł być wykorzystany przez aplikacje klienckie znajdujące się na innych maszynach. W związku z tym nie należy używać np. adresu 127.0.0.1.

pozostałe pliki konfiguracyjne zastępujemy ich nowszymi wersjami z katalogu binaries\dlibra-server\conf, przy czym zawsze należy uwzględnić zmiany, które były wprowadzane ręcznie w plikach w wersji 4.0

...

Więcej informacji na temat licencji znajdziesz w rozdziale 02. Uruchamianie serwera systemu dLibra.

Uruchamianie serwera

Serwer systemu dLibra może działać w dwóch trybach: w trybie usługi lub w trybie wyświetlania komunikatów na konsolę. Jeśli do tej pory działał w trybie usługi a system operacyjny zainstalowany na maszynie to Windows należy przed uruchomieniem serwera dLibry w nowej wersji wyrejestrować usługę w wersji 4.0. Można to zrobić uruchamiając serwer dLibry z parametrem remove. Następnie należy zarejestrować usługę w wersji 5.0 uruchamiając serwer z parametrem install.

...

ignored_ips.txt – nadpisać nowy plik z wersji 5.0 plikiem z wersji 4.0.
templates.properties – porównać zawartość plików z wersji 4.0 oraz 5.0 i wartości parametrów istniejących w wersji 4.0 wstawić jako wartości tych samych parametrów w wersji 5.0.
components.xml – dla linii:
Code Block
xml
xml
<!ENTITY exhibitionId "xxx"> <!ENTITY recommendedId "yyy">
wstawić w miejsce 'xxx' oraz 'yyy' odpowiadające im wartości z wersji 4.0 pliku. W przypadku braku wartości parametru recommendedId w wersji 4.0 należy wstawić tutaj wartość -1. Znaczenie tego parametru opisane zostało w końcowej części tej instrukcji, w sekcji "Na co warto zwrócić uwagę po migracji?". Poza tym dla tych parametrów komponentów, których wartości domyślne w wersji 4.0 były zmieniane w celu dostosowania interfejsu danej biblioteki cyfrowej, należy stosowne zmiany wprowadzić ponownie w wartościach tych parametrów w wersji 5.0. UWAGA: Wyjątkiem jest tutaj wartość parametru ?main.app.jar.name" komponentu JnlpComponent, dla którego powinno się pozostawić wartość z wersji 5.0.
pages.xml - Zalecane jest zachowanie pliku pochodzącego z wersji 5.0 i ewentualne ponowne wprowadzenie zmian wykonanych w wersji 4.0 np. w celu dostosowania wyglądu interfejsu Aplikacji Czytelnika. Przy wprowadzaniu zmian w pliku pages.xml w wersji 5.0 na podstawie pliku z wersji 4.0 należy mieć na uwadze następujące zmiany:
- W wersji 5.0 usunięte zostały elementy XML (oznaczone znacznikami <page>) odpowiadające stronom: doccontent, doccontent2, content-top, content-sidebar, admin-doctype-edit oraz admin-doctype-list oraz account-moderation.
- Usunięte zostały również następujące komponenty (oznaczone znacznikami <component>) występujące w definicjach stron zawartych w pliku pages.xml: DocTypesListComponent, SingleDoctypePageComponent, AddPublicTagComponent, AccountTagsComponent.
periodic.xml - W zadaniu okresowym JCRBackupTask, w pliku z wersji 5.0, upewnić się, że w parametrze ?jcr.backup.dir" podana jest ścieżka do istniejącego katalogu, który ma być wykorzystywany do składowania kopii zapasowych JCR. Więcej na temat mechanizmu kopii zapasowych JCR tutaj.
web.xml - Wszystkie nowe wpisy z wersji 5.0 powinny zostać nienaruszone. Manualne zmiany wprowadzone przez administratorów do wersji 4.0 pliku powinny być przeniesione do wersji 5.0, przy czym poza wyjątkowymi przypadkami nie powinny być edytowane inne elementy pliku web.xml, niż wartości wewnątrz znacznika <param-value> znajdującego się w znaczniku <context-param>.

...

cache.properties - w wersji 5.0 pliku zmianie uległ parametr ?class.name", pozostałe wartości mogą zostać zastąpione wartościami z wersji 4.0 pliku.
contentHandlers.properties – w pliku w wersji 5.0 uległa zmianie wartość ?class.name", dodany został parametr ?mimetype.icons.path"; pozostałe parametry: ?format.handlers.conf" oraz ?show.browser.plugin.as.first" można zastąpić wartościami z wersji 4.0;
jcr.properties – dodane zostały dwa nowe parametry ?jcr.backup.restorer.class" oraz ?jcr.restore.dir", z których ten ostatni powinien wskazywać na konkretny katalog, z którego odczytywane będą pliki kopii zapasowych. Więcej na temat kopii zapasowych JCR tutaj. Parametr ?jcr.working.dir" zastąpić wartością z wersji 4.0 pliku.
users.properties – w wersji 5.0 zmianie uległa wartość atrybutu ?class.name", dla pozostałych atrybutów można przyjąć wartości z 4.0.
resource-managers.xml – należy uwzględnić fakt, iż w wersji 5.0 pliku usunięty został wpis dotyczący multipleManager. Jeśli wpis dotyczący guanxi był odkomentowany w wersji 4.0 pliku, należy to uwzględnić w wersji 5.0 pliku.

...

Wiki Markup
z pliku _\[dlibra-webapp-4.0\]/WEB-INF/templates.propeties_ przenieść do pliku _\[dlibra-webapp-5.0\]/WEB-INF/templates.properties_ wartość {{library.id}}

Wiki Markup
plik _\[dlibra-webapp-5.0\]/WEB-INF/conf/guanxi.properties_ zastąpić plikiem _\[dlibra-webapp-4.0\]/WEB-INF/conf/guanxi.properties_

Wiki Markup
pliki _keystore.jks_ i _truststore.jks_ skopiować z katalogu _\[dlibra-webapp-4.0\]/WEB-INF_ do katalogu _\[dlibra-webapp-5.0\]/WEB-INF_

Wiki Markup
pliki _guanxi_idp.jks_ i _guanxi_idp_cert.txt_ skopiować z katalogu _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_idp/keystore_ do _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_idp/keystore_

Wiki Markup
plik _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_idp/config/idp.xml_ zastąpić plikiem _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_idp/config/idp.xml_

Note

title	Aktualizacja ścieżek do plików

Wiki Markup

Jeżeli katalog aplikacji czytelnika zmienił lokalizację, zaktualizować w pliku _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_idp/config/idp.xml_ ścieżkę do pliku _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_idp/keystore/guanxi_idp.jks_

Wiki Markup
plik _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_sp_engine/keystore/samlengine.jks_ skopiować do katalogu _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/keystore_

Wiki Markup
plik _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_sp_engine/truststore/samlengine.jks_ skopiować so katalogu _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/truststore_

Wiki Markup
plik _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/guanxi-sp-engine.xml_ zastąpić plikiem _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_sp_engine/config/guanxi-sp-engine.xml_

Note

title	Aktualizacja ścieżek do plików

Wiki Markup

Jeżeli katalog aplikacji czytelnika zmienił lokalizację, należy zaktualizować w pliku _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/guanxi-sp-engine.xml_ ścieżki do plików 
_\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/keystore/samlengine.jks_, _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/truststore/samlengine.jks_, _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/wayf.xml_, _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/guard_template.zip_ i katalogów  _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/metadata/guards_,  _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/metadata/idp_

Wiki Markup
zawartość katalogu _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/metadata_ zastąpić zawartością katalogu _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_sp_engine/config/metadata_

Note

title	Aktualizacja ścieżek do plików

Wiki Markup

Jeżeli katalog aplikacji czytelnika zmienił lokalizację, należy zaktualizować w pliku _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_engine/config/metadata/guards/\[library.id\]/\[library.id\].xml_ wartość {{gxmeta:Keystore}}, odpowiadającą ścieżce do pliku _jks_; _\[library.id\]_ oznacza nazwę katalogu identyczną z wartością {{library.id}}.

Wiki Markup
plik _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_sp_guard/keystore/guard.jks_ skopiować do katalogu _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_guard/keystore_

Wiki Markup
plik _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_sp_guard/truststore/guard.jks_ skopiować do katalogu _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_guard/truststore_

Wiki Markup
plik _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_guard/config/guanxi-sp-guard.xml_ zastąpić plikiem _\[dlibra-webapp-4.0\]/WEB-INF/guanxi_sp_guard/config/guanxi-sp-guard.xml_

Note

title	Aktualizacja ścieżek do plików

Wiki Markup

Jeżeli katalog aplikacji czytelnika zmienił lokalizację, należy zaktualizować w pliku _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_guard/config/guanxi-sp-guard.xml_ ścieżki do plików _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_guard/keystore/guard.jks_ oraz _\[dlibra-webapp-5.0\]/WEB-INF/guanxi_sp_guard/truststore/guard.jks_

Wiki Markup
upewnić się, że w pliku _\[dlibra-webapp-5.0\]/WEB-INF/periodic.xml_ odkomentowane są znajdujące się na końcu definicje zadań okresowych:

Code Block

	xml
	xml

<periodic-task logicClass="pl.psnc.dlibra.web.guanxi.engine.periodic.IdpMetadataDownloaderTask"
       executeOnStart="no">
  <description></description>
  <expression>0 0/5 * * * ?</expression>
</periodic-task>
<periodic-task logicClass="pl.psnc.dlibra.web.guanxi.engine.periodic.MetadataLoaderTask"
       executeOnStart="no">
  <description></description>
  <expression>15 0/5 * * * ?</expression>
</periodic-task>
<periodic-task logicClass="pl.psnc.dlibra.web.guanxi.idp.periodic.IdPConfigurationReloadingTask"
       executeOnStart="no">
  <description></description>
  <expression>30 0/5 * * * ?</expression>
</periodic-task>
<periodic-task logicClass="pl.psnc.dlibra.web.guanxi.idp.periodic.SPListDownloadingTask"
       executeOnStart="no">
  <description></description>
  <expression>45 0/5 * * * ?</expression>
</periodic-task>
<periodic-task logicClass="pl.psnc.dlibra.web.guanxi.sec.TruststoreDownloadingTask"
       executeOnStart="no">
  <description></description>
  <expression>60 0/5 * * * ?</expression>
</periodic-task>
<periodic-task logicClass="pl.psnc.dlibra.web.guanxi.idp.register.IdentityConfigurator"
       executeOnStart="no">
  <description></description>
  <expression>0 0 0 29 2 ?</expression>
</periodic-task>

Wiki Markup
upewnić się, że w pliku _\[dlibra-webapp-5.0\]/WEB-INF/conf/resources-managers.xml_ odkomentowana jest sekcja znajdującą się na końcu pliku o identyfikatorze: {{guanxi}}.

Code Block

	xml
	xml

<pl.psnc.dlibra.web.fw.resources.ResourceInfo>
  <id>guanxi</id>
  <depends>dlibra</depends>
  <data>guanxi.properties</data>
</pl.psnc.dlibra.web.fw.resources.ResourceInfo>

Wiki Markup
upewnić się, żw w pliku _\[dlibra-webapp-5.0\]/WEB-INF/conf/user-providers.xml_ odkomentowana jest sekcja:

Code Block

	xml
	xml

  <pl.psnc.dlibra.web.guanxi.resources.GxUserInformationProvider>
    <loginPage>${homepage}gx?url=${homepage}&amp;action=RewritePodAction</loginPage>
    <logoutPage>${homepage}gxlogout?action=GuardLogoutAction</logoutPage>
    <loginPagePosition>3</loginPagePosition>
    <methodNameResourceKey>uip.gx.name</methodNameResourceKey>
  </pl.psnc.dlibra.web.guanxi.resources.GxUserInformationProvider>

Wiki Markup
upewnić się, że w pliku _\[dlibra-webapp-5.0\]/WEB-INF/web.xml_ należy odkomentowany jest na końcu pliku następujący fragment:

Code Block

	xml
	xml

   &guanxi_idp;
   &protectedapp;
   &samlengine;

 <servlet>
   <servlet-name>tasksServlet</servlet-name>
   <servlet-class>
      pl.psnc.dlibra.web.guanxi.resources.StartupTasksServlet
   </servlet-class>
   <load-on-startup>11</load-on-startup>
 </servlet>

...

Nowa wersja biblioteki pozwala łatwo zmienić domyślną konfigurację aplikacji redaktora. Do tej pory, każdy redaktor musiał samodzielnie wskazać plik konfiguracyjny, na dysku lokalnym komputera lub w Internecie. Teraz system można skonfigurować tak, aby odpowiednia konfiguracja była pobierana automatycznie przy każdym uruchomieniu aplikacji redaktora, co ułatwia zarządzanie, gdy w bibliotece pracuje wielu redaktorów. Szczegóły na temat konfiguracji znajdują się tutaj.

Widoki atrybutów

W związku z opracowaniem nowego schematu metadanych, do którego wdrożenia serdecznie zapraszamy, w aplikacji redaktora dodano mechanizm widoków atrybutów, który pozwala redaktorom na pracę z wybranymi atrybutami i ukrycie pozostałych. Mechanizm ten jest domyślnie dostosowany do proponowanego nowego schematu, dlatego w bibliotekach, które go nie będą stosowały, być może administratorzy będą chcieli lepiej dostosować widoki atrybutów do potrzeb redaktorów, ewentualnie usunąć niepotrzebne widoki. Opis, jak to zrobić, znajduje się tutaj. Wspomniana wyżej możliwość łatwej konfiguracji aplikacji u wszystkich redaktorów będzie w tym kontekście szczególnie przydatna.

...

Od wersji 5.0 serwer dLibra można uruchomić w 64-bitowym środowisku Windows. Wiecej informacji można znaleźć w dokumentacji.

Konfiguracja miniatur – inna niż domyślna

Miniatury pojawiające się w Aplikacji Czytelnika, w wersji systemu dLibra 4.0, przekazywane były przez serwer w formie niezmienionej w stosunku do tych wprowadzonych przez redaktorów. W wersji 5.0 systemu miniatury zwracane są przez serwer w postaci przeskalowanej, tak aby przy jednocześnie optymalnej jakości miniatur, zwiększyć prędkość ich przesyłania. Istnieje możliwość konfigurowania pewnych atrybutów automatycznego przetwarzania miniatury przed udostępnieniem, tj. rozdzielczości, formatu pliku, sposobu kadrowania miniatury oraz jakości kompresji. Warto na to zwrócić uwagę, gdy po migracji do wersji 5.0 jakość miniatury prezentowanej na stronie z opisem publikacji będzie niezadowalająca.
Więcej na ten temat można znaleźć w dokumentacji.

Konfiguracja podpowiedzi z opisem publikacji

Na głównej stronie w sekcjach ?Ostatnio dodane" oraz ?Najczęściej czytane" po najechaniu myszką na wybrany tytuł publikacji pojawia się podpowiedź przedstawiająca dodatkowe metadane publikacji. Administratorzy mają możliwość skonfigurowania przedstawianych w ramce elementów opisu. Więcej na ten tematu w sekcji dokumentacji.

Integracja z serwisem społecznościowym Facebook

W najnowszej dLibrze zostały dodany komponent, który umożliwia rejestrowanie fanów danej instytucji czy biblioteki cyfrowej. Więcej na ten temat można znaleźć w dokumentacji.

Komponent - Polecane

Niejednokrotnie w zbiorach naszej biblioteki cyfrowej pojawiają się publikacje, których obecność chcielibyśmy wyróżnić naszym czytelnikom. Ciekawym w tym wypadku rozwiązaniem może być komponent "Polecane", który w losowy sposób, z domyślnej lub wskazanej przez administratora kolekcji, wybiera publikacje i prezentuje je w formie pokazu slajdów.
Więcej na temat konfiguracji komponentu można się dowiedzieć z sekcji dokumentacji.

Page tree

Versions Compared

Old Version 1

New Version 2

Key

Uruchamianie serwera

Widoki atrybutów

Konfiguracja miniatur – inna niż domyślna

Konfiguracja podpowiedzi z opisem publikacji

Integracja z serwisem społecznościowym Facebook

Komponent - Polecane

Page tree

Page History

Versions Compared

Old Version 1

New Version 2

Key

Uruchamianie serwera

Widoki atrybutów

Konfiguracja miniatur – inna niż domyślna

Konfiguracja podpowiedzi z opisem publikacji

Integracja z serwisem społecznościowym Facebook

Komponent - Polecane