Installation FAQ

From ReservesDirect: Open Source EReserves System

Home :: Features :: Screenshots :: Demo (http://www.reservesdirect.org/demo/index.html) :: Documentation :: Downloads :: Support :: Blog (http://www.reservesdirect.org/blog) :: Join Us!
ReservesDirect Documentation:   Contents | Library staff handbook | System administrator handbook | Developer handbook

I have php running on my server but uncompiled PHP code is being served to my browser. What's wrong?

RD uses short tags '<?' to indicate PHP code, you need to enable short-tag parsing for your server. In php.ini, modify the short_open_tag setting.

RD is returning a blank screen. What's going on?"

Usually a blank page is a sign of a fatal error of some kind. You can put RD into debug mode by adding 

    ?debug

To the end of the base URL at the login screen, or add 

    &debug

to the end of the URL command string on any page after you are logged into the system. This will give you feedback on what problem the system is encountering.

I have downloaded the reserves direct software and the files are looking for a DB.php file, but I can't find it anywhere on my server, and it didn't come with the e-reserves distribution. Where do I get the DB.php file from?

DB.php is part of PEAR::DB. The easiest way to install this is by running 'pear install DB'.

There is more information at the PEAR web site at: http://pear.php.net/package/DB

I can't create new libraries through the Admin interface. What's going on?

This is now a known issue in the Admin interface. The admin interface requires you to specify a processing library for physical items when attempting to create a new library, so if there are no libraries in the database, you can't create any. It's a catch-22. The work-aroudn is to create a stub library by inserting a row into the "libraries" table of the database. This can be a real library or a fake one, and the processing library for this first stub can be self-referrential. In other words, where the libraries table is:

library id | name | nickname | ils_prefix | reserve_desk | url | contact_email | mongraph_library_id | multimedia_library_id | copyright_library_id

and you auto-increment the library_id, a stub row could look like:

1 | Stub Library | Stub | Stub | Stub | [null] | [null] | 1 | 1 | 1

We've added this bug to our tracking and will come out with a fix.

How do I get LDAP authentication up and running against active directory?

  • Your AD sysadmin may have to activate the ldap interface, it isn't turned on be default
  • If you're going to make an ssl connection to AD ldaps (port 636), then you'll need a copy of your server's ssl certificate stored in the trusted CA store on the server running ReservesDirect. On a Redhat Enterprise system the relevant file is usually /usr/share/ssl/certs/ca-bundle.crt
  • You'll need an account created in AD that is able to search for information about other accounts. This is the account you'll use to initially bind to ldap(s), before you try to rebind with the authenticating user's account.


Retrieved from "http://www.reservesdirect.org/wiki/index.php/Installation_FAQ"