ROSE Compiler Framework/Virtual Machine Image V1

This page is obsolete. We have a newer VM described at ROSE Compiler Framework/Virtual Machine Image

Obtain the Virtual Machine Image
Download the virtual machine image created by using VMware Player:
 * http://www.rosecompiler.org/Ubuntu-ROSE-Demo.tar.gz
 * Warning: it is a huge file of 4.8 GB.
 * Demonstration user account (sudo user in Ubuntu):
 * account: demo
 * password: password

Warning: LLNL users may not be able to download it due to limitations to max downloaded file size within LLNL. It may also be against LLNL's security policy to run a virtual machine without authorization. So this image should not be used inside LLNL.

Content of the VM Image
Copy&paste from README within the virtual machine

This is a virtual machine image for the ROSE source-to-source compiler framework.

sourcetree, cloned from github.com/rose-compiler/rose on July 21, 2012
 * /home/demo/rose

buildtree
 * /home/demo/buildrose

installation tree (--prefix path)
 * /home/demo/opt/rose-inst

A script to set environment variables to use the installed ROSE tools
 * /home/demo/set.rose.env

A test translator: with example Makefile
 * /home/demo/myTranslator

Some dot graphs of a simplest function. Type "run.sh file.dot" will view a dot file
 * /home/demo/dotGraphs

Install VMware Player
You have to install VMware Player to your machine to use the virtual machine image.

Goto http://www.vmware.com/go/downloadplayer/

Select the right bundle for your platform. For example: VMware-Player-4.0.4-744019.i386.txt

After downloading (assuming you are using Ubuntu 10.04)
 * chmod a+x VMware-Player-4.0.4-744019.i386.txt
 * sudo ./VMware-Player-4.0.4-744019.i386.txt
 * follow the GUI to finish the installation

To start VMPlayer, goto Menu->Applications-> System Tools -> VMware Player

Open/Play the virtual machine
After downloading and untar the tar.gz package to a directory, use VMware player to open the configuration file of the directory.

Host Machine
We used Ubuntu 10.04 LTS as a host machine to create the virtual machine image. uname -a Linux 8core-ubuntu 2.6.32-41-generic-pae #91-Ubuntu SMP Wed Jun 13 12:00:09 UTC 2012 i686 GNU/Linux

cat /etc/*release DISTRIB_ID=Ubuntu DISTRIB_RELEASE=10.04 DISTRIB_CODENAME=lucid DISTRIB_DESCRIPTION="Ubuntu 10.04.4 LTS"

Configurations
VMware player has been installed onto the host machine, as described above.

Basic configuration for the virtual machine

Hardware
 * Memory : 2 GB
 * Processors: 2
 * Hard Disk size: 15 GB: We would like to keep it small while having enough space for users.
 * 5GB is used for Ubuntu system files and
 * 10GB for the demonstration user's home directory
 * Network Adapter: NAT: share the host's IP address

OS
 * OS: Ubuntu 10.04 LTS
 * Demonstration user account (sudo user in Ubuntu):
 * account: demo
 * password: password
 * screen size: 1280x960 (4:3)

Download Ubuntu 10.04 LTS http://releases.ubuntu.com/lucid/ We currently use the i386 desktop ISO as the start point
 * http://releases.ubuntu.com/lucid/ubuntu-10.04.4-desktop-i386.iso

Within the virtual machine
We installed Software Prerequisites
 * sudo apt-get install gcc g++ gfortran
 * sudo apt-get install autoconf automake libtool
 * sudo apt-get install git bison flex texlive-full graphviz python-all-dev

We then installed ROSE
 * See ROSE installation for details about how this was done.

How to create a new virtual image
Here are some general guidelines for creating a new virtual machine. Following these exact steps are not required, although they are recommended to ensure a consistent user experience with the ROSE VM's.

Please make sure you document the whole process in its entirety.

These steps must be performed within the VM (guest OS):

1. Install the prerequisite software using the platform's software package manager. Only as a last resort should you manually install software. Use the platform's default software versions if possible. (Use bash as the default login shell.)

2. Setup the ROSE workspace

3. Clone the ROSE repository as src

4. Configure, build, and install ROSE

5. Verify ROSE installation works

6. Create simple demo translator(s) in $ROSE_HOME/demo