This documentation refers to an earlier version of Islandora. is current.

In this section (Option 1) we divided the installation into a very specific sequence of milestones, which enable the Islandora Minimum Viable Functionality, which is the core set of modules and dependencies needed to have  a functional installation of Islandora.

These milestones help ensure that pre-requisites for subsequent steps are always met and tested before hand.

Other Installation Options

  • Sandbox : not really an install, but more ready to use Islandora space on the web that you can use to test Islandora
  • Virtual Machine : pre-packaged virtual computer system that runs on your local machine. You need to have a Virtualization Software to "host" / "run" the Virtual Machine.
  • Local install : download an install the individual pieces required to use Islandora on your local machine. Requires various degrees of System Administration experience, depending on your operating system.
  • Drush : a command line shell and scripting interface for Drupal that we highly recommend for installation and development for Islandora. Installations instructions for multiple platforms are provided on the Drush github page.

"Local install" - Pre-installation Software Checklist

Server Dependencies

The following resources must be present on the server where you plan to install Islandora. Each of these items is detailed in the relevant section of the installation process; this is merely meant as a quick checklist to review the overall set of resources you may have to install on your server:

  • PHP 5.3 (minimum)
  • PHP5-curl
  • PHP-soap 
  • Apache web server.
  • relational database management system (MySQL recommended)  
  • Java SE Development Kit (JDK) 6/7 
  • A storage application server. Fedora includes the Tomcat Application Server.   

    "LAMP" stack

    As a point of reference, having the combined installation of Apache, MySQL, and PHP under  Linux, is called a "LAMP" stack. You should consider this one-step-install-all procedure on Ubuntu 12.04LTS:

    sudo tasksel install lamp-server

    This will prompt you for a MySQL password for root. Enter it twice.

    For Ubuntu 14.04LTS follow these instructions:

    "How To Install Linux, Apache, MySQL, PHP (LAMP) stack on Ubuntu 14.04"

Components and Module Versions

Please see the Supported Versions section of the Release Notes and Downloads page.

Do not mix and match different versions of modules or components.


"Local install" - Installation Instructions Overview

An important aspect of the installation is for the person doing it to understand how all the moving parts fix together. The illustration below shows all the typical Islandora developed components in red. The other supporting components/applications are represented in other colors. However we overload the term "Islandora" to represent the whole repository solution stack.

The next few sections will lead you through the installation of Dependencies, Drupal, Fedora, and the Islandora Module. These instructions assume an *nix environment. Our current Windows support status is available here. The arrangement in Milestones is designed so that you are advised to perform a snapshot backup at the end of each milestone. This way if the step you are working on fails to install and test properly you'll have something to fall back on, without having to restart from scratch. You may do the snapshot backup just by stooping all the services and creating a tarball of the directory trees target of the installation (more details on each milestone).


Islandora Diagram

  • No labels