Where
Grand Parlour - A
When
6 November 2017
9am - 12pm
Preparations
We will be using a Docker virtual environment for the hands-on portions of the workshop.
NOTE: You will need a laptop with at least 4GB of RAM to run the Docker images. Depending on your laptop manufacturer, you may also need to enable virtualization in the BIOS.
- Download, install, and run Docker: https://www.docker.com/community-edition#/download
- Download and unzip the Fedora/API-X Demo: https://github.com/fcrepo4-labs/fcrepo-api-x-demo/archive/master.zip
- Using a Command Line Interface, navigate to the directory where you unzipped the file from step 2
- Run the command: docker-compose pull, which will download the latest images and any last-minute patches
- Run the command: docker-compose up -d
- Note that this step will take a while as the Demo downloads and installs a full virtual environment
- Test the Demo by opening your web browser and navigating to: http://localhost:8080/fcrepo
- The administrator username/password is fedoraAdmin/secret3
- Turn off the Demo by running the command: docker-compose stop
We will also be making use of the SSH command - if you are running MacOS or Linux you can already run this command, but if you are on Windows you will need an SSH client like the one bundled with the GitHub Desktop application: https://desktop.github.com/.
Finally, we will also have an opportunity to try out the new import/export utility during the camp. To follow along, please download the executable JAR file: https://github.com/fcrepo4-labs/fcrepo-import-export/releases/download/fcrepo-import-export-0.2.0/fcrepo-import-export-0.2.0.jar. The utility requires Java 8.
Attendees
A list of attendees will be posted following the workshop
Agenda/Presentations
| Time | Topic |
|---|---|
| 9:00 - 9:15 | Welcome, introductions, VM setup |
| 9:15 - 9:30 | Introduction to Fedora |
| 9:30 - 10:30 | Introduction to the API Extension Architecture |
| 10:30 - 10:45 | Break |
| 10:45 - 11:45 | |
| 11:45 - 12:00 | Wrap-up and discussion |
Summary
Fedora is the flexible, extensible, open source repository platform that commonly underlies Samvera implementations. Fedora provides a number of core services that Samvera already uses, such as CRUD operations, versioning, and fixity, and several new, potentially useful extended services have been introduced within the last year. The API Extension Framework provides a means of binding services to repository objects in order to extend the functionality of Fedora, while the Import/Export Utility makes it easier to get content into and out of Fedora in standardized formats and packages. This workshop will introduce both of these new services and discuss how they might be used in the context of Samvera. Participants will also have an opportunity to try them out via hands-on exercises in combination with a virtual machine.
For more information, please contact David Wilcox (dwilcox@duraspace.org).
