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 |
Poniżej opisano czynności, które należy wykonać aby przenieść Aplikację czytelnika z jednego serwera (komputera) na drugi. Serwery mogą pracować pod kontrolą dowolnych systemów operacyjnych. Nie ma także różnicy, czy są to serwery wirtualne czy fizyczne maszyny.
Przyjęto założenie, że na nazwa domenowa nowego serwera będzie identyczna z nazwą przypisaną do starego serwera.
Przenoszenie Aplikacji czytelnika i danych
Konfiguracja serwerów:
Parametr
Serwer źródłowy
Serwer docelowy
Rodzaj systemu operacyjnego
Linux
Windows
/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 |
The location of the directory with the backup copies of JCR | /dlibra/webappwork/jcr-backup | c:\dlibra\webappwork\jcr-backup |
The location of the directory with temporary files | /dlibra/webappwork/upload/temporary | c:\dlibra\webappwork\upload\temporary |
The host IP address with the reader application | 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ć Before beginning the migration of the dLibra system, the target server should be configured in a similar way to the source server. First of all, 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.– at least in version 1.8 – from the Oracle company (formerly Sun Microsystems) and a web application container (Apache Tomcat) must be installed, and connections must be enabled on the ports required by the dLibra system server.
- Disable the Apache Tomcat server with the reader application on the source server.
- Copy the reader application directory of the dLibra system server from the source server to the target server.
- Copy the directory with the cache, JCR, and JCR backup copies. The directory with temporary files and the JCR copy to be restored does not have to be copied.
- Update the configuration files
- 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
Code Block serialization.path=c:\\dlibra\\webappwork\\cache
- c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\conf\jcr.properties
Code Block jcr.working.dir=c:\\dlibra\\webappwork\\jcr
Code Block jcr.restore.dir=c:\\dlibra\\webappwork\\jcr-restore
- c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\periodic.xml
dla zadania for the pl.psnc.dlibra.web.comp.periodic.JCRBackupTask task
Code Block <name>jcr.backup.dir</name> <value>c:\dlibra\webappwork\jcr-backup/</value>
- c:\dlibra\dlibra-webapp-6.0.0\WEB-INF\conf\pubcreator.properties
Code Block 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ąć.
If the IP address of the target server is changed, additional actions must be carried out. If the address is not changed, those actions should be skipped.
- In the database of the “SYS_SERVICES” table, update the values in the “SER_HOST” column for the record of the “ps” service.
- In the “c
- 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 properties” file, update the value of the
my.url
na to//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.
...
- ” parameter.
If a distributed authentication platform is run in the reader application, its configuration should be updated. In this case, a fragment of the “Migrating the Configuration of a Distributed Authentication Platform” instruction from the Instruction for Updating from the 5.8 to 6.0 Version chapter will be useful.
The last step will be to install the reader application on the Tomcat server.
Once the actions described above have been perfrmed, we can run the reader application of the dLibra system on the new server.