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/