[[TOC]]

= Virtual Machine Setup Notes =

== Server Templates ==

There are three VMWare templates available at http://deterlab.net/~jjh/ for Boss, Users, and Router nodes.  These images don't contain the DETER source, but do have all packages required package to build the testbed source.  

Templates are easy to deploy on your local ESXi server.

In the 'vSphere Client' Select 'File'->'Deploy OVF Template' and put in the URL for the OVA template you are deploying:

[[Image(Deploy OVA.png)]] 

The default root password is 'deterinavm', make sure to change it!

== A note about Virtual Machines and CPU core allocation ==

The boss and users templates come configured to use 4 CPUs.  This is problematic on VMWare servers with less than 4 CPUs, since you can only give a VM up to as many cores as the ESXi host has.  If you are installing onto an ESXi host that has fewer than 4 CPUs, you will have to edit the number of allocated cores in the VM settings for boss and users before being able to boot them.

=== General FreeBSD Configuration ===

You will want to configure your internet facing VM interfaces.  The main configuration file for FreeBSD is '''/etc/rc.conf''' and the configuration lines for the interfaces are near the top.  You might also want to configure '''/etc/resolv.conf''' for  initial setup (after setup, you will be using the DNS server on Boss).

Configuring FreeBSD is beyond the scope of this documentation, but the [http://www.freebsd.org/doc/handbook/ FreeBSD Handbook] is an excellent reference for most FreeBSD systems administration tasks.  Also, FreeBSD features very complete man pages.  

=== Users Image Notes ===

The users image contains two disk images.  One is for the main operating system and the other is for NFS exported filesystems.  These are 
kept separate in order to make it easy for sites to deploy a bigger NFS export filesystem.


=== Boss Image Notes ===

Nothing special to note yet.


=== Router Image Notes ===

This image is minimally configured to route between the various networks.  It is also configured to route/relay Multicast and DHCP requests between boss and the control network.