Drawbridge

IMPORTANT:  FreeBSD must be installed with the kernel sources available.  This
is necessary to compile the Drawbridge kernel module.


Automatic Installation Instructions:

	1.  Create a "manager" account that is a member of group wheel. 
	    Username: manager
	    Groups: manager, wheel

	2.  Run the install script.  This will result in a default install in 
	    /usr/local/drawbridge.  Binaries are in /usr/local/drawbridge/bin 
	    and /usr/local/drawbridge/sbin.  Dcoumentation is in 
	    /usr/local/drawbridge/doc, and rulesets are in 
	    /usr/local/drawbridge/rules.  The startup script is in 
	    /usr/local/etc/rc.d.
	    
	3.  Edit the /usr/local/etc/rc.d/drawbridge.sh script and modify the
	    "Interface IDs" section to reflect the correct names of the 
	    interfaces for your particular hardware. You must define the 
	    inside and outside interface names.  The mirror interface is
	    optional (mirror ="").

	4.  Add /usr/local/drawbridge/sbin and /usr/local/drawbridge/bin to
	    the default path for the manager account.

	If, for some reason, the install script fails or does not properly 
	install Drawbridge, please report the problem to 
	drawbridge-users@net.tamu.edu.  Manual installation instructions
	are provided below.
	

Manual Installation Instructions:

	1.  Create a "manager" account that is a member of group wheel. 
	    Username: manager
	    Groups: manager, wheel

	2.  Create the Drawbridge module directory.  Typically
	    /usr/src/sys/modules/netgraph/drawbridge.
	    
	3.  Copy ng_drawbridge.c and ng_drawbridge.h from the Drawbridge
	    source directory to  /usr/src/sys/netgraph.  Copy Makefile
	    from the Drawbridge source directory to the Drawbridge 
	    module directory created in step 1. 
	    
	4.  Change to the module directory and compile the Drawbridge
	    netgraph module by executing "make install".
	    
	5.  Create the follwing Drawbridge directory tree structure in
	    /usr/local:
	    
	    /usr/local/drawbridge/bin
	    /usr/local/drawbridge/sbin
	    /usr/local/drawbridge/doc
	    /usr/local/drawbridge/rules
	    /usr/local/drawbridge/man
	    /usr/local/drawbridge/man4
	    /usr/local/drawbridge/man8
	    
	6.  Change to the dbmgr source directory and compile the 
	    Drawbridge Manager with "make".  Copy the dbmgr binary to
	    /usr/local/drawbridge/sbin.  Copy the dbmgr.8 manpage to 
	    /usr/local/drawbridge/man/man8.
	    
	7.  Change to the dbfc source directory and compile the
	    Drawbridge Compiler with "make".  copy the dbfc binary to
	    /usr/local/drawbridge/bin.  Copy the dbfc.4 manpage to
	    /usr/local/drawbridge/man/man4.
	    
	8.  Copy the startup script from the Drawbridge source directory to
	    /usr/local/etc/rc.d.  Edit the startup script and modify the
	    "Interface IDs" section to reflect the correct names of the 
	    interfaces for your particular hardware.  You must define the 
	    inside and outside interfaces names.  The mirror interface is
	    optional (mirror = "").
	    
	9.  Change to the documentation source directory and copy all the
	    files in that directory to /usr/local/drawbridge/doc.
	    
	10. Recursively change the ownership of the /usr/local/drawbridge
	    directory tree to manager:wheel (chown -R manager:wheel /usr/local/drawbridge).
	    Change the ownership of the dbmgr binary to root:wheel.  Change
	    the permissions of the dbmgr binary to be 4550.  

	11. Add /usr/local/drawbridge/sbin and /usr/local/drawbridge/bin to
	    the default path for the manager account.