Requirements for fBuilder 2.4.x

Please note: this README may not be complete - Please check the documentation for fBuilder at http://www.innertek.com
 
If you have any questions about the use of fBuilder 2.4, please email support and we will be happy to assist.

When you download fBuilder, you are downloading a package with binaries. These binaries were built with and depend on the following being installed on your Linux system. 
Kernel 2.4.x 
glibc >= 2.1.3 (or compatible version) 
iptables 
ip_conntrack modules for iptables 


fBuilder has been successfully tested on the following systems: 
RedHat 7.x / 8.x
Mandrake 8.2 
SuSe 7.1 
Debian/GNU Linux with kernel 2.4.x. 
If you download fBuilder and try to run it on a system other than what we have listed above and have problems, send an email to support@innertek.com with detailed information about your system, such as the version of glibc, and Perl, and we will try to get a copy of fBuilder built for your system. Also let us know if it works! 

Installing fBuilder
Download fBuilder from InnerTek Software to your Linux machine and untar the package to a local directory. Note: Do not unzip these files on a Windows machine as this has been known to corrupt the files. Before running the install file you must manually add a fbuilder account on your system. This account is needed by the boa web server and must be in place for the installation script to run correctly. The installation script assumes that you have Perl installed to /usr/bin/perl. If this is not the location that you have Perl installed to, you will need to modify the install script to specify the correct location or type 'perl install' to run it. 

Running the Install Script: 

1) cd to the directory wher you unzipped fBuilder and type ./install 
2) The first thing that the script asks if for a username and password. This is the username and password that you will use to access fBuilder for the first time. 
3) You will be prompted for your server name. This should be in the machinename.company.com format. You MUST use a name on this screen, not the IP Address of the machine, for fBuilder to function properly. When connecting to fBuilder you will use the name entered on this screen by typing http://machinename.company.com:8000 in the URL line of your web browser. If you forget the name that you entered, it is stored in /usr/local/fbuilder/.fbuilder_config. 
4) The install script then calls loadmods.pl which loads your iptables modules that are located in /lib/modules/$kernel/kernel/net/ipv4/netfilter (where $kernel is your kernel version). This script can be used at a later time to load your modules at boot time and gets copied to /root. 
5) At this point the script should install your product and complete sucessfully.
6) Copy the license file, that was sent to the email address you provided when downloading the product, to /usr/local/fbuilder.
7) fBuilder is now installed and the Boa web server has been started. You can now connect to fBuilder by typing http://machinename.company.com:8000 in the URL line of your web browser, log in using the username and password that you specified in the install script, and proceed to use fBuilder to create new users and build your firewall. If machinename.company.com is not registered on your local DNS, you will need to place it in your hosts file to access your fBuilder installation. 


Boa
As mentioned above, the boa web server is bundled with fBuilder. The file boa.conf is the configuration for the boa web server and is set to have boa listen on port 8000 by default. 

If you restart your machine, you can start boa by typing /usr/local/fbuilder/boa while logged in as root or by having it run on startup by adding an entry to your /etc/rc.d/rc.local file, for RedHat users, or the appropriate start up file for your distribution. 

Boa is distributed under the GNU General Public License, therefore, the source code for the boa distribution used with fBuilder is also available. To obtain the source code for the boa web server, please download it from http://www.innertek.com/boa/boa-0.94.13.tar.gz

For more information about the Boa web server go to http://www.boa.org 



For information about running fBuilder:

Please see the documentation in the docs sub folder or at http://www.innertek.com/docs/fb
