Skip to content

Setup ~ VM

Jump to bottom Edit New page
Vlad Ureche edited this page Aug 5, 2015 · 28 revisions

In this section we describe the steps required to run the ildl-plugin demo virtual machine.

Requirements

The following minimum specs are necessary for the virtual machine:

  • 10 GB hard-drive space (compressed VM has 3GB, decompressed 6GB)
  • 8 GB of RAM (the VM requires 4GB of RAM, if you can't afford that much, it will also work with 3GB, but you need to adjust it in the VMware Player: from the menu bar, choose Virtual Machine, then Virtual Machine Settings and Memory)

Downloading

A word of warning:

We strongly recommend replicating the benchmarks directly on the host machine or in the 64-bit virtual machine. We tried to replicate the benchmarks in a 32-bit virtual machine but were unable to, most likely due to the 32-bit system architecture and the overhead of virtualization.

The demo virtual machines are available using these alternative links:

64-bit Virtual Machines

Version 1.0

URLs:

md5sum  42d0f96a0a500b9f848f28f5211be96a 
sha1sum af5af33237d7e2387304e323b5a463e98e399fae

32-bit Virtual Machines (not recommended)

Version 1.3

URLs:

The hash code for the vm archive is:

md5sum  0fd04b2281cbb441352d8ebfc8346635
sha1sum 6d733b797cc0cbe1a905758b4897a93793eea946

Version 1.2 (old, not recommended)

URLs:

The hash code for the vm archive is:

md5sum  9c573cb37ef13add778c9808146512ec
sha1sum e54876412f878db49c08b7a4c204627d4a16faae

Version 1.1 (old, not recommended)

URLs:

The hash code for the vm archive is:

md5sum  5a80dad200d5efdc0bf2805f221eb6d9
sha1sum e99936c9e7be7d3c0a3f25d36004f9175f2c800a

Version 1.0 (old, not recommended)

URLs:

md5sum  fe1e6ee14125fe749137303c1f881edb  iLDL-VM-v1.0.tar.gz
sha1sum 7dac9136e94226d99aaa9c0e164820369eb6bd2f  iLDL-VM-v1.0.tar.gz

After downloading and checking the hash, please expand the .tar.gz archive.

Installing VMware Player

To start the virtual machine you need the VMware’s VM Player. It is free and can be downloaded from VMware’s website. The installation should be self-explanatory.

Starting the Virtual Machine

Once VMware Player is installed, you should be able to Open and Play the virtual machine:

Virtual Machine Screenshot

In the virtual machine, open the Tutorial directory and double-click the [[Step by step guide|OOPSLA-~-Step-by-step]]. This is a wiki page that will guide you through exploring the artifact source code, the benchmarks and the transformation. You will be able to explore the artifact in the ScalaIDE, allowing you to navigate easily.

In the Links directory, you will find three links:

  • a link to the workspace, with the following projects:
  • a link to the ScalaIDE with all the projects set up
  • a link to a Terminal, where you can run the ildl-scalac and ildl-scala scripts (you will use them throughout the project exploration)

The README file on the desktop contains some more information about the setup.

Please note that the virtual machine does require an Internet connection to access maven repositories.

To make sure everything runs as expected, open a Terminal window and type cd Workspace/ildl-plugin/ and sbt test:

$ cd Workspace/ildl-plugin/
$ sbt test
...
Compiling benchmark-lazylist.scala                                     ... [ OK ]
Compiling bridges-1-repr.scala                                         ... [ OK ]
Compiling bridges-2-reprs.scala                                        ... [ OK ]
Compiling coerce-complex-1.scala                                       ... [ OK ]
Compiling coerce-complex-2.scala                                       ... [ OK ]
Compiling coerce-simple.scala                                          ... [ OK ]
Compiling constructors.scala                                           ... [ OK ]
Compiling error-high-1.scala                                           ... [ OK ]
Compiling error-high-2.scala                                           ... [ OK ]
Compiling error-high-3.scala                                           ... [ OK ]
Compiling extensions-basic-implicit.scala                              ... [ OK ]
Compiling extensions-basic.scala                                       ... [ OK ]
Compiling extensions-generic-implicit.scala                            ... [ OK ]
Compiling extensions-generic.scala                                     ... [ OK ]
Compiling feature-high.scala                                           ... [ OK ]
Compiling freestyle-1.scala                                            ... [ OK ]
Compiling freestyle-2.scala                                            ... [ OK ]
Compiling freestyle-3.scala                                            ... [ OK ]
Compiling hamming-issue.scala                                          ... [ OK ]
Compiling inject-accessors-2.scala                                     ... [ OK ]
Compiling inject-accessors.scala                                       ... [ OK ]
Compiling scopes-collaborating-2.scala                                 ... [ OK ]
Compiling scopes-collaborating.scala                                   ... [ OK ]
Compiling scopes-conflicting-cascade.scala                             ... [ OK ]
Compiling scopes-conflicting-repr.scala                                ... [ OK ]
Compiling scopes-conflicting-same-high.scala                           ... [ OK ]
Compiling scopes-nested.scala                                          ... [ OK ]
Compiling scopes-pickling.scala                                        ... [ OK ]

  28 tests ran, all good :)

Congratulations, you just ran the ildl-plugin test suite!

From Here:

ildl wiki The `ildl-plugin` is a meta-programming technique aimed at allowing safe, custom transformations across library boundaries. Using `ildl`-based transformations, we were able to obtain speedups in excess of 20x and have optimized code across a wide range of use-cases.
**Return to the main page** or **return to the OOPSLA Step by Step Guide**
Frog Work Ahead: Some of the pages of this wiki are in flux. If you can't find what you are looking for, please [file a bug](https://github.com/miniboxing/ildl-plugin/issues).
Clone this wiki locally