Note that this documentation is for the old 5.3 release.
For the newest documentation, please see the current release documentation.

Quickstart with Vagrant

Owned by Colin Samuel Rosenthal
Sept 19, 2017

The fastest way to get started with NetarchiveSuite is to use the NAS Vagrant Quickstart. The latest Vagrant setup for NAS can be obtained by downloading the contents of the directory  https://github.com/netarchivesuite/netarchivesuite/blob/master/quickstart-vagrant-environment/Vagrantfile .

Using Vagrant

For those unfamiliar with Vagrant, first install vagrant itself as follows:

Then on command-line, change directory to the location of the downloaded Vagranfile and run the initialisation script e.g.

./run-vagrant.sh

to run the latest release, or 

./run-vagrant.sh -bmaster

to run the latest bleeding-edge commit from github.

The output from the run-vagrant.sh is written in the file vagrant-up-output.txt. At the end of the file you will find something like 

==> default: ----------------------------------------------------------------
==> default: You can TEST the NetarchiveSuite installation in a browser with:
==> default: http://vagrant-netarchivesuite:8074/HarvestDefinition/
==> default: This may only work once you've done the following:
==> default:    On this machine, add the following line:
==> default:       192.168.64.128 vagrant-netarchivesuite
==> default:    To the file /etc/hosts

Just follow the instruction to add the vagrant host to /etc/hosts and you should have a fully-functioning NetarchiveSuite instance available at the specified url. 

To take down the running Vagrant virtual machine, do a 

vagrant destroy