Ensure your content is on a filesystem accessible to Fedora 4
The file system federation connector supports mounting a single root path (and all that's present beneath it). Furthermore, unless you configure it to use an external properties store, it will add additional files to each visited directory with properties for the files (even if in read-only mode).
Make sure that:
- The path to your content and all files beneath it can be read by Fedora
- When using an external properties store, the external directory path exists and can be read by and written to by Fedora
- Otherwise the path to your content files must also be able to be written to by Fedora
On POSIX systems, when the original organization of content is not ideal for your Fedora federation, you may use symbolic links to include just the resources you wish in the structure that's most suitable for your needs. This may help you taylor your federation to include a subset of a larger archival storage or allow you to overcome performance or usability issues associated from an extremely flat hierarchy.
Determine where in your Fedora repository you wish to "mount" the federation
In the easiest configuration a federation may be mounted at the root level of your repository, but if you wish to have a more sophisticated organization, perhaps for the purpose of exposing cascading access controls, it is possible to mount such a federation at an arbitrary path.
Configuring a path within a hierarchy is not currently a well-supported option. That said it can be accomplished as in the following example where we wish to mount a directory to the fedora path "/collection1/masters/files".
- configure a file system federation that mounts the content at that path
- start Fedora (the parent node of the federation doesn't exist, so the federation won't be accessible)
- create a new node with the name "collection1/master/files"
- delete the "files" node (the parent will still exist)
- restart Fedora
Update your repository configuration
Changes to your repository configuration (repository.json) require a restart to take effect. Configuration options are detailed here, but in general you'll need to add an element for your new file system federation that points to the directory path that contains your federated files (and possibly a path for your external properties).
