Liferay Migration 6.0.6 6.1

MPDL,GAVO

General TODO

 * get LR 6.1. Beta 4 as bundle
 * migrate Postgres DB
 * modify SVN (tags or branch for 6.0.6)
 * update SDK (locally)
 * port externally developed portlets to 6.1
 * port project-ext to hooks (if possible)
 * describe details on this page (useful for migration of demo instance)

LR 6.1. Beta

 * Download R 6.1. Beta4 bundle with Tomcat from http://sourceforge.net/projects/lportal/files/Liferay%20Portal/6.1.0%20B4/
 * backup of LR and database

cd /data/liferay mkdir liferay-portal-dev-60

cp -r liferay-portal-dev liferay-portal-dev-60

cd liferay-portal-dev-60 mkdir database cd database

//backup the database (made verbose - insert backup of the database) pg_dump -f lportal_dev3.dump.sql -v -d lportal_dev3 -U postgres


 * shutdown liferay 6.0.6 portal
 * make a backup of the complete directory where LR 6.0.6 is installed


 * Setting-up LR 6.1
 * unzip LR portal bundle somewhere in local directory
 * copy the  directory under app-server directory of the existing LR 6.0.6 installation (in the same directory where tomcat running LR 6.0.6 is placed)
 * under /bin directory, edit the file named setenv.sh for JAVA_OPTS values

JAVA_OPTS="$JAVA_OPTS                     -Dfile.encoding=UTF8                      -Dorg.apache.catalina.loader.WebappClassLoader.ENABLE_CLEAR_REFERENCES=false                      -Duser.timezone=GMT+1                      -Dexternal-properties=portal-test.properties -Xmx1024m -XX:MaxPermSize=256m"

chat-portlet google-maps-portlet kaleo-web knowledge-base-portlet mail-portlet opensocial-portlet sevencogs-theme social-networking-portlet tunnel-web web-form-portlet wsrp-portlet
 * put the latest postgres jdbc driver (download link used http://jdbc.postgresql.org/download/postgresql-9.1-901.jdbc4.jar) in /lib/ext directory
 * put a file named portal-test.properties in the directory /webapps/ROOT/WEB-INF/classes/ . This file shall contain general properties of AWOB LR 6.1 instance
 * put a file named portal-ext.properties in the directory /webapps/ROOT/WEB-INF/classes/ . This file shall contain specific properties (i.e. database instance) of AWOB LR 6.1 instance
 * edit server.xml in /conf directory as needed for port configuration
 * check once again if LR 6.0.6 instance had been properly backed-up with both database data and complete LR 6.0.6 directory 
 * remove the  directory (where 6.0.6 instance portlets were installed) completely
 * go to the /webapps directory; make sure that no other portlets except following (clean installation) are installed (make sure sevencogs theme only is there, not the plug-in with sevencogs functionality)


 * just in case problematic, run the script for "preparation of migration" (TODONBU: provide link) (even if the script reports errors, make sure you run it before you start LR 6.1). This script sets up some data needed for the 6.1 beta upgrade to be successfull. As LR 6.1 beta in meantime drops some tables it asks again (there seems to be wrong order of upgrade) this script has to be run 2-3 times (as long as LR does not start gently and does not stop automatically)