d. 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 the Tuque library properly installed:
4. Other requirements beyond what is needed by Fedora and Drupal

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.

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:

     Git method

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

     Unzip method

     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.