This document explains the changes since v2.2 RC3, and the steps to upgrade to v3.
V3.0.3 is a small pont release (SVN build 1582) gathering fixes to the stable branch since v3.0.0.
A new feature called "clear mac" has been added, which completes the port restarting mechanism. This is needed for newer IOS version where port restart does not work as expected. See clear_mac discussion in the technical guide.
The Windows GUI and Web GUI have been modified accordingly. Information about configuration of this new feature can be found in the Switch configuration part of the Install Guide.
Windows GUI: The source code (Delphi Pascal) been finally released under GPL, see the Windows GUI changelog.
Port_scan: A new policy and feature have been introduced which allow port scanning of systems upon connection. This enhances the quality of the inventory. An example of such a policy can be found here.
Systems Management Server: A new class has been added that will allow the integration between FreeNAC and a Microsoft SMS server.
V3.0.2 is a small point release (SVN build 1233) gathering fixes to the stable branch since v3.0.0.
Windows GUI: several small improvements.
A substantial change in FreeNAC v3.0 is the introduction of an OO (objected oriented) policy interface, which provides greater flexibility and encapsulation of individual decisions regarding control of end-device access to the network.
The main programs have been rewritten using OO techniques, some others have been modified to work with our framework, and some others have been added to this new release. The aim of the OO change is to have a modularized system which would be easier to debug, troubleshoot, maintain and extend in the long run.
It's now a requirement to use PHP 5 (not PHP4) - we recommend using the latest PHP version.
Here is a summary of the changes in v3.0 (since v2.2):
If you have a previous FreeNAC installation and would like to update to 3.0, here is what you have to do:
Stop previous instances of vmps, last_seen and proctst (if you are using this latter)
/etc/init.d/vmps stop /etc/init.d/vmps_lastseen stop /etc/init.d/proctst stop
Checkout the latest stable release
mkdir /opt/nac3.0 svn co https://opennac.svn.sourceforget.net/svnroot/opennac/branches/3.0/ /opt/nac3.0
Then, copy over the config files or adapt the config.inc.template according to your needs.
Apply the changes to the database
cd /opt/nac3.0/contrib/migration_2.2_to_3.0/ mysql opennac < db_changes.sql
Add the extension .php to all php scripts you have in your crontab
Copy over the startup scripts
mv /etc/init.d/vmps /etc/init.d/vmps.$$ mv /etc/init.d/vmps_lastseen /etc/init.d/vmps_lastseen.$$ cp /opt/nac3.0/contrib/startup_init.d/vmps /etc/init.d/ cp /opt/nac3.0/contrib/startup_init.d/postconnect /etc/init.d/
Copy over the proctst configuration file (if you are using it)
mv /etc/proctst.conf /etc/proctst.$$ cp /opt/nac/contrib/etc/proctst.conf /etc
Activate the new directory
mv /opt/nac /opt/nac.$$ ln -s /opt/nac3.0/ nac
And finally start the daemons and watch syslog
/etc/init.d/vmps start /etc/init.d/postconnect start /etc/init.d/proctst start (only if you are using it)
All modules are configured via settings in the 'config' table. This was already the case in v2.2 RC3. If upgrading from an even earlier release (v2.1 for example), please read the relevant migration notes on config.inc. The contents of config.inc has not changed between v2.2 RC3 and V3.
As usual, any questions/remarks/queries can be posted in the forums .
See also the troubleshooting section of the user Guide, search the website, and serach the forum.
Is there are errors or omissions in this document, please login to the website and post a comment below.
The FreeNAC Team