Escidoc-core Migration v1.1 to v1.2
Jump to navigation
Jump to search
step-by-step instructioncs to migrate escidoc-core 1.1 to escidoc-core 1.2. (detailed information is related to the MPDL productive environment).
Affected servers[edit]
- srv01.mpdl.mpg.de (PortgreSQL and Fedora)
- coreservice.mpdl.mpg.de (srv02.mpdl.mpg.de) (escidoc-core)
- pubman.mpdl.mpg.de (PubMan)
- faces.mpdl.mpg.de (Faces)
- virr.mpdl.mpg.de (Virr)
- any other instance accessing coreservice.mpdl.mpg.de
Required software packages[edit]
- fcrepo-installer-3.3-fix01.jar
- escidoc-core-admin-1.2
- escidoc-core-bin-1.2
- jboss-patch-1.2
all available at https://www.escidoc.org/JSPWiki/en/DownloadForRelease1.2
- foxml_migration-jar-with-dependencies.jar
- plus xsl folder containing xslt styesheets
- plus migration.properties file
available at https://zim02.gwdg.de/repos/common/trunk/common_services/foxml_migration
Pre-Migration requirements[edit]
- shutdown all solutions accessing coreservice.mpdl.mpg.de
- stop JBoss application server on
- pubamn.mpdl.mpg.de
- faces.mpdl.mpg.de
- virr.mpdl.mpg.de
- stop JBoss application server on any other instance, which is accessing coreservice.mpdl.mpg.de
- stop JBoss application server on
- shutdown the escidoc-core instance
- stop JBoss application server on coreservice.mpdl.mpg.de
- shutdown Fedora instance
- /X/fedora/tomcat/bin/shutdown.sh on srv01.mpdl.mpg.de
Main migration steps[edit]
Installation of Fedora 3.3.1[edit]
- on srv01.mpdl.mpg.de change to directory /X
- delete the symbolic link fedora
- DO NOT DELETE THE EXISTING FEDORA INSTANCE INSIDE /X/fedora3.2.1 !!!
- create a new directory fedora3.3
- create a new symbolic link fedora pointing to the new directory fedora3.3
- drop old fedora databases "fedora32" and "riTriples"
- CREATE DATABASE "fedora3" WITH ENCODING='UTF8' OWNER="fedoraAdmin";
- CREATE DATABASE "riTriples" WITH ENCODING='SQL_ASCII' OWNER="fedoraAdmin" TEMPLATE=template0;
- install Fedora 3.3.1
- java -jar fcrepo-installer-3.3-fix01.jar
- instructions can be found here: https://www.escidoc.org/JSPWiki/en/Fedora3.3Installation
- when the installation is finished
- copy the entire data directory located in the old Fedora instance (/X/fedora3.2.1/data) into the newly installed Fedora instance
Migrtation of the FOXML files[edit]
this will backup the Fedora data diectory!
- go to escidoc-core-admin-1.2
- edit the admin-tool.properties file
- check Fedora properties
- especially fedora-src.home=/X/fedora
- ANT_OPTS=-Xmx1024m -Xms512m -XX:MaxPermSize=256m
- call ant foxml-migration-from1.1-to1.2
Migrating old escidoc:TOC content model[edit]
- locate the escidoc_TOC file inside /X/fedora/data/objects and open it for editing
- replace all occurances of "TOC" with "toc"
- check the creation date of the RELS-EXT.0 and the RELS-EXT.1 datastreams
- if both dates "CREATED=<date>" are equal, decrease the one in RELS-EXT.0
- update all references to escidoc:TOC in any resource
- the current migration.properties file has a list of all relevant resources
- java -jar foxml_migration-jar-with-dependencies.jar cmodel
Rebuild Fedora[edit]
- rebuild the Fedora database and the Fedora resource index