Page History

...

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.

Jeśli w skopiowanym pliku server.xml w paranetrze password dla poszególnych usług znajdują się wpisy typu (SS_PASSWD) (zamiast SS może być skrót dotyczący konkretnej usługi) należy podmienić je odpowiednimi wartościami z pliku server.xml z poprzedniej wersji
Info
title Hasła usług w pliku _server.xml_
Hasła wpisane w parametrach password muszą odpowiadać hasłom dla odpowiednich usług w tabeli SYS_SERVICES w bazie danych.

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

...

przejść do katalogu install-sql/dbtype/ss

z pliku dlibra-server-ss-5.0.0-dbtype-data-init.sql.template skopiować polecenie (przykład dla bazy Oracle):

Code Block

insert into SYS_SERVICES
(SER_ID, SER_TYPE, SER_DESCRIPTION,
 SER_VERSION, SER_CONNECTED, SER_PASSWORD,
 SER_HOST, SER_PORT)
values
(SYS_SERVICES_SER_ID_SEQ.NEXTVAL, 'me', 'Message server',
 '<at:var at:name="SERVER_VERSION" />@SERVER_VERSION@', 0, '<at:var at:name="ME_PASSWD" />@ME_PASSWD@',
 '<at:var at:name="SERVER_HOSTNAME" />@SERVER_HOSTNAME@', <at:var at:name="SERVER_PORT" />@SERVER_PORT@);

insert into SYS_SERVICES
(SER_ID, SER_TYPE, SER_DESCRIPTION,
 SER_VERSION, SER_CONNECTED, SER_PASSWORD,
 SER_HOST, SER_PORT)
values
(SYS_SERVICES_SER_ID_SEQ.NEXTVAL, 'is', 'Index server',
 '<at:var at:name="SERVER_VERSION" />', 0, '<at:var at:name="IS_PASSWD" />'@SERVER_VERSION@', 0, '@IS_PASSWD@',
 '<at:var at:name="SERVER_HOSTNAME" />@SERVER_HOSTNAME@', <at:var at:name="SERVER_PORT" />@SERVER_PORT@);

w poleceniu wstawiającym nową usługę zmienić:

(SERVER_VERSION) na 5.0

(ME_PASSWD) i (IS_PASSWD) na hasła podane w odpowiedniej sekcji pliku server.xml (patrz punkt Modyfikacja plików konfiguracyjnych serwera)

Info

title	Nowe hasła usług w pliku _server.xml_ i w bazie danych

Jeśli w pliku server.xml sekcje dotyczące nowych usług nie maja ustawionego parametru password należy utworzyć nowe hasła wpisując je zarówno w pliku server.xml jak i w poleceniach SQL tworzących wpisy dla tych usług.

(SERVER_HOSTNAME) na nazwę hosta, na którym będzie uruchomiona odpowiednia usługa Message Server i / lub Index Server (typowo będzie to ten sam host, na którym uruchomione są pozostałe usługi)
(SERVER_PORT) na numer portu, na którym jest uruchomiony serwer dLibry, który zawiera usługi Message Server i / lub Index Server

wykonać polecenie sql.

...

Info

title	Operacja opcjonalna

Instrunkcje opisane w tym fragmencie instrukcji należy wykonać tylko w przypadku, gdy w wersji 4.0 systemu dLibra rozproszona platforma uwierzytalniania była uruchomiona. W przeciwnym przypadku należy pominąć ten rozdział.

Wiki MarkupNa potrzeby tej instrukcji przyjmujemy, że \ [dlibra-webapp-4.0\] oznacza katalog główny aplikacji czytelnika w wersji 4.0, natomiast \ [dlibra-webapp-5.0\] - wersji 5.0.

...

z pliku _\[dlibra-webapp-4.0\]/WEB-INF/templates.propeties_ przenieść do pliku _\[dlibra-webapp-5.0\]/WEB-INF/templates.properties_ wartość {{library.id}}unmigrated-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 Markuppliki _keystore.jks_ i _truststore.jks_ skopiować z katalogu _\[dlibra-webapp-4.0\]/WEB-INF_ do katalogu _\[dlibra-webapp-5.0\]/WEB-INF_unmigrated-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_unmigrated-wiki-markup

Note

title	Aktualizacja ścieżek do plików

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_unmigrated-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_unmigrated-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_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_
Note
title Aktualizacja ścieżek do plików
Wiki Markup
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_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}}.
unmigrated-wiki-markup
Note
title Aktualizacja ścieżek do plików
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_unmigrated-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_unmigrated-wiki-markupunmigrated-wiki-markup

Note

title	Aktualizacja ścieżek do plików

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_

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

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>

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}}. unmigrated-wiki-markup
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>

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>

Wiki Markup

(jeżeli migrujemy do wersji 5.0.0) w pliku _\[dlibra-webapp-5.0\]/WEB-INF/web_guard.xml_ fragment
Code Block
xml
xml
<url-pattern>/${servletName}/gx/*</url-pattern>
zmienić na
Code Block
xml
xml
<url-pattern>/&mainServletName;/gx/*</url-pattern>

...

Page tree

Versions Compared

Old Version 10

New Version 11

Key