Installation Instructions - CAIA Greynets Toolkit 0.5.8
-------------------------------------------------------

This file describes how to install the CAIA Greynet Toolkit
with the FreeBSD port.

1. Important Notes - Read before installation:

  This toolkit should only be installed on a fresh FreeBSD 7 system, as the
  network Greynet Toolkit takes complete control of the system (including
  network configuration and other system parameters).

  During installation, you will be prompted to setup the IP configuration for
  the management network. Currently, only static IP configuration is supported
  for the management network. This means that you must enter an IP address
  outside any dynamically assigned ranges on your network. (If your system has
  been allocated a dynamic address at startup, you should NOT accept the default
  address presented by the setup script.)

  Please note the preferred method of installation is to use the Greynets port.
  The port will automate the installation of all dependencies and provide an
  initial configuration wizard.

  The port is avialable at
  http://caia.swin.edu.au/greynets/files/greynets-port-latest.tar.gz

  Alternatively, if you would rather avoid this installation you can
  download a preconfigured VMware virtual machine at
  http://caia.swin.edu.au/greynets/files/greynets-vmware-latest.tar.gz

2. Installing Required Binary Packages

  Prior to installing the port, we will install Apache and both the ISC
  DHCP Server and Client. While this step is not required, as the port will
  take care of dependencies, it will avoid having to build these packages from
  source.

  The following commands will install the packages:

  pkg_add -r python25
  pkg_add -r apache22
  pkg_add -r isc-dhcp3-server
 
  NOTE: Do not install the isc-dhcp3-client package, as we need 
        to configure it specifically.

3. Installing with the Greynet Port

  3.1 Download the latest port from
      http://www.caia.swin.edu.au/greynets/files/greynets-port-latest.tar.gz
  3.2 Untar the port in a working directory of your choice
      'tar zxvf greynets-port-latest.tar.gz'
  3.3 Enter the newly extracted directory
  3.4 Type 'make install'
  3.5 The Greynets toolkit and required dependencies are installed
      When prompted to accept the configuration for the DHCP Client,
      ensure that 'interface polling' is NOT CHECKED.

4. Initial Setup and Configuration

  The setup script should now run prompting you for information on your
  network configuration.
  
  Please follow instruction in SETUP.txt