Versions Compared

Key

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

...

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.

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 methodstructure:

  1. Place the unpackaged module in your site's 'modules' folder, with the name stripped out of the version. For single-site installations, this should almost always be in /var/www/drupal/sites/all/modules. This can be done using one of two methods:
    • Manually via the command line:

      Code Block
      languagebash
      titleUnzip method
      # cd /opt/downloads
      # git clone -b 7.x https://github.com/Islandora/islandora.git
      # cp -R /opt/downloads/islandora /var/www/drupal/sites/all/modules
      # cd /var/www/drupal/sites/all/modules
      # chown -R www-data:www-data islandora
    • 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.

    Configuration

    Once installed, configuration options for the Islandora module can be found on your site at http://path.to.your.site/admin/islandora/configure.  The configuration panel is depicted in the screenshot below. 

    Image Added

    The three tabs to the left of the screen provide the following areas for configuration: 

    General Configuration

    • The Fedora Base URL is the path to the Fedora webapp on your Tomcat (or other) server. On a default installation, this will be http://localhost:8080/fedora; if your port or path were changed during installation, these will need to be corrected to reflect that.
    • The Root Collection PID is the Persistent Identifier fedora will use for your root collection. This may not need to be changed.
    • UUID PID Generation adds the option to generate Fedora object PIDs with v4 UUIDs.
  3. Install the Islandora Basic Collection Module.

    Note

    Once you've installed Islandora, remember to install the Islandora Basic Collection Module in order to begin interacting with Islandora. If you haven't activated the Islandora Basic Collection Module, you will not be able to use Islandora.

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. If you can not see the basic collection folder on your Islandora repository then something is wrong with the installation. Please retrace your steps.

Create a milestone 5 snapshot backup:

...