== Build Process ==

The original installation documentation is here.  I strongly recommend                                                       
reading through it in order to understand where the DETER install process                                                    
is evolving from:                                                                                                            
                                                                                                                             
 https://users.emulab.net/trac/emulab/wiki/InstallRoot                                                                       
                                                                                                                           
== Updating the DETER meta packages ==

                                                                                                               
Since I have generated these images, I have added a few more packages to                                                     
the meta package for the deter install and bumped the revision.  Once                                                        
you create a bootstrap user and have the repository cloned onto the image,                                                   
updating should be painless:                                                                                                 

{{{                                                                                                                             
 cd testbed/install/ports                                                                                                    
 sudo make install                                                                                                           
 cd /usr/ports/misc/instant-deter                                                                                            
 sudo make deinstall                                                                                                         
 sudo make reinstall                                                                                                         
}}}                                                                                                                         

== Building the testbed software ==

Create a build user of your choice on boss and users.  If you are unfamiliar with FreeBSD, the process for creating users is laid out in the [http://www.freebsd.org/doc/handbook/ FreeBSD handbook].  Make sure the user is in the group 'wheel' so sudo can be used.

Login as this user and clone the testbed repository:

{{{
su -l <builduser>
git clone tardis.deterlab.net:/var/local/git/testbed
}}}

Create the object tree directory.

{{{
mkdir ~<builduser>/obj
}}}

Now go into the ~<builduser>/obj directory.

{{{
cd ~<builduser>/obj
../testbed/configure --with-TBDEFS=/home/jjh/testbed/defs-<your defs>
}}}

This will create the object tree for the testbed.

The install process is handled by two scripts.  One is boss-install and the other is users-install, for boss and users.

{{{
cd ~<builduser>/obj/install
sudo perl ./[boss|users]-install
}}}

== Updating the codebase ==

In order to update the codebase, running the install script is not necessary.

{{{
cd ~<builduser>/testbed
git pull
cd ~<builduser>/obj
../testbed/configure --with-TBDEFS=/home/jjh/testbed/defs-<your defs>
gmake
gmake [boss|users]-install
}}}