How to migrate from Portal 2.1 to 2.2

Change the userClassNames and roleClassNames in the context files

To avoid the following error:

Class org.exoplatform.services.organization.auth.UserPrincipal not found!
Class org.exoplatform.services.organization.auth.RolePrincipal not found!

You must modify all the context files using jaas as follow:

e.g. for Tomcat: Replace in the tomcat context file cf. ${tomcat-home}/conf/Catalina/localhost/portal.xml:

  • userClassNames whose value was org.exoplatform.services.organization.auth.UserPrincipal with org.exoplatform.services.security.jaas.UserPrincipal
  • roleClassNames whose value was org.exoplatform.services.organization.auth.RolePrincipal with org.exoplatform.services.security.jaas.RolePrincipal

Change the SkinListener in the web.xml

Replace

<listener>
    <listener-class>org.exoplatform.portal.webui.skin.SkinListener</listener-class>
  </listener>
with
<listener>
    <listener-class>org.exoplatform.portal.webui.skin.SkinConfigListener</listener-class>
  </listener>

Migrate the war:/conf/jcr/repository-configuration.xml to be compatible with jcr 1.9

Click here for more details

Use a different lucene index directory for each workspace

To avoid the following error:

Caused by: java.io.IOException: Directory was previously created with a different LockFactory instance; please pass null as the lockFactory instance and use setLockFactory to change it
	at org.apache.lucene.store.FSDirectory.getDirectory(FSDirectory.java:192)
	at org.exoplatform.services.jcr.impl.core.query.lucene.PersistentIndex.<init>(PersistentIndex.java:63)
	at org.exoplatform.services.jcr.impl.core.query.lucene.MultiIndex.getOrCreateIndex(MultiIndex.java:570)
	...

Replace for each workspace e.g. for system workspace

<query-handler class="org.exoplatform.services.jcr.impl.core.query.lucene.SearchIndex">
  <properties>
	<property name="indexDir" value="../temp/jcrlucenedb/index"/>
  </properties>
 </query-handler>
with
<query-handler class="org.exoplatform.services.jcr.impl.core.query.lucene.SearchIndex">
  <properties>
	<property name="indexDir" value="../temp/jcrlucenedb/system"/>
  </properties>
 </query-handler>

Creator: Nicolas Filotto on 2008/09/02 21:12
Copyright (c) 2000-2009. Allright reserved - eXo platform SAS
1.6.13286