Location: PHPKode > projects > Free Windows Network User Accounting > fwnua-3.0/README.TXT
 FWNUA 3.0 README

 Copyright (C) 2003-2004 FWNUA

 This program is free software; you can redistribute it and/or modify it
 under the terms of the GNU General Public License as published by the Free
 Software Foundation; either version 2 of the License, or (at your option)
 any later version. This program is distributed in the hope that it will be
 useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
 Public License for more details.

 You should have received a copy of the GNU General Public License along
 with this program; if not, write to:

         Free Software Foundation, Inc.,
         59 Temple Place - Suite 330,
         Boston, MA  02111-1307, USA.

 Web Site:		http://fwnua.sourceforge.net/

-----------------------------------------------------------------------------
Purpose
-----------------------------------------------------------------------------
	
FWNUA (Free Windows Network User Accounting), is a small executable that runs
silently in a Windows logon or logoff script and collects data about a user,
such as username, computer name, ip address, domain, and current time/date.
FWNUA allows more freedom in standardized Windows computer naming. FWNUA
keeps track of workstations your users log into so you don't have to.

Have you been naming workstations after users?  Users move, they leave the
company or organization, or they upgrade hardware.  Who wants to spend weeks
renaming thousands of computers just to make sense of what people have what
machines?  FWNUA can help!

Visit http://fwnua.sourceforge.net/ for screenshots and more!

-----------------------------------------------------------------------------
Package File Tree
-----------------------------------------------------------------------------

--bin                   (Binary executables)
    |--fwnua.exe            (FWNUA Data Collection Tool)
--convert               (Data Conversion Tools)
    |--convert.pl           (Log Data Conversion Utility)
--src                   (Program Source code)
    |--fwnua.c              (Data Collection Tool Source file)
--web-int               (Web-Interface)
    |--top.png              (Web-Interface Image)
    |--bottom.png           (Web-Interface Image)
    |--cal.png              (Web-Interface Image)
    |--valid.png            (Web-Interface Image)
    |--index.css            (Cascading Style Sheet)
    |--config.php           (FWNUA Configuration File)
    |--index.php            (Main Web Interface File)
    |--sort.js              (JavaScript Table Sorting Tool)
    |--calendar.js          (JavaScript Calendar Tool)
README.TXT              (This File)
LICENSE.TXT             (GNU General Public License)
CHANGELOG.TXT           (Version changes)

-----------------------------------------------------------------------------
Data Collection Setup
-----------------------------------------------------------------------------

1 - Create a directory - on your network with high availability. This 
    directory must be readable and writeable by all users who logon to the 
    domain. Though you can hide the share by using a "$" at the end of the 
    share name for a somewhat heightened sense security.
    
2 - FWNUA executable - fwnua.exe should be placed in your NETLOGON directory
    on your domain controller, though it can also be run from any network 
    share.
    
3 - Insert a command into your main user logon or logoff script, executing
    fwnua.exe. Below is the fwnua.exe usage options:
    
    Usage: fwnua [-logon | -logoff] [logdirectory]
    
    Options:
    
        -logon           The program will record the user as logging on.
                         This argument would be used in a logon script.
    
        -logoff          The program will record the user as logging off.
                         This argument would be used in a logoff script.
                         Logoff scripts are supported natively on
                         Windows 2000 and 2003 domains.
    
        logdirectory     Log files will be placed in directory 'logdirectory'.
                         File location can be a network drive or UNC share name.
                         This program needs write access to the directory.
                         Be sure to add the trailing backslash.
    
                         Ex. c:\fwnua\fwnua.exe -logoff g:\logs\
                         Ex. \\server\fwnua.exe -logon \\server\fwnua\
                    
4 - Verify User Data - is being created in the directory created in 
    step 1 by manually running the login script. If data is not being 
    collected, check the share permissions on the log directory. Also check
    your command-line syntax when running fwnua.exe. Once you are collecting
    data successfully, you can then use the Web-Interface to view and make
    this collected data useful. See instructions below.
    
-----------------------------------------------------------------------------
Web-Interface Setup
-----------------------------------------------------------------------------

    Web-Interface Server Requirements:
    
    NOTE: Perl5 is required to use covert.pl; the log data conversion script.
    
        Win32:
                PHP 4.3.x or 5.0.x      (http://www.php.net/downloads.php)
                IIS 5.0 or Higher
        
        Linux:
                PHP 4.3.x or 5.0.x      (http://www.php.net/downloads.php)
                Apache 1.32 or Higher   (http://httpd.apache.org/download.cgi)
                Apache 2.0.x            (http://httpd.apache.org/download.cgi)

1 - Create a directory on your web server for the FWNUA Web-Interface files.
    Ex. http://intranet/fwnua/

2 - Copy the contents of the web-int directory to your new FWNUA 
    Web-Interface directory.
      
3 - You must also create a virtual directory to the log data files, so your
    web server has access to them.
    Ex. http://intranet/fwnua/logs/ must list the log files from the Data
    Collections above. Refer to you web server manual for instructions on
    creating virtual directories. 
    
    NOTE: If using IIS, configure the Properties for the site and click the 
    Directory Security tab. Change the Anonymous access account from the 
    local IIS account to a domain account or a local account on the computer
    that has rights to the share where the user log files are located.
    
    NOTE: If using Apache with Windows, configure the Apache service to start
    with an account that has access to the fwnua log directory, otherwise the
    Local Account that Apache starts with by default, will not be able to read
    the directory.
    
4 - You need to edit the config.php configuration file to suite your needs. 
    Follow the descriptions in that file for proper setup. You can now view 
    the Web-Interface by pulling up the index.php in your favorite web browser.

-----------------------------------------------------------------------------
Contact The Developers
-----------------------------------------------------------------------------

Project Leader:     Thomas C. Taylor    <hide@address.com>
Lead Developer:     Andrew S. Heacock   <hide@address.com>

Find a bug?   Visit http://sourceforge.net/tracker/?group_id=90284&atid=593053

Web Site:		        http://fwnua.sourceforge.net/
Sourceforge Site:   http://www.sourceforge.net/projects/fwnua/
Return current item: Free Windows Network User Accounting