We have provided a few ways for you to use Nettle. Depending on your needs, please follow the appropriate instructions below.

Fully Packaged Virtual Machine

This is the easiest option if you just want to try out Nettle with minimum hassle. All required software and auxiliary files have been pre-installed in an Ubuntu virtual machine that you can run using the free VirtualBox software.

  1. Install VirtualBox by following the instructions here.
  2. Download our virtual machine by clicking here.
  3. Launch VirtualBox and choose File -> Import Appliance.
  4. Startup the machine. There is a single account `nettle` with password `nettle`.
  5. This account is set up with:
    • Nettle software. To update this software to the latest released version, simply do:

      cabal update nettle-openflow
      cabal update nettle-frp
    • The Netkit software, which can be used to create virtual networks. Note that Netkit is a virtualization tool, installed within the Ubuntu virtual machine, which is running on your physical host machine.
    • The directory ~/.nettle, which contains additional files needed to run examples.
  6. Now read the documentation for using the Nettle software.

Installing on Your Own Machine

  1. If you don’t already have Haskell, please install it by following the instructionshere
  2. Install the nettle libraries by doing:

    cabal install nettle-openflow
    cabal install nettle-frp
  3. You can now use Nettle on your OpenFlow network. If you don’t have OpenFlow routers, and want to test out Nettle in a virtualized environment, we recommend Netkit. Install Netkit:
    • First follow the instructions here.
    • Apply patch to file /bin/script_utils. On line 271, replace the double equal sign `==` with a single equal sign `=`.
    • Apply another patch to file /bin/vstart. On line 536, add `eval` to the beginning of the line.
  4. To use the Netkit examples distributed with Nettle, you will also need a filesystem we provide. You can get this by clicking here. Then do:

    tar xSjf dot-nettle.tar.bz2
    mv dot-nettle ~/.nettle

    It is very important to use the S option to `tar`. Also, we assume the `mv` command does not cross disk partitions. Else, you will lose the sparsity of the filesystems contained in this directory, greatly increasing the required disk space. If necessary use `cp –sparse=always`.

Comments are closed.