Troubleshooting Islandora

Problems authenticating

One of the most common problems people run into is not being able to authenticate to Fedora.  Misconfiguration of the drupal filter is the most common cause of this.  Some things to check.

• Make sure the latest version of the drupal filter jar file is in the $FEDORA_HOME/tomcat/webapps/fedora/WEB-INF/lib directory.
• Make sure the mysql jdbc jar file is available to tomcat.  One way to do this is copy the latest mysql jdbc jar file to the same directory as drupal filter jar file ($FEDORA_HOME/tomcat/webapps/fedora/WEB-INF/lib directory).
• Check the user that is connecting to mysql has permission to connect.  If Fedora is on a different ip then mysql you will  have to allow access from that ip.  Make sure there aren't any firewalls blocking the port mysql is listening on and make sure the user has rights from the remote ip.  You could login to mysql and do something like:

Grant all on drupaldb.* to fedora@ipaddress identified by 'password'; flush privileges;

• • Check the mysql docs for more info.

You can test the drupal filter by signing in to the Fedora-admin client using a drupal username and password as is from the drupal database (the hash value).  To get the hash of the password you would login to mysql and find the user in the users table and copy that.  If the drupal filter is working correctly you should be able to signin in and do anything that the user has rights to do.  If you can't signin in then the drupal filter is misconfigured.  In some versions of the admin client you will not get an error when signing in with an invalid user/pass so try a search to verify the user is valid.

Another test is to allow anonymous access to Fedora through Drupal (see the Islandora Guide).  If you can see fedora objects when not logged into Drupal then the problem is the drupal filter.  If you still cannot connect to Fedora From Islandora then there may be issues else ware.

Check the logs

Catalina.out is a good place to check if you are having problems connecting to Fedora.  This file is located can be found $FEDORA_HOME/tomcat/logs/catalina.out.  There are also some log files in $FEDORA_HOME/server/logs.

You can also check the apache access and error logs.  There location would depend on your installation.

Drupal's watchdog can also be helpful.  It can be found under Administration->reports->Recent log entries

Verify Islandora Admin page settings are correct.

Carefully check the Islandora admin page settings.  If there are errors in any of the urls then portions of Islandora may not function properly.  You can get to the admin interface of Islandora by logging in to Drupal with admin privileges and then clicking on adminstration and choosing the Fedora Collection List.