Vireo Development Vagrants

These vagrants are to provision a virtual machine with Vireo and all its dependencies installed. Vireo will not be deployed in Tomcat, it will be manually started via maven spring-boot for development purposes. The vagrant will be running Vireo on port 9000, which must be available. The available operating systems for the guest virtual machine are all linux distributions; oracle, centos, and ubuntu. In order to develop using theses vagrants, please have the following prerequisites installed.

centos currently not working for Windows host machines

Prerequisites

Install the following software.

1. git
2. vagrant
3. virtual box
4. eclipse

Setup

Add the following required vagrant plugins.

1. vagrant plugin install vagrant-vbguest

Provision Virtual Machine

Follow these instructions to provision the Vireo virtual machine.

1. git clone https://github.com/TexasDigitalLibrary/Vireo-vagrant.git
2. cd Vireo-vagrant
3. select desired operating system for the guest virtual machine: oracle, centos, or ubuntu -> [os]
4. cd [os]
5. vagrant up (this will take a while)

Start Vireo

Follow these instructions to start Vireo. Windows must use a shell with an SSH client, such as Git BASH, MINGW, etc. Alternatively have OpenSSH client installed or SSH in using PuTTY on port 2200, username vagrant, password vagrant.

1. navigate to Vireo-vagrant/[os] directory
2. vagrant ssh
3. cd Vireo
4. mvn clean spring-boot:run

Open Vireo

Test Vireo in the browser.

1. http://localhost:9000

Develop Vireo

Import Vireo project into Eclipse

1. open Eclipse
2. open File menu
3. select Import
4. open Maven
5. select Existing Maven Projects
6. click Next
7. navigate to the Vireo-vagrant directory
8. navigate further to the [os]/src/Vireo directory
9. click Open (should see the Vireo project)
10. click Finish
11. develop on Vireo

https://gist.github.com/jeremythuff/ff068285554d0556d52478bb002b8b8a