Installation from Virtual Box Image

Virtual Box Installation

An easy way to evaluate UCVM is to install a virtual box appliance on an existing computer. The user can access a version of UCVM running on Linux with all standard models installed.

A full installation of the UCVM platform is posted as a Virtual Box Appliance. This can be downloaded and imported into a Virtual Box application program, and UCVM will run in the Virtual Box, on your computer of choice. The following steps will enable you to download, install, and run the UCVMC Virtual Box Appliance.

Retrieve the Virtual Box Hypervisor

You will need to download and installed a Virtual Box Hypervisor onto your computer. You will need to get the right version. Free versions are available for Mac, Windows, and Linux. The Virtual Box application program is commercial software, developed and maintained by Oracle, but it is currently distributed free of charge:

• Virtual Box Download Site:

Install Virtual Box on Computer

Make sure virtual box is installed on your computer. The Virtual Box Application should start-up and give users options on how to install the UCVM appliance.

Download UCVM Appliance

Download two UCVM Files, the UCVMC_17_1.ova ( Warning 52Gb!), and an md5 sum file (small text file).

• UCVM Virtual Box Appliance - *.ova file (Large File - 53Gb)
• UCVMC Virtual Box Appliance MD5Sum File

Check the Downloaded .ova file

Check the downloaded .ova file. In a directory that contains both the .ova file and the .ova.md5 file.

• md5sum -c UCVMC_17_1.ova.md5 should return: "UCVMC_17_1.ova: OK"

Start Virtual Box on Local Computer

Start-up the Virtual Box Hypervisor application program

Import Appliance into Virtual Box

Use the Virtual Box menu item at top, lead you to import appliance option. Then, import the UCVMC ova file.

• Import the UCVMC_17_1.ova file. This can take an hour of time

Start UCVMC_17_1

Start the appliance. A Version of Ubuntu will boot. One account will exist (UCVM):

• User: UCVM
• password: scecucvm

First Usage

Once logged in, move to the ucvm_bin directory

• cd ucvm_bin
• ./bin/ucvm_query -f ./conf/ucvm.conf -m cvms < ./tests/test_latlons.txt

This should produce five lines of results like this:

-bash-4.2$ ./bin/ucvm_query -f ./conf/ucvm.conf -m cvms < ./tests/test_latlons.txt
Using Geo Depth coordinates as default mode.
 -118.0000    34.0000      0.000    280.896    390.000       cvms    696.491    213.000   1974.976       none      0.000      0.000      0.000      crust    696.491    213.000   1974.976
 -118.0000    34.0000     50.000    280.896    390.000       cvms   1669.540    548.000   2128.620       none      0.000      0.000      0.000      crust   1669.540    548.000   2128.620
 -118.0000    34.0000    100.000    280.896    390.000       cvms   1683.174    603.470   2130.773       none      0.000      0.000      0.000      crust   1683.174    603.470   2130.773
 -118.0000    34.0000    500.000    280.896    390.000       cvms   3097.562   1656.495   2354.105       none      0.000      0.000      0.000      crust   3097.562   1656.495   2354.105
 -118.0000    34.0000   1000.000    280.896    390.000       cvms   3660.809   2056.628   2443.042       none      0.000      0.000      0.000      crust   3660.809   2056.628   2443.042

Defining Shared Folder

To exchanged results between your computer, and UCVM running in the Virtual Box, you will need to define a shared folder that can be used to copy files into and out of the Virtual Box. Details on how to setup a shared folder are beyond this tutorial. Please see the Virtual Box manual pages for help creating a shared folder.