...

The Amazon S3 storage implementation stores OCFL objects directly in an Amazon S3 bucket. Optionally, a key prefix can be used to partition the repository to use only a portion of its bucket, allowing you to store multiple OCFL repositories in the same bucket or non-OCFL content.

Requirements

S3 Bucket

At the minimum, permissions on the bucket must allow the authorized client to perform the following actions:

• s3:PutObject
• s3:GetObject
• s3:DeleteObject
• s3:ListBucket
• s3:AbortMultipartUpload

Database

The OCFL library used by Fedora uses the same database as that used by Fedora for locking and caching OCFL object details. This is necessary to solve eventual consistency and concurrency issues. Like the other database tables used by Fedora, all information in the database serves as a cache and will be automatically repopulated if deleted.

NOTE: Currently, the only supported databases in the underlying OCFL library are PostgreSQL and H2; therefore, in order to use Fedora's S3 feature, Fedora's must be configured to either use PostgreSQL (production) or H2 (test).

Configuration

AWS Credential Configuration

The credentials used to interact with S3 must be available to Fedora per Amazon's guidelines.

Fedora Configuration

The following configuration items are passed to the Fedora application on startup via system properties.

...