Islandora Vagrant Base Box

Introduction

This is a base box for Islandora Vagrant, and an export box lives on atlas.

The virtual machine that is built uses 3GB of RAM. Your host machine will need to be able to support that.

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

Requirements

1. VirtualBox
2. Vagrant
3. git

Use

1. git clone https://github.com/islandora-labs/islandora_vagrant_base_box
2. cd islandora_vagrant_base_box
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

Customization

If you'd like to add your own customization script (to install additional modules, call other scripts, etc.), you can create a custom.sh file in the project's scripts directory. When that file is present, Vagrant will run it after all the other provisioning scripts have been run.

Custom base box

To create a custom base box to use with Atlas (e.g., if you need different versions of Solr, Fedora, Java, etc.) the basic steps are as follows:

• Clone the repo
• git clone https://github.com/Islandora-Labs/islandora_vagrant_base_box
• cd islandora_vagrant_base_box
• Customize the provisioning scripts as necessary (Make note of the VM name)
• Provision the VM
• vagrant up
• Export the VM to a box file
• vagrant package --base <VM NAME>
• Upload the box file to Atlas using the web interface or otherwise

Maintainers

• Don Richards
• Ben Rosner

Authors

• Nick Ruest
• Jared Whiklo
• Logan Cox
• Kevin Clarke
• Mark Jordan

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.