# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# LibreSource Installation notes
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# Copyright (C) 2004-2008 Artenum SARL / INRIA
# http://www.libresource.org - contact@artenum.com
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# Thank you for using LibreSource
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# Subversion installation
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - The LibreSource Subversion service manage dynamicaly the 
    subversion configuration files for security management. 
    Thus, in order to use this services, a subversion server must 
    be installed and configured to used this generated files.

  - Configure LibreSource for your subversion (libresourceConfig.properties / libresourceConfig.xml)
      > subversion.authz.file.path      : Specify the path to the authz file that your Subversion should use (security mapping)
      > subversion.repository.base.path : Parent directory for any subversion repository
      > subversion.create.repository.cmd: Command line for the repository creation. 
           (LibreSource will add the repository name at the end)
      > subversion.rename.repository.cmd: Command line used to rename a repository. 
           (LibreSource will add the old repository name and the new one at the end)
      > libresource.web.conf            : Specify the path of your configuration file of the Libresource web application.

  - Script and command line proposition
  
  	  > subversion.create.repository.cmd=sudo /home/libresource/tools/CreateSVNRepositoryForLS.sh /home/libresource/svn/libresource
      > subversion.rename.repository.cmd=sudo /home/libresource/tools/MoveSVNRepositoryForLS.sh /home/libresource/svn/libresource
  	
  	  > Script shell: CreateSVNRepositoryForLS.sh
        =======================================================
        #!/bin/sh  

        if [ $# -ne 2 ]; then
          echo $0 svnparentpath svnrepository
          exit 1
        fi

        svnparentpath=$1
        shift

        if [ ! -d $svnparentpath ]; then
          echo $svnparentpath is not a valid folder...
          exit 2
        fi

        if [ $1 != `basename $1` ]; then
          echo $1 ambiguous repository name ...
          exit 3
        fi

        if [ -e $svnparentpath/$1 ]; then
          echo $svnparentpath/$1 already exist...
          exit 4
        fi

        su www-data -c "mkdir $svnparentpath/$1; svnadmin create $svnparentpath/$1"

        if [ $? != 0 ]; then
          echo problem during the svncreate phase
          exit 5
        fi

        exit 0
        =======================================================  

      > Script shell: MoveSVNRepositoryForLS.sh
        =======================================================
        #!/bin/sh

        if [ $# -ne 3 ]; then
          echo $0 svnparentpath sourcesvnrepository ciblesvnrepository
          exit 1
        fi

        svnparentpath=$1
        shift

        if [ ! -d $svnparentpath ]; then
          echo $svnparentpath is not a valid folder...
          exit 2
        fi

        if [ $1 != `basename $1` ]; then
          echo $1 ambiguous repository name ...
          exit 3
        fi

        if [ $2 != `basename $2` ]; then
          echo $2 ambiguous repository name ...
          exit 4
        fi

        if [ ! -d $svnparentpath/$1 ]; then
          echo $svnparentpath/$1 is not a valid folder...
          exit 5
        fi

        if [ -e $svnparentpath/$2 ]; then
          echo $svnparentpath/$2 already exist...
          exit 6
        fi

        su www-data -c "mv $svnparentpath/$1 $svnparentpath/$2"

        if [ $? != 0 ]; then
          echo problem during the move phase
          exit 7
        fi

        exit 0
        =======================================================  

  - Libresource Web Application configuration file needed to activate Subversion (libresource-web.xml)

    =======================================================  
	<?xml version="1.0" encoding="UTF-8"?>
	<libresource-web locale="en">
		<resources>
			<resource key="Generic" name="Generic" service="*" type="*">
				<action controller="org.libresource.web.controllers.GenericController" name="view"/>
				<action controller="org.libresource.web.controllers.SecurityController" name="security"/>
				<action controller="org.libresource.web.controllers.ChownController" name="chown"/>
				<action controller="org.libresource.web.controllers.CreateChildController" name="new"/>
				<action controller="org.libresource.web.controllers.SearchUnderController" name="search"/>
				<action controller="org.libresource.web.controllers.DeleteController" name="delete"/>
				<action controller="org.libresource.web.controllers.UnbindController" name="unbind"/>
				<action controller="org.libresource.web.controllers.MoveController" name="move"/>
				<action controller="org.libresource.web.controllers.ChildrenExpandableController" name="children"/>
				<action controller="org.libresource.web.controllers.ChildrenTreeController" name="tree"/>
				<action controller="org.libresource.web.controllers.XMLController" name="xml"/>
				<action controller="org.libresource.web.controllers.EditMenuController" name="editMenu"/>
				<action controller="org.libresource.web.controllers.so6.StudioController" name="synchronizerStudio"/>
				<action controller="org.libresource.web.controllers.IndexationController" name="indexation"/>
				<action controller="org.libresource.web.controllers.AddToBookmarksController" name="addToBookmarks"/>
				<action controller="org.libresource.web.controllers.WatchController" name="watch"/>
				<action controller="org.libresource.web.controllers.InfosController" name="infos"/>
				<action controller="org.libresource.web.controllers.AddPropertyController" name="addProperty"/>
				<action controller="org.libresource.web.controllers.DeletePropertyController" name="deleteProperty"/>
				<action controller="org.libresource.web.controllers.form.ResultFormExporterController" name="childrenFormData"/>
				<action controller="org.libresource.web.controllers.form.EditFormInPlaceController" name="editFormInPlace"/>
				<action controller="org.libresource.web.controllers.JabberController" name="jabber"/>
			</resource>
			<resource key="Project" name="Project" service="LibresourceCore" type="Project">
				<action controller="org.libresource.web.controllers.core.ProjectController" name="view"/>
				<action controller="org.libresource.web.controllers.core.CreateProjectController" name="create"/>
				<action controller="org.libresource.web.controllers.core.EditProjectController" name="edit"/>
				<action controller="org.libresource.web.controllers.core.EditProjectSummaryController" name="editSummary"/>
				<action controller="org.libresource.web.controllers.core.ProjectStatsController" name="stats"/>
				<action controller="org.libresource.web.controllers.core.ProjectStatsHistoryController" name="statsHistory"/>
				<action controller="org.libresource.web.controllers.core.ProjectDrawPieChartController" name="drawPieChart"/>
				<action controller="org.libresource.web.controllers.core.ProjectDrawTimeChartController" name="drawTimeChart"/>
			</resource>
			<resource key="Template" name="Template" service="LibresourceCore" type="Template">
				<action controller="org.libresource.web.controllers.core.TemplateController" name="view"/>
				<action controller="org.libresource.web.controllers.core.CreateTemplateController" name="create"/>
				<action controller="org.libresource.web.controllers.core.EditTemplateController" name="edit"/>
				<action controller="org.libresource.web.controllers.core.NewInstanceController" name="newInstance"/>
			</resource>
			<resource key="Timeline" name="Timeline" service="LibresourceCore" type="Timeline">
				<action controller="org.libresource.web.controllers.core.TimelineController" name="view"/>
				<action controller="org.libresource.web.controllers.core.FullTimelineController" name="viewAll"/>
				<action controller="org.libresource.web.controllers.core.CreateTimelineController" name="create"/>
				<action controller="org.libresource.web.controllers.core.EditTimelineController" name="edit"/>
				<action controller="org.libresource.web.controllers.core.AddEventInTimelineController" name="addEvent"/>
				<action controller="org.libresource.web.controllers.core.RemoveEventInTimelineController" name="removeEvent"/>
				<action controller="org.libresource.web.controllers.core.ResetEventsInTimelineController" name="resetEvents"/>
				<action controller="org.libresource.web.controllers.core.CleanTimelineController" name="clean"/>
				<action controller="org.libresource.web.controllers.core.RssTimelineController" name="rss"/>
			</resource>
			<resource key="Page" name="Wiki Page" service="LibresourceWiki" type="Page">
				<action controller="org.libresource.web.controllers.wiki.PageController" name="view"/>
				<action controller="org.libresource.web.controllers.wiki.PageController" name="source"/>
				<action controller="org.libresource.web.controllers.wiki.CreatePageController" name="create"/>
				<action controller="org.libresource.web.controllers.wiki.EditPageController" name="edit"/>
				<action controller="org.libresource.web.controllers.wiki.EditPageContentController" name="editContent"/>
				<action controller="org.libresource.web.controllers.wiki.HistoryController" name="history"/>
				<action controller="org.libresource.web.controllers.wiki.PageVersionController" name="version"/>
				<action controller="org.libresource.web.controllers.wiki.RestoreVersionController" name="restore"/>
			</resource>
			<resource key="Repository" name="Download Area" service="LibresourceFiles" type="Repository">
				<action controller="org.libresource.web.controllers.files.RepositoryController" name="view"/>
				<action controller="org.libresource.web.controllers.files.CreateRepositoryController" name="create"/>
				<action controller="org.libresource.web.controllers.files.EditRepositoryController" name="edit"/>
				<action controller="org.libresource.web.controllers.files.UploadFileController" name="upload"/>
				<action controller="org.libresource.web.controllers.files.ImportZipFileController" name="importZip"/>
				<action controller="org.libresource.web.controllers.files.ExportAsZipController" name="exportAsZip"/>
				<action controller="org.libresource.web.controllers.files.RssRepositoryController" name="rss"/>
			</resource>
			<resource key="DropBox" name="Drop Box" service="LibresourceFiles" type="DropBox">
				<action controller="org.libresource.web.controllers.files.DropBoxController" name="view"/>
				<action controller="org.libresource.web.controllers.files.CreateDropBoxController" name="create"/>
				<action controller="org.libresource.web.controllers.files.EditDropBoxController" name="edit"/>
				<action controller="org.libresource.web.controllers.files.DropFileController" name="upload"/>
				<action controller="org.libresource.web.controllers.files.ExportAsZipController" name="exportAsZip"/>
				<action controller="org.libresource.web.controllers.files.RssDropBoxController" name="rss"/>
			</resource>
			<resource key="File" name="File" service="LibresourceFiles" type="File">
				<action controller="org.libresource.web.controllers.files.FileController" name="view"/>
				<action controller="org.libresource.web.controllers.files.CreateFileController" name="create"/>
				<action controller="org.libresource.web.controllers.files.EditFileController" name="edit"/>
				<action controller="org.libresource.web.controllers.files.EditFileInfoController" name="editInfo"/>
				<action controller="org.libresource.web.controllers.files.DownloadFileController" name="download"/>			
			</resource>
			<resource key="Forum" name="Forum" service="LibresourceForum" type="Forum">
				<action controller="org.libresource.web.controllers.forum.ForumController" name="view"/>
				<action controller="org.libresource.web.controllers.forum.CreateForumController" name="create"/>
				<action controller="org.libresource.web.controllers.forum.EditForumController" name="edit"/>
				<action controller="org.libresource.web.controllers.forum.PostInForumController" name="post"/>
				<action controller="org.libresource.web.controllers.forum.RssForumController" name="rss"/>
			</resource>
			<resource key="Thread" name="Messages Thread" service="LibresourceForum" type="Thread">
				<action controller="org.libresource.web.controllers.forum.ThreadController" name="view"/>
				<action controller="org.libresource.web.controllers.forum.CreateThreadController" name="create"/>
				<action controller="org.libresource.web.controllers.forum.EditThreadController" name="edit"/>
				<action controller="org.libresource.web.controllers.forum.PostInThreadController" name="post"/>
				<action controller="org.libresource.web.controllers.forum.RssThreadController" name="rss"/>
			</resource>
			<resource key="Message" name="Message" service="LibresourceForum" type="Message">
				<action controller="org.libresource.web.controllers.forum.MessageController" name="view"/>
				<action controller="org.libresource.web.controllers.forum.CreateMessageController" name="create"/>
				<action controller="org.libresource.web.controllers.forum.EditMessageController" name="edit"/>
			</resource>
			<resource key="Group" name="Group" service="Membership" type="Group">
				<action controller="org.libresource.web.controllers.membership.GroupController" name="view"/>
				<action controller="org.libresource.web.controllers.membership.CreateGroupController" name="create"/>
				<action controller="org.libresource.web.controllers.membership.EditGroupController" name="edit"/>
				<action controller="org.libresource.web.controllers.membership.AddMemberController" name="addMember"/>
				<action controller="org.libresource.web.controllers.membership.RemoveMemberController" name="removeMember"/>
			</resource>
			<resource key="LDAPGroup" name="LDAPGroup" service="Membership" type="LDAPGroup">
				<action controller="org.libresource.web.controllers.membership.LDAPGroupController" name="view"/>
				<action controller="org.libresource.web.controllers.membership.CreateLDAPGroupController" name="create"/>
				<action controller="org.libresource.web.controllers.membership.EditLDAPGroupController" name="edit"/>
			</resource>
			<resource key="Profile" name="User Profile" service="Membership" type="Profile">
				<action controller="org.libresource.web.controllers.membership.ProfileController" name="view"/>
				<action controller="org.libresource.web.controllers.membership.EditProfileController" name="edit"/>
				<action controller="org.libresource.web.controllers.membership.CreateFilterController" name="createFilter"/>
				<action controller="org.libresource.web.controllers.membership.DeleteFilterController" name="deleteFilter"/>
				<action controller="org.libresource.web.controllers.membership.EditFilterController" name="editFilter"/>
				<action controller="org.libresource.web.controllers.membership.EventsController" name="events"/>
				<action controller="org.libresource.web.controllers.membership.ViewMyIssuesController" name="issues"/>
				<action controller="org.libresource.web.controllers.membership.BookmarksController" name="bookmarks"/>
				<action controller="org.libresource.web.controllers.membership.EditBookmarksController" name="editBookmarks"/>
				<action controller="org.libresource.web.controllers.membership.EditUserPageController" name="editUserPage"/>
			</resource>
			<resource key="Synchronizer" name="Synchronizer" service="LibresourceSynchronizer" type="Synchronizer">
				<action controller="org.libresource.web.controllers.so6.SynchronizerController" name="view"/>
				<action controller="org.libresource.web.controllers.so6.EditSynchronizerController" name="edit"/>
				<action controller="org.libresource.web.controllers.so6.CreateSynchronizerController" name="create"/>
				<action controller="org.libresource.web.controllers.so6.CreateReplicaController" name="createWorkspace"/>
				<action controller="org.libresource.web.controllers.so6.GetPatchController" name="getPatch"/>
				<action controller="org.libresource.web.controllers.so6.PatchInspectorController" name="inspectPatch"/>			
				<action controller="org.libresource.web.controllers.so6.GetDataflowController" name="getDataflow"/>
				<action controller="org.libresource.web.controllers.so6.DataflowController" name="viewDataflow"/>
				<action controller="org.libresource.web.controllers.so6.DownloadController" name="download"/>
				<action controller="org.libresource.web.controllers.so6.EditPatchController" name="editPatch"/>
				<action controller="org.libresource.web.controllers.so6.CompressController" name="compress"/>
				<action controller="org.libresource.web.controllers.so6.ExportContentAsZipController" name="exportAsZip"/>
				<action controller="org.libresource.web.controllers.so6.RssPatchOfSynchronizerController" name="rss"/>
			</resource>
			<resource key="Workspace" name="Workspace" service="LibresourceSynchronizer" type="WsConnection">
				<action controller="org.libresource.web.controllers.so6.ReplicaController" name="view"/>
				<action controller="org.libresource.web.controllers.so6.EditReplicaController" name="edit"/>
				<action controller="org.libresource.web.controllers.so6.UpdateController" name="update"/>	
				<action controller="org.libresource.web.controllers.so6.CommitController" name="commit"/>		
				<action controller="org.libresource.web.controllers.so6.DataflowController" name="viewDataflow"/>
				<action controller="org.libresource.web.controllers.so6.UpdateLocalReplicaController" name="updateLocalMetaData"/>
				<action controller="org.libresource.web.controllers.so6.CompressController" name="compress"/>
			</resource>
			<resource key="BugTracker" name="Bug Tracker" service="LibresourceBugTracker" type="BugTracker">
				<action controller="org.libresource.web.controllers.bugtracker.BugTrackerController" name="view"/>
				<action controller="org.libresource.web.controllers.bugtracker.CreateBugTrackerController" name="create"/>
				<action controller="org.libresource.web.controllers.bugtracker.EditBugTrackerController" name="edit"/>
				<action controller="org.libresource.web.controllers.bugtracker.AddInBugTrackerController" name="add"/>
				<action controller="org.libresource.web.controllers.bugtracker.ViewMyIssuesInBugTrackerController" name="viewMyIssuesInBugTracker"/>
				<action controller="org.libresource.web.controllers.bugtracker.RssBugTrackerController" name="rss"/>
			</resource>
			<resource key="Issue" name="Issue" service="LibresourceBugTracker" type="Issue">
				<action controller="org.libresource.web.controllers.bugtracker.IssueController" name="view"/>
				<action controller="org.libresource.web.controllers.bugtracker.CreateIssueController" name="create"/>
				<action controller="org.libresource.web.controllers.bugtracker.EditIssueController" name="edit"/>
				<action controller="org.libresource.web.controllers.bugtracker.PostCommentInIssueController" name="post"/>
				<action controller="org.libresource.web.controllers.bugtracker.AddFileInIssueController" name="add"/>
				<action controller="org.libresource.web.controllers.bugtracker.AssignIssueController" name="assign"/>
				<action controller="org.libresource.web.controllers.bugtracker.ResolveIssueController" name="resolve"/>
				<action controller="org.libresource.web.controllers.bugtracker.RssCommentsInIssueController" name="commentsRss"/>
				<action controller="org.libresource.web.controllers.bugtracker.RssFilesInIssueController" name="filesRss"/>
			</resource>
			<resource key="Site" name="Remote Site" service="MetaSite" type="Site">
				<action controller="org.libresource.web.controllers.metasite.SiteController" name="view"/>
				<action controller="org.libresource.web.controllers.metasite.CreateSiteController" name="create"/>
				<action controller="org.libresource.web.controllers.metasite.EditSiteController" name="edit"/>
				<action controller="org.libresource.web.controllers.metasite.SynchronizeController" name="synchronize"/>
			</resource>
			<resource key="ProjectProxy" name="Remote Project" service="MetaSite" type="ProjectProxy">
				<action controller="org.libresource.web.controllers.metasite.ProjectProxyController" name="view"/>
			</resource>
			<resource key="Survey" name="Survey" service="LibresourceSurvey" type="Survey">
				<action controller="org.libresource.web.controllers.survey.SurveyController" name="view"/>
				<action controller="org.libresource.web.controllers.survey.CreateSurveyController" name="create"/>
				<action controller="org.libresource.web.controllers.survey.EditSurveyController" name="edit"/>
				<action controller="org.libresource.web.controllers.survey.EditOptionsController" name="editOptions"/>
				<action controller="org.libresource.web.controllers.survey.AddOptionController" name="addOption"/>
				<action controller="org.libresource.web.controllers.survey.EditOptionController" name="editOption"/>
				<action controller="org.libresource.web.controllers.survey.RemoveOptionController" name="removeOption"/>
				<action controller="org.libresource.web.controllers.survey.VoteController" name="vote"/>
				<action controller="org.libresource.web.controllers.survey.DrawPieChartController" name="drawPieChart"/>
				<action controller="org.libresource.web.controllers.survey.DrawHistogramController" name="drawHistogram"/>
			</resource>
			<resource key="Form" name="Form" service="LibresourceForm" type="Form">
				<action controller="org.libresource.web.controllers.form.FormController" name="view"/>
				<action controller="org.libresource.web.controllers.form.CreateFormController" name="create"/>
				<action controller="org.libresource.web.controllers.form.EditFormController" name="edit"/>
				<action controller="org.libresource.web.controllers.form.SubmitFormController" name="submit"/>
			</resource>
			
			<!-- Warning !!! Need of a local SVN server for this resource ! -->
			<resource key="Subversion" name="Subversion repository" service="LibresourceSubversion" type="SubversionRepository">
				<action controller="org.libresource.web.controllers.subversion.RepositoryController" name="view"/>
				<action controller="org.libresource.web.controllers.subversion.CreateRepositoryController" name="create"/>
				<action controller="org.libresource.web.controllers.subversion.EditRepositoryController" name="edit"/>
			</resource>
		</resources>
		<skins>
			<skin key="basic" css="styles/basic/style.jsp?light=0e3a6b&amp;amp;dark=061525" name="Basic" platforms="Mozilla (recommended), Internet Explorer, Safari"/>
			<skin key="basic-pink" css="styles/basic/style.jsp?light=ff00c0&amp;amp;dark=402239" name="Basic Fashion" platforms="Mozilla (recommended), Internet Explorer, Safari"/>
			<skin key="basic-dirty" css="styles/basic/style.jsp?light=391089&amp;amp;dark=a299e6" name="Basic D*I*R*T*Y" platforms="Mozilla (recommended), Internet Explorer, Safari"/>
			<skin key="basic-objectweb" css="styles/basic/style.jsp?light=e06611&amp;amp;dark=433C7B" name="Basic ObjectWeb" platforms="Mozilla (recommended), Internet Explorer, Safari"/>
			<skin key="basic-green" css="styles/basic/style.jsp?light=00cc00&amp;amp;dark=105817" name="Basic Radioactive" platforms="Mozilla (recommended), Internet Explorer, Safari"/>
			<skin key="basic-blue" css="styles/basic/style.jsp?light=0099cc&amp;amp;dark=1e5276" name="Basic Blue" platforms="Mozilla (recommended), Internet Explorer, Safari"/>
			<skin key="basic-loria" css="styles/basic/style.jsp?light=990000&amp;amp;dark=b8ba36" name="Basic Loria" platforms="Mozilla (recommended), Internet Explorer, Safari"/>
			<skin key="none" css="" name="No Skin" platforms="All"/>
		</skins>
		<langs>
			<lang key="en" name="English"/>
			<lang key="fr" name="Francais"/>
		</langs>
	</libresource-web>
    =======================================================  

  - Configure the Subversion installation

       aptitude install subversion subversion-tools libapache2-svn libapache2-mod-auth-pgsql
       a2enmod auth_pgsql

       Ce module est inutilisable si il n'est pas chargé en premier :
       cd /etc/apache2/mods-enabled
       mv auth_pgsql.load 0000_auth_pgsql.load

       en tant que libresource :
       mkdir /home/libresource/svn
       cd /home/libresource/svn
       svnadmin create test

       en tant que root :
       chown -R www-data:www-data .

       exemple de fichier de conf de site apache :
       <VirtualHost *>
          ServerName bench.artenum.com
          ErrorLog /home/libresource/logs/bench/error_log
          CustomLog /home/libresource/logs/bench/access_log combined

          <Location /ls-svn/>
            DAV svn
            SVNParentPath /home/libresource/svn/

            Require valid-user
            AuthName "svn"
            AuthType Basic
            Auth_PG_host localhost
            Auth_PG_port 5432
            Auth_PG_database libresource
            Auth_PG_user postgres
            Auth_PG_pwd rien
            Auth_PG_pwd_table casusers_
            Auth_PG_uid_field username_
            Auth_PG_pwd_field passworddigest_
            Auth_PG_cache_passwords on
            Auth_PG_encrypted off
          </Location>
       </VirtualHost>