type: Development

traffic-light: green

target-close-date:

actual-close-date:

affected-group: FEIT

deliverables: Scripts to provision a preview of Omeka-S

AUTO-OMEKA-S

A collection of scripts which generate a base Centos 7 "box" file for Vagrant, then provision this image into an Omeka installation using Vagrant and Ansible.

Who is this for?

People and organisations who want to make a rich collection of linked data accessible via the world-wide web. Particularly those who would like to have canonical URIs for item data such as places, subjects and so on.

NB: This is a preview (alpha) release and is not considered suitable for production use. Please report Omeka bugs (there will be bugs!) at https://github.com/omeka/omeka-s

Prerequisites:

You'll need the following software installed on your local system:

• Git - http://git-scm.com/downloads
• Virtualbox - http://www.virtualbox.org/
• Vagrant - http://vagrantup.com/
• Ansible - http://www.ansible.com/

Installing Ansible

Installation instructions for Ansible can be found at http://docs.ansible.com/ansible/intro_installation.html and official packages are available for many Linux and UNIX flavours.

For OSX see http://docs.ansible.com/ansible/intro_installation.html#latest-releases-on-mac-osx which basically boils down to opening Terminal and entering:

$ sudo easy_install pip

Then for OSX 10.9 and earlier:

$ sudo pip install ansible

Or for OSX 10.10 (Mavericks):

$ sudo CFLAGS=-Qunused-arguments CPPFLAGS=-Qunused-arguments pip install ansible

Vagrant requires the vagrant-vbguest plugin; it will install this by itself.

Now clone the Omeka scripts:

$ git clone https://github.com/ozmeka/auto-omeka-s.git

$ cd auto-omeka-s/vagrant

$ cp provisioning/group_vars/all.yml-dist provisioning/group_vars/all.yml

You can review configuration options and alter them if necessary in the provisioning/group_vars/all.yml file.

Launch the VM

$ vagrant up

This will start the provisioner, which will automatically download a Centos 7 base box for Vagrant. After that, it will install Omeka S automatically, which can take some time in the last step of initialising the web app.

Once the provisioning script has completed, point your browser at http://localhost:8080/ and set up Omeka.

To shut down the VM when you're finished, use $ vagrant halt. You can also use $ vagrant suspend to pause it. If you made an awful mess of it and want to start again from scratch, $ vagrant destroy will give you a blank slate. To bring the VM back up in all these cases, simply issue $ vagrant up.