Below we describe the actions to be taken in order to transfer the reader application from one (computer) server to another. The servers can operate under the control of any operating systems. Also, it does not matter whether they are virtual servers or physical machines.
It is assumed that the domain name of the new server is identical with the name assigned to the old server.
Transferring the Reader Application and Data
Server configuration:
Parametr | Source server | Target server |
---|---|---|
The type of the operating system | Linux | Windows |
The location of the reader application | /dlibra/dlibra-webapp-6.0.0 | c:\dlibra\dlibra-webapp-6.0.0 |
The location of the directory with the cache | /dlibra/webappwork/cache | c:\dlibra\webappwork\cache |
The location of the directory with JCR | /dlibra/webappwork/jcr | c:\dlibra\webappwork\jcr |
The location of the directory with the JCR to be restored | /dlibra/webappwork/jcr-restore | c:\dlibra\webappwork\jcr-restore |
Lokalizacja katalogu z kopiami zapasowymi JCR | /dlibra/webappwork/jcr-backup | c:\dlibra\webappwork\jcr-backup |
Lokalizacja katalogu z plikami tymczasowymi | /dlibra/webappwork/upload/temporary | c:\dlibra\webappwork\upload\temporary |
Adres IP hosta z Aplikacją czytelnika | 150.254.100.1 | 150.254.100.2 |
Przed przystąpieniem do przeniesienia systemu dLibra należy skonfigurować serwer docelowy podobnie jak serwer źródłowy. Przede wszystkim należy zainstalować Java Runtime Environment (JRE) firmy Oracle (poprzednio Sun Microsystems) w wersji co najmniej 1.8, kontener aplikacji webowych (Apache Tomcat) oraz umożliwić połączenia na portach wymaganych przez serwer systemu dLibra.
- Wyłączyć serwer Apache Tomcat z aplikacją czytelnika na serwerze źródłowym.
- Skopiować z serwera źródłowego katalog aplikacji czytelnika systemu dLibra na serwer docelowy.
- Skopiować katalog z cache'em, JCR i kopiami zapasowymi JCR. Katalogi z plikami tymczasowymi i kopią JCR do odtworzenia nie musi być kopiowany.
- Zaktualizować pliki konfiguracyjne:
- c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\conf\cache.properties
serialization.path=c:\\dlibra\\webappwork\\cache
- c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\conf\jcr.properties
jcr.working.dir=c:\\dlibra\\webappwork\\jcr
jcr.restore.dir=c:\\dlibra\\webappwork\\jcr-restore
- c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\periodic.xml
dla zadania pl.psnc.dlibra.web.comp.periodic.JCRBackupTask
<name>jcr.backup.dir</name> <value>c:\dlibra\webappwork\jcr-backup/</value>
- c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\conf\pubcreator.properties
upload.temp.dir=c:\\dlibra\\webappwork\\upload\\temporary
Jeżeli adres IP serwera docelowego ulegnie zmianie, należy wykonać dodatkowe czynności. Jeżeli adres się nie zmienił czynności te należy pominąć.
- W bazie danych w tabeli SYS_SERVICES zaktualizować wartości w kolumnie SER_HOST dla rekordu usługi ps.
- W pliku c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\conf\services.properties zaktualizować wartość parametru
my.url
na//150.254.100.102:10051/ss
Jeżeli w Aplikacji czytelnika uruchomiona jest rozproszona platforma uwierzytelniania, należy zaktualizować jej konfigurację. W tym przypadku pomocny będzie fragment instrukcji "Migracja konfiguracji rozproszonej platformy uwierzytelniania" z rozdziału Instrukcja aktualizacji z wersji 5.8 do 6.0.
Ostatnim krokiem będzie zainstalowanie Aplikacji czytelnika w serwerze Tomcat.
Po dokonaniu wyżej opisanych czynności możemy uruchomić Aplikację czytelnika systemu dLibra na nowym serwerze.