--------------------------------------------------------------
DIFFUSE for OpenWRT: VirtualBox VMs (released 13th April 2012)
--------------------------------------------------------------

This document is part of DIFFUSE for OpenWRT:
http://caia.swin.edu.au/urp/diffuse/
http://caia.swin.edu.au/urp/diffuse/openwrt/

It provides instructions for setting up the VirtualBox Virtual Machines that are
pre-configured with the OpenWRT build system and include all DIFFUSE sources.

see also: 
http://http://caia.swin.edu.au/urp/diffuse/downloads/DIFFUSE-Build-Firmware-howto.txt

You will need to install Oracle VirtualBox: http://www.virtualbox.org

INTRODUCTION
------------

We have prepared two VMs for building OpenWRT Firmware images and packages
for DIFFUSE. Both are based on OpenWRT Attitude Adjustment revision 29537.

The "DiffuseWRT-Light" VM has all the source files required, but has not yet been
built. This option provides a smaller download, but compiling OpenWRT for
the first time may take an hour.

The "DiffuseWRT-Build" VM has had OpenWRT already built, which means that building 
new firmware will be faster the first time (the trade off being a larger download).

Otherwise the VMs are identical.


VM DETAILS
----------

The VM is based on a Ubuntu Server 10.04 LTS 32-bit release. The VMs were created
and tested using VirtualBox 4.1.12.

Base memory for the VMs is 1024MB (1GB). Make sure that you have plenty of 
RAM on the host system.

The VM Hard Disk will dynamically grow to around 10GB in size (as required). 
Ensure that you have at least this much space on the host system.


IMPORTING THE VMs
-----------------

In this example we import the 'DiffuseWRT-Light.ova' file into VirtualBox. The process
is the same for 'DiffuseWRT-Build.ova'.

Launch VirtualBox. 
	- In the VirtualBox Manager select File -> Import Appliance
	- At the Import Appliance Dialogue select Choose then select DiffuseWRT-Light.ova
	- Select Next, then Import
	
The VM will be loaded into the VirtualBox Manager and will appear as DiffuseWRT or 
DiffuseWRT Build (depending on which VM you import).


RUNNING THE VMs
---------------

Click on the VM in the VirtualBox Manager. Click start.

Log in details: 
	- username: diffuse
	- password: diff123

As this is an Unbuntu distribution the root account is not accessible by default.
The 'diffuse' user has administrative privileges however, so if you need to do 
something that requires root privileges then prepend that command with 'sudo'.

E.g. ~: sudo vim /etc/network/interfaces

Once the VM is booted the user may use the VM's console or ssh. See CONFIGURING 
SSH ACCESS if you want to use SSH.

In the home folder there is an openwrt folder. Inside this folder you can find 
the OpenWRT trunk, which has been checked out using subversion.


CONFIGURING SSH ACCESS
----------------------

Access to the VM via SSH can be enabled through port forwarding or by adding an
additional network interface to the VM.

For directions on setting up port forwarding see the VirtualBox manual "Configuring
port forwarding with NAT": http://www.virtualbox.org/manual/ch06.html#natforward

To access the VM via an additional network interface, do the following:
	- With the VM selected in the manager, right click -> settings
	- Choose Network -> Adapter 2
	- Check 'Enable Network Adapter'
	- On the 'Attached to:' drop-down box select "Host-only Adapter"
	- Click 'OK' to save the settings.

Start the VM. Once logged in issue the following command:
	- sudo nano /etc/network/interfaces

Uncomment the following lines:
# auto eth1
# iface eth1 intet static
# address 192.168.56.2
# netmask 255.255.255.0

Save and quit the editor.
Run the following command to restart networking and enable the interface:
	- sudo /etc/init.d/networking restart

You should now be able to access the VM via SSH from the Host machine.


CONTRIBUTIONS
-------------

We welcome your feedback and contributions! If you have discovered a bug,
have a request for a new feature, have produced a code patch or a new 
classifier model, please contact Nigel Williams (njwilliams@swin.edu.au).


CONTACT
-------

The DIFFUSE website is: http://www.caia.swin.edu.au/urp/diffuse

If you have any questions or want to report any bugs please contact
Nigel Williams (njwilliams@swin.edu.au).

Centre for Advanced Internet Architectures
Swinburne University of Technology
Melbourne, Australia
CRICOS number 00111D
http://www.caia.swin.edu.au