Self-Contained GOBii Data Manager (scGDM)

Owned by Roy Petrie
Last updated: Jun 02, 2020
6 min read

This version of GDM was created on a Ubuntu system and should be able to be deployable to most Virtualbox and Vagrant versions for your systems. If there are deployment issues please reach out to @Roy Petrie [ rlp243@cornell.edu ]

Prerequisites

Minimum System Hardware Recommendations:

  • CPU: 4 Cores

  • Memory (RAM): 8 GB

  • Storage: 100 GB ( At deployment time the virtual machine will use 23 GB but has a dynamic disk that can use up to 100 GB )

  • Image Size: 11.8 GB ( The image that is downloaded from the vagrant repository. Please make sure you have a constant network connection to download this image. )

The requirements specified as the MINIMUM hardware requirements suggested for this system. The deployment is defaulted with 2 vcpus & 2GB RAM.

Software Requirements

Virtualbox [ Download ]

This is the virtual software used to host the virtual machine.

  • Ubuntu Version: 5.2.34_Ubuntu r133883

Vagrant [ Download ]

This software uses an image repository for the automated Virtual Machine creation.

  • Ubuntu Version: Vagrant 2.0.2

Git [ Windows Download ]

This is the software used to clone the repository.

  • Ubuntu version: git version 2.17.1

Please verify you have completed the above requirements fully before attempting to deploy scGDM on your local machine.

Steps to Deploy scGDM

Please note: These steps have been created using a Linux Ubuntu system and are planned to be expanded for Mac & Windows Users.

1.) Create a workspace that can be used to host the repository. In this the location ~/workspace directory will be used. This location can exist anywhere but please make sure to notate its location.

cd ~/ && mkdir workspace && cd ~/workspace

2.) Clone the git repo

git clone https://bitbucket.org/gobiiproject/gobii.deploy.vagrant.git

3.) Change directories into gobii.deploy.vagrant/

cd gobii.deploy.vagrant

4.) Within this location there are 2 files you should see:

5.) Run the following command within the gobii.deploy.vagrant directory:

At this point vagrant will start a download of the image within the vagrant cloud repo.

This process can take some time to complete depending on network speeds!

The output for this command should show the following:

6.) Toward the end of the output please reference the following sections:

7.) The line specified as:

should be added to your /etc/hosts file for easier access to this VM when using the browser. Otherwise as notated in the second box the links you will access will use the 192.168.0.XXX address notated toward the end of the vagrant up command.

8.) Access the GOBii Extractor at:

scgdm.gobii.org:8081/gobii-dev

or

192.168.0.XXX:8081/gobii-dev