View source for BBP 15.3.0 Virtual Box Image

== Overview ==

In this page, you will find information about setting up Virtual Box, and downloading and using the SCEC BBP 15.3.0 Virtual Box image. We are distributing the software this way to make it easier for researchers to install and use the SCEC Broadband Platform on their own computers. SCEC is using Virtual Box technology to make it easy to run scientific software designed for Linux and Mac computers to be run on a variety of personal computers. Virtual Box provides a way to run Linux/Mac-based software on Linux, Mac, and Windows computers.

The following information describes how to download Virtual Box and then download and install the SCEC BBP software on your own computer.

== Terminology ==

Here are a few terms that might be used when working with Virtual Box.

* Host operating system
** The host operating system is the software on your laptop. If you are using a Mac, your host operating system will probably be some version of OS X. If you are using Windows, your host operating system will probably be some version of Windows 7 or 8. If you are using Linux, your host operating system will be some distribution of Linux, such as Ubuntu, Fedora, etc.

* Guest Operating system
** The guest operating system is the version of Linux that runs inside the Virtual Box. For the BBP 15.3.0 Image, the guest operating system will be Linux Fedora 14.x. We selected Linux as the guest operating system as currently some of the scientific methods on the BBP 15.3.0 package only run correctly on Linux.

* Image 
** An image is a large file, like a tar file, that contains both the guest operating system, and the seismological applications software. SCEC has collected the software, and created an image, and posted the image online. Users download the image, load the image into Virtual Box, and all the software will be available for immediate use. An image behaves like a standalone computer, once the image is installed and started inside Virtual Box. 

== Computer Requirements ==

We have tested the Virtual Box, and our SCEC software image in the following computer configurations. If you wish to run the BBP 15.3.0 Image, your computer should have the following capabilities.

* Mac OS or Windows 7 or Windows 8
* 50GB Disk space available

== Downloading Virtual Box ==

The first step is to download the Virtual Box software from Oracle. This software is free to use. You must retrieve a version that is appropriate for the Host Operating system of the computer you want to use. If your laptop runs Mac OS X, then retrieve a version of Virtual Box for Mac OS X. If your laptop runs Windows 8, retrieve a version of Virtual Box for Windows 8. We have tested the SCEC BBP 15.3.0 Image with Virtual Box Version 4.3.28 and higher.

*[https://www.virtualbox.org Oracle Virtual Box Software]
*[https://www.virtualbox.org/wiki/Downloads Downloads Page]

== Installing Virtual Box ==

Follow the Virtual Box installation instructions and install Virtual Box on your computer. The installation procedure varies slightly based on the operating system you are using. It may require administrator permissions to install virtual box on some computers.

*[https://www.virtualbox.org/manual/UserManual.html Virtual Box Users Manual]

== Downloading BBP 15.3.0 Virtual Image ==

Users should download the SCEC BBP 15.3.0 Virtual Image from the SCEC website. Currently, the BBP 15.3.0 image is about 17GB in size so that it may take a few minutes to hours to download depending on the speed of the available network connection. You can download the image from the link below:

*[http://hypocenter.usc.edu/research/bbp/versions/15.3.0/SCEC_BBP_15.3.0.ova SCEC_BBP_15.3.0.ova]

== Importing the SCEC BBP Image into Virtual Box ==

To load the SCEC BBP 15.3.0 Image into Virtual Box, just follow the steps below:

# On your laptop, start up Virtual Box. 
# From the Virtual Box top menu selection, select File. A drop down menu list should appear. 
# From this list select  "Import Appliance"
# Select the file folder icon, to bring up a file browser. Browse to the ERI virtual Box image you have downloaded.
# Select Okay

Virtual Box will now read in your image. This may take minutes to hours depending on the speed of your computer and disk space available.

 Don't forget to delete the original downloaded file now in order to reclaim the disk space. The file is no longer needed after Virtual Box imports the image.

== Related Entries ==

*[[Broadband Platform]]