Building Profile2 on Sakai 2.4.x

Difficulties ahead

Building Profile2 for 2.4.x may be difficult, as it requires several updated libraries which may not be available for Sakai 2.4.x. I'll try to keep this page updated and Profile2 working in Sakai 2.4.x, but if you have problems, drop me a line.

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

In your SAKAI-SRC directory:

Get the updated SakaiPerson API for 2.4:

svn co https://source.sakaiproject.org/svn/common/branches/2.4.x sakaiperson-2.4.x

Sakai 2.4.x already has a 'common' project so make sure you check it out into a different directory, ie sakaiperson.

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/contrib/profile2/tags/1.2.1 profile2-1.2.1

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.4.x

In each of the above source directories, build via:

maven sakai

You will need to use Maven 1.0.2.

You also need some icons

You also need to get the complete FamFamFam Silk icon set, which is included with Sakai 2.5+. Download and unzip the following:
http://www.famfamfam.com/lab/icons/silk/famfamfam_silk_icons_v013.zip
into

$SAKAI-SRC/reference/library/src/webapp/image/silk/

After unpacking, if you can see the icons directly under the silk/ directory in the above path, you have done it correctly. Note that some icons are already there in 2.4.x because some projects needed them, but it is not the full set.

Then rebuild and deploy the 'reference' project in the main Sakai source.

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.