avh-hub

Australian Virtual Herbarium Hub (avh-hub)

Grails application that provides UI and customisations to the ALA Biocache (Grails plugin) for http://avh.ala.org.au/.

Deploying a new version of avh-hub to Nexus

Before deploying a new version, check that the biocache-hubs dependency version is up to date in grails-app/conf/BuildConfig.groovy.

Travis-CI is used to deploy new versions of avh-hub to Nexus. This is done automatically by updating the version number in the application.properties file and pushing to GitHub.

Once the new version of avh-hub is deployed to Nexus, the version number in ansible-inventories needs to change. To do this, the version number must be changed in:

https://github.com/AtlasOfLivingAustralia/ansible-inventories/blob/master/avh.ala.org.au

If the biocache_hub_version is commented out then presumably it will use the most recent version it can find.

Deploying the current Nexus deployed version of AVH to a virtual machine

If you have not yet installed Ansible, Vagrant, or VirtualBox, use the instructions at the ALA Install README.md file to install those first for your operating system.

Then, to deploy AVH onto a local virtual box install use the following instructions:

$ cd gitrepos
$ git clone git@github.com:AtlasOfLivingAustralia/ala-install.git
$ (cd ala-install/vagrant/ubuntu-trusty && vagrant up)

Add a line to your /etc/hosts file with the following information, replacing '10.1.1.3' with whatever IP address is assigned to the virtual machine that Vagrant starts up in VirtualBox:

10.1.1.3 avh.ala.org.au

Then you can clone the ansible instructions and install it onto the given machine:

$ git clone git@github.com:AtlasOfLivingAustralia/ansible-inventories.git
$ ansible-playbook -i ansible-inventories/avh.ala.org.au ala-install/ansible/avh-hub-standalone.yml --private-key ~/.vagrant.d/insecure_private_key -vvvv --user vagrant --sudo

Deploying to AWS EC2 production server

After testing locally, the same ansible scripts can be used to deploy to the production server which is an AWS EC2 server.

Comment out any testing line for avh.ala.org.au in your /etc/hosts file and add the following line:

52.63.44.128 avh.ala.org.au

Then deploy to that machine using the following command, replacing "MY_USER_NAME" with your login username:

$ ansible-playbook --user MY_USER_NAME -i ansible-inventories/avh.ala.org.au ala-install/ansible/avh-hub-standalone.yml --private-key ~/.ssh/id_rsa -vvvv --sudo --ask-sudo-pass