Versions Compared

Key

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

...

The Islandora Video Solution Pack is used to ingest digital videos into Fedora. It supports creation of derivatives in various different video formats, and requires the server-side installation of accompanying codecs to enable this functionality. It can also be configured to stream the video to a player window on-site using JWPlayer.

Dependencies

Note

FFmpeg version 1.1.1 4 has been tested. It can be downloaded here

FFmpeg sample compile flags: --prefix=/usr/local/stow/ffmpeg-1.1.4 --enable-gpl --enable-version3 --enable-nonfree --enable-postproc --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-libdc1394 --enable-libfaac --enable-libgsm --enable-libmp3lame --enable-libopenjpeg --enable-libschroedinger --enable-libspeex --enable-libtheora --enable-libvorbis --enable-libvpx --enable-libx264 --enable-libxvid

Note

 remove the --enable-x11grab flag on the ffmpeg configure.

Downloads

Release Notes and Downloads

Installation

This installation cam can be very tricky, and possibly the most difficult of all components of the Islandora stack. Please see this post regarding past installs on the Islandora Google Group for details (please replace any references to release 7.x-1.3 with 7.x.1-5):
https://groups.google.com/forum/#!topic/islandora/wuOjmRTY5Rs

Configuration

Set the path for FFmpeg, select configuration options and viewer in Administration » Islandora » Video Solution Pack (admin/islandora/video).

The Islandora Video Solution pack can be configured at http://path.to.your.site/admin/islandora/solution_pack_config/video, and includes the following options:

...

  • Keep original file after ingest? - Check this option to retain files uploaded to a video collection as a datastream appended to the video object

...

  • .

Image Added

Note

Creating OGGs locally only exists for legacy compatibility. Unless you have a very good reason for doing so, you should not use this option. If necessary, view ffmpeg2Theora documentation for more on creating OGG derivatives.

Paths to

...

FFmpeg/Theora executables

For derivative creation, the Video Solution Pack needs to know the location of the binaries that perform conversion. On Unix-based systems, this can often be done by running:

Code Block
whereis ffmpeg ffmpeg2theora

and checking Check for binary package files located in folders called 'bin' (such as /usr/bin, /usr/local/bin, etc.).

Warning

Video conversion in any context is an extremely resource-heavy task that can be very taxing on the computer performing it. In the case of Islandora, when using these derivative creation options, the task is called upon and performed by the 'apache' user on the same server Islandora is running on and that users are performing other tasks with. When creating video derivatives on ingest, please consider either delaying ingest to a low-traffic period of time, or performing derivative creation on another machine altogether.

...

The Video Solution Pack comes with the following objects in http://path.to.your.site/admin/islandora/solution_pack_config/solution_packs:

...

RELS-EXT

Default Fedora relationship metadata

MODS

MODS descriptive metadata record created during ingest

DC

Dublin Core descriptive metadata record

OBJ

The original video file ingested

TECHMDFITS technical metadata record created during ingest
TNThumbnail image pulled from a frame of the video by ffmpeg2theora
MP4MP4 derivative created during ingest by ffmpeg FFmpeg and used by JWPlayer if no suitable video existsOGGOGG audio-only derivative created by ffmpeg2theora
MKVMKV derivative created during ingest by ffmpegTNThumbnail image pulled from a frame of the video by ffmpeg2theoraFFmpeg

The Video Solution Pack comes with the Video MODS Form.

...

If you would like to contribute to this module, please check out our helpful  CONTRIBUTING.md. In addition, we have helpful Documentation for Developers info info, as well as our our Developers section section on the Islandora.ca site.

The Video Solution Pack includes an ingest/purge load test that is disabled and unusable by default. This particular solution pack was chosen for load testing due to the resource-heavy process of creating video derivatives and ingesting several potentially-massive files. To enable and use it:

  1. Make sure that the Testing module is enabled and that all prerequisites for derivative creation are satisfied for the Video Solution Pack.
  2. Edit the islandora_video.info file in this folder, removing the ; and whitespace before the line files[] = tests/islandora_video_load_test.test
  3. Create a folder in the the tests/fixtures/ called  called load, and place as many videos in that folder as you would like to ingest. These files all must fit within the size specified by your php.ini file's maximum post size, and they must have a file extension supported by the Video Solution Pack, otherwise they will not be picked up by the load test.
  4. Clear the Drupal cache.

...