Building Profile2 on Sakai 2.5.x

Building Profile2 on Sakai 2.5.x

Get the source for Profile2 (and it's dependencies)

In your SAKAI_SRC directory:

  • Get the updated SakaiPerson API for Sakai 2.5:
    svn co https://source.sakaiproject.org/svn/common/branches/2.5.x common-2.5.x
    
  • Get the TinyUrlService:
    -
    svn co https://source.sakaiproject.org/contrib/tinyurl/trunk tinyurl
    
    -
  • Get EntityBroker v1.3.6+:
    svn co https://source.sakaiproject.org/svn/entitybroker/tags/entitybroker-1.3.6/ entitybroker-1.3.6
    
  • Get Profile2:
    svn co https://source.sakaiproject.org/svn/profile2/tags/TAG profile2-TAG
    
  • For TinyUrl, EntityBroker, and Profile2 ONLY, open the base pom.xml and uncomment the appropriate version as below. DO NOT change the values in the Profile2 pom.xml, just choose the applicable one.
    ...
    <parent>
        	<artifactId>base</artifactId>
        	<groupId>org.sakaiproject</groupId>
        	<version>2.5.4</version> <!--  for any 2.5.x version -->
        	<!--<version>2.6.0-SNAPSHOT</version>--> <!--  for any 2.6.x version -->
       	<!--<version>2.7.0-SNAPSHOT</version>--> <!--  for trunk -->
        	<relativePath>../pom.xml</relativePath>
    </parent>
    ...
    
    Note: If you change the values in the Profile2 pom.xml rather than just uncomment the applicable one, you will need to change them in the SakaiPerson/Common project as well otherwise the dependencies won't match up. So don't change them!

If you are using the 1.3 series(recommended) of Profile2 with 2.5.x, then in order to get the Roster integration you should also perform the following:

Remove old dependencies

The original Profile tool in Sakai has the SakaiPerson package bundled inside it and deploys it when Sakai builds. In order to use Profile2, you must remove the old SakaiPerson jars from Tomcat/shared/lib otherwise these will be used preferentially, rather than the updated ones. Don't worry, the new one is backwards compatible with the old Profile tool, should you wish to go back.

To remove the old dependencies:

rm TOMCAT/shared/lib/sakai-common-*

Now, when you build the SakaiPerson project (below), you'll deploy the new ones and there won't be any old ones left to confuse Tomcat.

Building Profile2 for 2.5.x

  • In each of the above source directories, build via:
mvn clean install sakai:deploy

You will need to use Maven 2.0.8 or higher.

Next steps...

Go back to the main Profile2 install guide to perform any necessary DB upgrades. Also take a look at the configuration section for more information on the sakai.properties you can use to configure Profile2 in Sakai.