sign in sign up
<<
Home , Binary file

SCEC Unified Community Velocity Model (UCVM) VirtualBox Installation Guide

Contact: Philip Maechling Email: [email protected]

Southern California Earthquake Center Why Use VirtualBox SCEC UCVM software is designed for use on computers using the Linux operating system. Linux is common on high-performance computer systems where many UCVM users work.

UCVM is distributed as source code, and users are expected to compile the software on their system. Several software utilities must be available on the Linux system (e.g. automake, GNU , Python 2.7) for UCVM to compile and run.

The process of installing UCVM on a system is a significant barrier for many users, particularly users interested in evaluating the software to determine whether it will be useful in their research.

For the SSA 2019 CVM workshop, we have created a VirtualBox image (aka appliance file) that contains the most recent version of UCVM to help users run UCVM on their computers without needing to compile it. Advantages/Disadvantages of Using a VirtualBox Distribution of UCVM Advantages: (1) UCVM can be run on computers that use Linux, Mac, and Windows. (2) The UCVM Image file provides access to a pre-compiled version of the software.

Disadvantages: (1) Users must install the appropriate version of VirtualBox on their computer. (2) Users must download a large (~18GB) file onto their computer. (3) Users must import the UCVM image file into their VirtualBox environment. (4) It can be difficult to transfer files into, and out of, the VirtualBox environment.

Summary: The UCVM VirtualBox installation is very helpful for testing and evaluation of UCVM. However, if UCVM is useful in their research, users will then typically compile and run the software on a Linux computer without use of the VirtualBox environment. Outline of UCVM VirtualBox Installation Process

Computer Requirements: 1. To install and run the UCVM VirtualBox software, the target Laptop (or other computer) should have minimum of 8GB RAM and 60GB disk storage available

Steps to Installing UCVM include: 1. Retrieve the appropriate (Windows, Mac, or Linux) version of VirtualBox 6.0 or later, from Oracle at: https://www.virtualbox.org/wiki/Downloads 2. Install VirtualBox on the laptop 3. Retrieve the UCVM image file (called ucvm_ssa_2019.ova (18GB)) from: https://scec.usc.edu/scecpedia/SSA_Velocity_Model_Workshop_2019 5. Start VirtualBox on the laptop 6. Import the UCVM image file (appliance) into the VirtualBox. 7. Start the ucvm_ssa_2019 image in VirtualBox. Outline of UCVM VirtualBox Installation Process

1. Retrieve the appropriate (Windows, Mac, or Linux) version of VirtualBox 6.0 or later, from Oracle at: https://www.virtualbox.org/wiki/Downloads

Users should select the VirtualBox software based on the operating system of their laptop. If you want to install UCVM on a Mac laptop, download the OS X version of VirtualBox. If your laptop runs Windows, download the Windows hosts version. Outline of UCVM VirtualBox Installation Process

2. Install VirtualBox on the laptop

On a Mac, the VirtualBox installation screen looks like this. Double click on this icon to install VirtualBox on the Mac. Outline of UCVM VirtualBox Installation Process 3. Retrieve the UCVM image file (called ucvm_ssa_2019.ova (18GB)) from: https://scec.usc.edu/scecpedia/SSA_Velocity_Model_Workshop_2019

The UCVM Image File is posted on a SCEC server. Click this link to download the large binary file. It may take more than 1 hour depending on your network connection. Outline of UCVM VirtualBox Installation Process

5. Start VirtualBox on the laptop

Once installed, VirtualBox will appear as an application program under the Mac Launchpad.

On a Mac, after installation, the VirtualBox software shows up in the Launchpad screen, and can be run by double clicking it. Outline of UCVM VirtualBox Installation Process

5. Start VirtualBox on the laptop

When the VirtualBox software starts it will display a screen like this. Outline of UCVM VirtualBox Installation Process

6. Import the UCVM image file (appliance) into the VirtualBox.

From the VirtualBox File menu, select Import Appliance. Outline of UCVM VirtualBox Installation Process

6. Import the UCVM image file (appliance) into the VirtualBox.

Click on this folder icon, and browse to the location of the ucvm_ssa_2019.ova file on your local computer. Outline of UCVM VirtualBox Installation Process

6. Import the UCVM image file (appliance) into the VirtualBox.

VirtualBox will in the file and display information about it. Click the Import button to start the import process. It may take 20—30 minutes for VirtualBox to read in the file. Outline of UCVM VirtualBox Installation Process

7. Start the ucvm_ssa_2019 image in VirtualBox

Click on the ucvm_ssa_2019 in the VirtualBox panel, then click Start ”arrow” from the top menu. Outline of UCVM VirtualBox Installation Process

As the VirtualBox boots the UCVM Image File, it displays a Linux screen. The system will automatically start the first Linux image shown, which is the correct image for the workshop. Outline of UCVM VirtualBox Installation Process

As the system boots, you may see this informational display. You can click on this X to clear this information box. Outline of UCVM VirtualBox Installation Process

Click on this user: SCEC Researcher to login into the VirtualBox. There is no password for this account. Outline of UCVM VirtualBox Installation Process Once UCVM is running in the VirtualBox and you are logged in, VirtualBox will display a Linux (gnome) desktop. UCVM is ready to use.

Click on the terminal icon to start a Linux command line terminal window, where you can issue UCVM commands. Outline of UCVM VirtualBox Installation Process

Users can confirm the UCVM software is running correctly by running unit tests included in the distribution.

(1) a terminal window, and type these commands at the command line prompt. (don’t type the dollar sign) (2) $ cd ucvm194/tests (3) $ ./unittest

(4) You should see the display at left, showing a series of tests run and passed. Outline of UCVM VirtualBox Installation Process When you are done running UCVM, you can quit Virtual Box from the top, drop- down menu

Select this Quit VirtualBox menu item to shutdown the VirtualBox.

Select Power off the machine, then click the Ok button. www.SCEC.org