Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To easily test this feature during the install fest, we've built a sample war file that exposes a federation over the home directory of the user account under which the application is running.

Quick View:

  1. Download an executable jar file for the release
  2. Launch the jar file by double-clicking on it or typing "java -jar filename" in the command line

Install in Tomcat:

  1. Install tomcat
  2. Download a pre-built war file for the file system federation
  3. Copy that war file into the webapps directory of your tomcat installation
  4. When tomcat's running you can browse your home directory online at: http://localhost:8080/fcrepo-webapp-home-directory-federation-4.0.0-alpha-3-SNAPSHOT/rest/home

Build from source:

Currently the configuration (which specifies which files to expose at what path) can only easily be edited before the application is compiled.  The following instructions explain the process of configuring, building

...

Browse your home directory through fedora at http://localhost:8080/rest/home

Multiple Directories

Although the syntax appears to support multiple mappings, we have found that a separate configuration block is required for each directory to be federated:

Code Block
    "externalSources" : {
        "federated-1" : {
            "classname" : "org.fcrepo.connector.file.FedoraFileSystemConnector",
            "directoryPath" : "/path/to/dir1",
            "projections" : [ "default:/dir1 => /" ],
            "contentBasedSha1" : "false",
            "readonly" : true,
            "extraPropertiesStorage" : "none"
        },
        "federated-2" : {
            "classname" : "org.fcrepo.connector.file.FedoraFileSystemConnector",
            "directoryPath" : "/path/to/dir2",
            "projections" : [ "default:/dir2 => /" ],
            "contentBasedSha1" : "false",
            "readonly" : true,
            "extraPropertiesStorage" : "none"
        }
    }

This configuration would provide access to the two directories at http://localhost:8080/rest/dir1 and http://localhost:8080/rest/dir2.