milestone 5 - 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 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:

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, 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

    

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.

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