Skip to content

Islandora-Labs/islandora_vagrant

Repository files navigation

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
  • Be sure to install a version of VirtualBox that is compatible with Vagrant
  • If upgrading from a previous version run bash 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

cantaloupe admin:

  • username: admin
  • password: admin

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 1.1.1
  • drush 6.3.0
  • jQuery 1.10.2

Run in a multiple VM configuration

To run this vm side by side with Islandora 8 or another VM with conflicting ports do the following.

To use this configuration, you must install two Vagrant plugins.

  # For more info https://github.com/dotless-de/vagrant-vbguest
$ vagrant plugin install vagrant-vbguest

  # For more info https://github.com/cogitatio/vagrant-hostsupdater
$ vagrant plugin install vagrant-hostsupdater

To start this as a second VM either:

  • set a enviroment variable ISLANDORA_VAGRANT_MULTIPLE_ISLANDORAS or
  • run the following command: ISLANDORA_VAGRANT_MULTIPLE_ISLANDORAS='TRUE' vagrant up

You will be asked to enter your local user password. When Vagrant stops running, Islandora 7.x will be available at http://33.33.33.10:8000.

$ ISLANDORA_VAGRANT_MULTIPLE_ISLANDORAS='TRUE' vagrant up

NOTE:

vagrant-hostsupdater will temporarily update the host machine's /etc/hosts file and remove it when vagrant is destroyed.

##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting.  Do not change this entry.
##
127.0.0.1       localhost
255.255.255.255 broadcasthost
::1             localhost
33.33.33.10  islandora  # VAGRANT: 67ed63b757392fOOc6a4e5Od8a6b6428 (default) / 7d727ed8-557g-4be8-9e13-589444a57754

Also note that each vm must be halted separately, from within the directories on the host where they were started with vagrant up.

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.