This documentation refers to an earlier version of Islandora. https://wiki.duraspace.org/display/ISLANDORA/Start is current.

Skip to end of metadata
Go to start of metadata

Editor's "To Do" list

  • remove duplicate content and reference to primary documentation location
  • add the "installation steps"
  • move the "GSearch" info into an "info note"
  • move "solution pack" info into an "info note"

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

 

Solution Pack Dependencies

Any Islandora Solution Pack may come with a specific set of requirements and dependencies outside of the scope of the basic Islandora Installation. You will need to install any dependencies specific to a Solution Pack in order for that Solution Pack to function properly.

Fedora GSearch

To take full advantage of the module you will need to enable the Fedora Resource Index in the Fedora config file. You should also follow the steps on Installing Solr and GSearch. Although this is not required to be completed prior to installing the Islandora Module, Fedora GSearch does include Lucene and enables full text searching of the repository.

 

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.

  • No labels