Install and run your own Open Social Network (Provider) Server

(Last updated March 13, 2008. Tutorial written using Yanel revision 33411, FOAF realm version 33411 and Yulup 0.3.1-r27430)

1. Download and install Yanel

Yanel documentation for getting started.

NOTE: When running configure.sh or configure.bat, when you are asked

 [echo] #################################################################################
 [echo] # As a first time user one does NOT have to configure anything any further, but #
 [echo] # rather exit here and just run build.sh on UNIX resp. build.bat on Windows!    #
 [echo] #################################################################################
[input] Do you want to continue the configuration nevertheless? (yes/NO)

do not accept the default 'NO'. Enter 'yes'. This will create the $YANEL_SRC/conf/local directory and files you need to install the FOAF realm.

2. Download the FOAF realm

Download the FOAF realm from the Wyona subversion repository.

http://svn.wyona.com/repos/public/yanel/contributions/realms/foaf/
(Username: anonymous, Password: anonymous).

3. Add the FOAF realm and its resources to your Yanel installation

(There is more documentation about realms and resources at http://yanel.wyona.org/en/documentation/index.html)

3.1 Add the FOAF realm

Add the following lines to your $YANEL_SRC/conf/local/local.realms.xml file:

  <realm id="foaf" mount-point="/foaf/">
    <name>FOAF</name>
    <config src="$FOAF_REALM_SRC/"/>
  </realm>

Replace $FOAF_REALM_SRC with the directory which contains the downloaded FOAF realm.

3.2 Add the FOAF realm resources

Add the following resources to $YANEL_SRC/conf/local/local.resource-types.xml file:

  <resource-type src="$FOAF_REALM_SRC/src/resources/shared/" compile="true" />
  <resource-type src="$FOAF_REALM_SRC/src/resources/foaf/" compile="true" />
  <resource-type src="$FOAF_REALM_SRC/src/resources/redirect/" compile="true" />
  <resource-type src="$FOAF_REALM_SRC/src/resources/findfriend/" compile="true" />  

Replace $FOAF_REALM_SRC with the directory which contains the downloaded FOAF realm.

4. Rebuild and restart Yanel

  ./yanel.sh stop
  ./build.sh clean #(just to make sure)
  ./build.sh
  ./yanel.sh start  

5. Test the FOAF realm

Browse to http://127.0.0.1:8080/yanel/foaf/