Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The fastest way to get started with NetarchiveSuite is to use the NAS Vagrant Quickstart. The latest Vagrantfile Vagrant setup for NAS can be downloaded directly from source at 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 and run the initialisation script e.g.

Code Block
vagrant init ubuntu/precise64
vagrant destroy -f; vagrant up

If you have more than one network on your host machine (like wired and also wireless), you may be asked to choose between them during the vagrant up.

At the end, the 'vagrant up' should output the URL to the NAS GUI. Insert this URL in a Firefox browser to test the system.

...

./run-vagrant.sh

to run the latest release, or 

Code Block
./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 

Code Block
==> 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

Code Block
vagrant destroy

...