Installing the Islandora Module

Pre-installation software checklist

The Islandora framework relies upon a number of other open source applications. Before beginning the installation of any Islandora modules, ensure:

1. You have Drupal installed and properly configured with:

• Clean URLs enabled (admin/config/search/clean-urls) - requires the Apache mod_rewrite module to be enabled. 
• The Drupal file system set to public (admin/config/media/file-system)

2. You have Fedora installed and properly configured:

• Ensure you can use the admin tools in Fedora to ingest and purge (e.g. http://localhost:8080/fedora/admin).

3. You have installed the Tuque library:

$ cd /public_html/your_drupal_directory/sites/all/libraries # Replace 'public_html' and 'your_drupal_directory' with your HTML root folder and Drupal directory as appropriate.
$ wget https://github.com/islandora/tuque/archive/1.3.zip
$ unzip 1.3.zip

4. Other requirements beyond what is needed by Fedora and Drupal include:

• PHP5-curl
• PHP-soap
• PHP5-xsl

You will also need to install any dependencies that are needed for the Solution Packs you are using.

To take full advantage of the module you will need to enable the Fedora Resource Index in the Fedora config file. You should also have Solr and Fedora GSearch installed, although this step does not need to be completed prior to installing the Module. Fedora GSearch includes Lucene and enables full text searching.

Installing the Islandora module

To install the module, use the standard Drupal module installation method:

1. Place the unpackaged module in your site's 'modules' folder. For single-site installations, this should almost always be in your_drupal_directory/sites/all/modules. This can be done using one of two methods:

• Manually via the command line:

cd /public_html/your_drupal_directory/sites/all/modules
git clone -b 7.x https://github.com/Islandora/islandora.git

cd /public_html/your_drupal_directory/sites/all/modules
wget https://github.com/Islandora/islandora/archive/7.x.zip
unzip 7.x.zip
# At this point, you should consider changing ownership of the directory and its contents to the webserver user (i.e. if using Apache and the user is www-data):
chown -R www-data:www-data islandora-7.x

• From within Drupal: navigate to base-site-url/admin/modules/install. From here, either upload the zipped module, or enter https://github.com/Islandora/islandora/archive/7.x.zip into the text box there. Note that this method is less reliable, as it requires the correct permissions to have been previously set up using your web server

2. Enable the uploaded module by navigating to base-site-url/admin/modules, scrolling down to the Islandora module (in the 'Islandora' category), checking the box to the left of it, and then scrolling to the bottom of the page and clicking the 'Save configuration' button.

At the end of this installation, you will be ready to populate your site with digital assets and be capable of using any installed Solution Packs. Your root Islandora repository can be found at base-site-url/islandora.