Shell
Clone or download
lutaylor Merge pull request #149 from DiegoPino/7.x-cantaloupe
Enables cantaloupe for Islandora modules that use IIIF
Latest commit 696766a May 1, 2018

README.md

Islandora Vagrant Build Status

Introduction

The is a development environment virtual machine for Islandora 7.x-1.x. It should work on any operating system that supports VirtualBox and Vagrant.

N.B. This virtual machine should not be used in production.

Requirements

  1. VirtualBox
  1. Vagrant
  • Important: be sure to install Vagrant version 2.0.3 or higher
  • If upgrading from a previus version run vagrant plugin update to avoid plugin issues
  1. git

Note that virtualization must be enabled in the host machine's BIOS settings.

Variables

System Resources

By default the virtual machine that is built uses 3GB of RAM. Your host machine will need to be able to support that. You can override the CPU and RAM allocation by creating ISLANDORA_VAGRANT_CPUS and ISLANDORA_VAGRANT_MEMORY environment variables and setting the values. For example, on an Ubuntu host you could add to ~/.bashrc:

export ISLANDORA_VAGRANT_CPUS=4
export ISLANDORA_VAGRANT_MEMORY=4096

The files involved will also exceed 10GB. Your host machine will need at least that much free storage.

Hostname and Port Forwarding

If you use a DNS or host file management plugin with Vagrant, you may want to set a specific hostname for the virtual machine and disable port forwarding. You can do that with the ISLANDORA_VAGRANT_HOSTNAME and ISLANDORA_VAGRANT_FORWARD variables. For example:

export ISLANDORA_VAGRANT_HOSTNAME="islandora.vagrant.test"
export ISLANDORA_VAGRANT_FORWARD="FALSE"

Use

  1. git clone https://github.com/islandora-labs/islandora_vagrant
  2. cd islandora_vagrant
  3. vagrant up

Connect

Note: The supplied links apply only to this local vagrant system. They could vary in other installations.

You can connect to the machine via the browser at http://localhost:8000.

The default Drupal login details are:

  • username: admin
  • password: islandora

MySQL:

  • username: root
  • password: islandora

Tomcat Manager:

  • username: islandora
  • password: islandora

Fedora: (Fedora Admin | Fedora Risearch | Fedora Services)

  • username: fedoraAdmin
  • password: fedoraAdmin

GSearch:

  • username: fedoraAdmin
  • password: fedoraAdmin

ssh, scp, rsync:

  • username: vagrant
  • password: vagrant
  • Examples
    • ssh -p 2222 vagrant@localhost or vagrant ssh
    • scp -P 2222 somefile.txt vagrant@localhost:/destination/path
    • rsync --rsh='ssh -p2222' -av somedir vagrant@localhost:/tmp

Environment

  • Ubuntu 14.04
  • Drupal 7.44
  • MySQL 5.5.49
  • Apache 2.4.7
  • Tomcat 7.0.55.0
  • Solr 4.2.0
  • Fedora 3.8.1
  • GSearch HEAD
  • PHP 5.5.9-1ubuntu4.17
  • Java 8 (Oracle)
  • FITS 0.10.1
  • drush 6.3.0
  • jQuery 1.10.2

Maintainers

Authors

Acknowledgements

This project was inspired by Ryerson University Library's Islandora Chef, which was inspired by University of Toronto Libraries' LibraryChef. So, many thanks to Graham Stewart, and MJ Suhonos.