Versions Compared

Key

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

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 ]

Note

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.

Code Block
cd ~/ && mkdir workspace && cd ~/workspace

2.) Clone the git repo

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

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

Code Block
cd gobii.deploy.vagrant

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

Code Block
Vagrantfile
provision/setup.sh
Expand
titleScreenshot
Image Added

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

Code Block
vagrant up

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

Note

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