Versions Compared

Key

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

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

Lokalizacja aplikacji Czytelnika

/dlibra/dlibra-webapp-6.0.0

c:\dlibra\dlibra-webapp-6.0.0

Lokalizacja katalogu z cache'em

The location of the directory with the cache

/dlibra/webappwork/cache

c:\dlibra\webappwork\cache

Lokalizacja katalogu z

The location of the directory with JCR

/dlibra/webappwork/jcr

c:\dlibra\webappwork\jcr

Lokalizacja katalogu z kopią JCR do przywrócenia

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

The location of the directory with the backup copies of JCR

/dlibra/webappwork/jcr-backup

c:\dlibra\webappwork\jcr-backup

Lokalizacja katalogu z plikami tymczasowymi

The location of the directory with temporary files

/dlibra/webappwork/upload/temporary

c:\dlibra\webappwork\upload\temporary

Adres IP hosta z Aplikacją czytelnika

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.

  1. Disable the Apache Tomcat server with the reader application on the source server.
  2. Copy the reader application directory of the dLibra system server from the source server to the target server.
  3. 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.
  4. Update the configuration files
  5. Wyłączyć serwer Apache Tomcat z aplikacją czytelnika na serwerze źródłowym.
  6. Skopiować z serwera źródłowego katalog aplikacji czytelnika systemu dLibra na serwer docelowy.
  7. Skopiować katalog z cache'em, JCR i kopiami zapasowymi JCR. Katalogi z plikami tymczasowymi i kopią JCR do odtworzenia nie musi być kopiowany.
  8. 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.

  1. In the database of the “SYS_SERVICES” table, update the values in the “SER_HOST” column for the record of the “ps” service.
  2. In the “c
  3. W bazie danych w tabeli SYS_SERVICES zaktualizować wartości w kolumnie SER_HOST dla rekordu usługi ps.
  4. 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.

...

  1. ” 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.