The cloud implementation of FileSystemHandler. This implementation reads and writes files to and from OpenStack-Swift cloud storage.
Clone and build this module like any other Sakai modules. It can be cloned into
an existing working copy or somewhere parallel. You must use the sakai:deploy
Maven goal to deploy the component pack.
To use Swift rather than the default file/database storage, settings must be configured in two places:
- sakai-configuration.xml
- local.properties (or another like sakai.properties)
The only setting in sakai-configuration.xml needed is the bean alias to activate this handler rather than the default. This file must be a valid Spring bean config file; either create it in its entirety or just add this alias.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<alias name="org.sakaiproject.content.api.FileSystemHandler.swift" alias="org.sakaiproject.content.api.FileSystemHandler" />
</beans>
The actual configuration values should be supplied using the bean property
syntax in, e.g., local.properties. The standard bodyPath and
bodyPathDeleted properties must be set or the files will be stored in the
database. However, these should not be prefixed with ${sakai.home} or local directory names since all leading paths will be created as containers or pseudo-folders as needed, adding unneeded depth in your object store. The useIdForPath` setting can be either true or false, but true is recommended
as the paths will mirror the resource IDs/URLs.
[email protected] = http://swift.server:5000/v2.0/
[email protected] = tenant:username
[email protected] = password
[email protected] = RegionOne
useIdForPath@org.sakaiproject.content.api.FileSystemHandler.swift = true
[email protected]=/content/live/
bodyPathDeleted@org.sakaiproject.content.api.ContentHostingService=/content/deleted/
If you are not familiar with sakai-configuration.xml, it is placed in the same location
as the properties files. See Confluence for an overview:
[https://confluence.sakaiproject.org/display/REL/More+Flexible+Sakai+Configuration](More Flexible Sakai Configuration)