Milliner

Milliner

Introduction

Microservice that converts Drupal entities into Fedora resources.

Installation

Milliner requires a functioning Drupal 8 or 9 installation with the jsonld module enabled.

It also requires a functioning Fedora repository.

• Clone this repository somewhere in your web root.
• Install composer. Install instructions here.
• $ cd /path/to/Milliner and run $ composer install
• For production, configure your web server appropriately (e.g. add a VirtualHost for Milliner in Apache)

Upgrading

Steps for upgrading Milliner can be found in UPGRADE.md

Configuration

Symfony uses .dotenv to set environment variables. You can check the .env in the root of the Milliner directory. To alter any settings, create a file called .env.local to store your specific changes. You can also set an actual environment variable.

For production use make sure to set the add APP_ENV=prod environment variable.

There are various configurable parameters located in the /path/to/Milliner/config/services.yaml.

parameters:
    app.fedora_base_url: "http://localhost:8080/fcrepo/rest"
    app.modified_date_predicate: "http://schema.org/dateModified"
    app.strip_format_jsonld: true
    app.isFedora6: true

app.fedora_base_url defines the base URL of your Fedora repository.

app.modified_date_predicate defines the predicate which will be compared to determine which of the Fedora or Drupal resource has been updated more recently.

app.strip_format_jsonld determines whether to remove the ?_format=jsonld from subject URIs before pushing the RDF to Fedora.

app.isFedora6 determines whether the Fedora instance is version 5.. or 6...

You do NOT need to edit the fedora_base_url inside /path/to/Milliner/config/packages/crayfish_commons.yaml as this re-uses the above setting. However in the same file you can point to the location of your syn-settings.xml. If you don't have a syn-settings.xml look at the Syn documentation.

Logging

To change your log settings, edit the /path/to/Milliner/config/packages/monolog.yaml file.

You can also copy the file into one of the /path/to/Milliner/config/packages/<environment> directories. Where <environment> is dev, test, or prod based on the APP_ENV variable (see above). The files in the specific environment directory will take precedence over those in the /path/to/Milliner/config/packages directory.

The location specified in the configuration file for the log must be writable by the web server.

Disabling Syn

There are instructions in the /path/to/Milliner/config/packages/security.yaml file describing what to change and what lines to comment out to disable Syn.

Usage

Milliner sets up a multiple endpoints,

• /node/{uuid} which accepts POST and DELETE requests.
  • POST is to save a Drupal resource to Fedora.
  • DELETE is to delete a Fedora resource.
• /node/{uuid}/version which accepts POST requests.
  • POST creates a new version in Fedora for the resource
• /media/{source_field} which accepts POST requests.
  • POST creates a new media in Fedora for the resource identifed in the Content-Location header.
• /media/{source_field}/version which accepts POST requests.
  • POST creates a new version of the media in Fedora for the resource identifed in the Content-Location header.
• /external/{uuid} which accepts POST requests.
  • POST creates a new external content resource for the Drupal resource

UUID is transformed into a Fedora URI using the Crayfish-Commons EntityMapper.

Maintainers

Current maintainers:

• Daniel Lamb

Development

If you would like to contribute, please get involved by attending our weekly Tech Call. We love to hear from you!

If you would like to contribute code to the project, you need to be covered by an Islandora Foundation Contributor License Agreement or Corporate Contributor License Agreement. Please see the Contributors pages on Islandora.ca for more information.

License

MIT