(View as Code
Updated: 19:32:00 02/03/2008
FreeNATS - Installation Documentation
5: This brief installation document is the only documentation that comes with FreeNATS. For full up-to-date documentation and licence information visit the FreeNATS website at www.purplepixie.org/freenats.
7: There are two methods of installation available; automatic where a script does all the work creating the relevant database tables or you can import the SQL manually.
9: FreeNATS creates various tables in the database all prefixed with "fn".
11: Install PHP Source Code
13: Extract freenats-V.vv.sr.tar.gz
14: "web" is the web interface directory and needs to be "published". Ideally the other dirs (base and bin) should be not published at all by apache but (a) it should be safe to call any of those scripts anyway and (b) there are .htaccess files in the dirs.
15: If you have moved web somewhere (so the base dir is not ../base from the web dir) will need to edit the include.php file in the web dir and give it the base location (WITH TRAILING SLASH!).
17: Edit the base/config.inc.php file and put in your MySQL connection settings.
20: Automatic Installation
22: Rename the web/firstrun-.php file to web/firstrun.php
24: Navigate to http://your.freenats.url/firstrun.php
26: Follow the instructions
28: Manual Installation
30: In the base/sql dir there are three .sql files – schema, default and example
32: You will need to run/import schema (the database table structure) and default (the admin user and some necessary default settings) for the system to work.
34: The example.sql file contains optional example node and group data and is recommended.
36: The Tester Script
38: The tester script must be run (via cron or whatever) at regular intervals to poll the nodes. The recommended setting is five minutes.
39: It requires the working directory to be the bin dir on startup.
41: There are two choices - either run bin/tester.sh which will test all enabled nodes waiting for each node/test in sequence and then raising the relevant
42: alerts and emails etc. The other option is to run bin/test-threaded.sh which will fork a background process for each node to test. This is better but will
43: send an alert email for each node that fails (rather than one with all the failures from that test run at the end). See the documentation for more information.
45: On many PHP/Linux security setups many of the low level tests (such as ping for example) can require root or some other special privs. You can always run the tester script manually from the console in different environments to test the output.
46: Please note that a script crash for lack of privs may not be caught gracefully and may result in stuck monitor scripts and/or just an open monitor record in the database stopping other monitors from running.
48: In addition to the tester script you should run bin/cleanup.sh daily or so to clean out old sessions and data (inline with your retention settings). This doesn't
49: require any special privs unlike the tester. See the documentation for more information.
52: See www.purplepixie.org/freenats