Versions Compared

Old Version 7

changes.mady.by.user Melissa Anez

Saved on

compared with

New Version Current

changes.mady.by.user Melissa Anez

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Table of Contents

1. Download the Latest Version of the Islandora Drupal

...

Filter

Download the Drupal Filter files from the Release Notes and Downloads page. Extract the contents of the archive, and make sure you choose the correct JAR file for your version of Fedora.

...

Code Block
cp fcrepo-drupalauthfilter-3.4.2.jar $FEDORA_HOME/tomcat/webapps/fedora/WEB-INF/lib
Info

For Fedora 3.6.x, try this filter provided by Peter Murray

2. Make the Fedora Repository Aware of the New Filter

...

Create the file filter-drupal.xml in $FEDORA_HOME/server/config using the following text as a template (or download a sample file from Github https://raw.github.com/Islandora/islandora_drupal_filter/master/filter-drupal.xml), then modify the attributes of the <connection>  tag to match the server, port, database name, username and password of your site's Drupal database.

...

5. Test the Drupal Servlet Filter

Access your Fedora Admin client (http://your.site:8080/fedora/admin) using your Drupal login credentials (the username and password you would use to log into your Drpual site as a user).

Unlike Islandora 6, Islandora 7 will test your Fedora connection for you. To verify that the servlet filter is working properly, go to the Islandora configuration page (admin/islandora/configure) and look for the green checkmark. A successful installation will look like this:

Image Added

An unsuccessful installation will look like this:

Image Added

If you see this error, there are two possible sources for the failure:

  • You do not have the correct fcrepo-drupalauthfilter-xxxx.jar
  • Your filter-drupal.xml is incorrect or missing

 

Note
The islandora_drupal_filter passes the username of 'anonymous' through to Fedora for unauthenticated Drupal Users. A user with the name of 'anonymous'may have XACML policies applied to them that are meant to be applied to Drupal users that are not logged in or vice-versa. This is a potential security issue that can be plugged by creating a user named 'anonymous' and restricting access to the account.
Info

In the Fedora log in, you will need to offer the MD5 hash of your Drupal user's password (rather than the plaintext password). You can use the following Linux command to get this MD5 hash:

echo -n "yourpassword" | md5sum