# ROSE Compiler Framework/Virtual Machine Image V1

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

## How to use the 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.

## How was the virtual machine made
### Host Machine

We used Ubuntu 10.04 LTS as a host machine to create the virtual machine image.

### 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