Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

  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)

...

  1. You have Fedora installed and properly configured:

...

  1. You have the Tuque library properly installed:

...

  1. Other requirements beyond what is needed by Fedora and Drupal

 

Info
titleSolution 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.

Info
titleFedora 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:

      Code Block
      languagebash
      titleGit method
      cd /public_html/your_drupal_directory/sites/all/modules
      git clone -b 7.x https://github.com/Islandora/islandora.git
      Code Block
      languagebash
      titleUnzip 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.