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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

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"

 

There are 3 essential modules, and they are part of the components that give the Islandora Solution Stack core functionality

  • Islandora Prime module
  • Islandora Basic Collection Solution Pack
  • Basic Image Solution Pack

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 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).

2. 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)

3. You have the Tuque library properly installed:

 

Solution Pack Dependencies

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

Installing the Islandora Prime module

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

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:

    Unzip 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

 

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. 

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.


    Once you've installed the Islandora Prime Module, remember to install the Islandora Basic Collection Solution Pack and at least the Islandora Basic Image Solution Pack in order to begin ingesting some images with Islandora. Otherwise you will not be able to interact with the Islandora solution stack.

Installing the Islandora Basic Collection Module.

Installing the Islandora Basic Image Solution Pack

 

 

 

At the end of this installation, you will be ready to populate your site with digital assets (images) for testing purposes, and be capable of further enhancing its functionality by installing other 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:

# $FEDORA_HOME/tomcat/bin/shutdown.sh
# /etc/init.d/mysql stop
# /etc/init.d/apache stop

# cd /usr/local 
# tar -cvzf fedora-milestone5.tar.gz fedora

# cd /var/lib 
# tar -cvzf mysql-milestone5.tar.gz mysql

# cd /var/www
# tar -cvzf drupal-milestone5.tar.gz drupal

# /etc/init.d/mysql start
# $FEDORA_HOME/tomcat/bin/startup.sh
# /etc/init.d/apache start
  • No labels

For more information please visit https://islandora.ca