This document was created using Windows 2003 Server, Apache 2 and PHP 5. It should work with modifications on Windows XP Professional, Windows 2000 and possibly NT 4.0.
It will not work with Windows 95/98/ME.
The entire installation should be done using an account with local Administrator privileges.
If you want to use older versions, read the JFFNMS 0.7.9 INSTALL.win32.txt file.
Windows
Install your preferred operating system and all updates.
Install the SNMP service if you want to monitor the JFFNMS machine itself.
Install Apache2
Download Apache 2 Server from http://httpd.apache.org/download.cgi
Select the latest Win32 binary (MSI installer) release, no_ssl.msi package.
(Currently apache_2.2.4-win32-x86-no_ssl.msi)
Select Typical install. Click Next until installation is complete.
You should see the Apache Monitor running in your system tray.
Test it by going to http://localhost/ or http://ip.of.your.box/. You should see the Apache confirmation screen. (It works!)
Install MySQL
Download MySQL Community Server from http://dev.mysql.com/downloads/mysql/5.0.html
Scroll down until you find Windows Essentials (x86) and select the latest version.
(Currently 5.0.37)
Select Complete install. Click Next until installation is complete.
During the configuration phase, select Detailed Configuration, then Server Machine, then Non-Transactional Database Only and then Decision Support (DSS)/OLAP.
Leave all other configuration options at their default.
Set a new root password.
Install PHP
Download PHP 5 from http://www.php.net/downloads.php
Select the latest Windows Binaries Zip package with all the modules.
(Currently PHP 5.2.1)
Extract the archive to C:\php
Copy and rename C:\php\php.ini-dist to C:\Windows\php.ini
Copy C:\php\libmysql.dll to C:\Windows\
Create the folder C:\usr
Copy the C:\php\extra\mibs folder to C:\usr\mibs
Install JFFNMS
Download JFFNMS from http://sourceforge.net/project/showfiles.php?group_id=46041
Select the latest Zip file.
(Currently jffnms-0.8.3.win32.zip)
Extract it to C:\jffnms
Create a user 'jffnms' in the Windows user manager and assign a password. Remember to uncheck 'User must change password at next logon' and check 'Password Never Expires' for this user. Add the ‘jffnms’ user to the local Administrators group.
Install RRDtool
Download RRDtool from http://oss.oetiker.ch/rrdtool/pub/?M=D
Select the rrdtool-1.2.15-win32-perl58.zip (or newer) file.
Extract the archive to a temporary location.
Copy the rrdtool.exe file from inside the archive to C:\jffnms
Install NMAP
(If you are running Windows XP please read the NMAP page carefully, it may not work).
Download nmap from http://www.insecure.org/nmap/download.html
Select the latest stable command line zip file for Windows.
(Currently nmap-4.20-win32.zip)
Extract the archive to a temporary location.
Extract the nmap.exe file from inside the archive to C:\jffnms
Install WinPcap
Download WinPcap from http://www.winpcap.org/install/default.htm
Get the latest Auto-Installer version.
(Currently 4.0)
Click Next until installation is complete.
Configure Apache for PHP5
Add this to the bottom of your
C:\Program Files\Apache Group\Apache2\conf\httpd.conf file.
LoadModule php5_module C:/php/php5apache2_2.dll
AddType application/x-httpd-php .php
NameVirtualHost *
<VirtualHost *>
ServerAdmin webmaster@yourdomain.com
DocumentRoot C:/jffnms/htdocs
ServerName nms.yourdomain.com
DirectoryIndex index.php
LimitRequestLine 20000
</VirtualHost>
By default Apache denies access to all directories except the Apache defaults.
You will need to add permission to the JFFNMS files. Add the following lines to your httpd.conf file.
<Directory "C:/jffnms/htdocs">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
Make sure you modify the above information (php5_module path, ServerAdmin address, DocumentRoot path, ServerName and Directory) to match your configuration. Note the use of forward slashes; Apache uses UNIX path notation.
Configure PHP
Make the following changes to the C:\Windows\php.ini file.
register_globals = On
register_argc_argv = On (This should already be the default)
allow_url_fopen = On (This should already be the default)
extension_dir = “C:\php\ext”
(Uncomment the following four lines)
extension=php_gd2.dll
extension=php_mysql.dll
extension=php_snmp.dll
extension=php_sockets.dll
SMTP = your.mail.server.com (set it to your mail server IP address or DNS name)
Enter an email address to send the mail alerts from.
Restart the Apache Service.
Configure MySQL
To create the JFFNMS database run the following.
Open a command prompt and navigate to the folder with mysql.exe
It will be something like C:\Program Files\MySQL\MySQL Server 5.0\bin\
C:\Program Files\MySQL\MySQL Server 5.0\bin>mysql.exe -u root
-p<Root MySQL Password from the MySQL installation step>
(The above is all one line.)
mysql> CREATE DATABASE jffnms;
mysql> GRANT ALL PRIVILEGES ON jffnms.* TO jffnms@localhost IDENTIFIED BY 'jffnms';
mysql> FLUSH PRIVILEGES;
mysql> quit;
Then enter:
C:\Program Files\MySQL\MySQL Server 5.0\bin> mysql.exe –ujffnms
-pjffnms jffnms < C:\jffnms\docs\jffnms-0.8.x.mysql
(The above is all one line. Replace x with the version of JFFNMS you are installing.)
Configure JFFNMS
Go to http://yourserver/
Verify and change the options.
Change the RRDtool Font to a True Type font available on the machine. Fonts are usually located in C:\Windows\Fonts\
Don't worry about the errors on Neato, Diff, FPing, SMSClient, NTPQ, or PostgreSQL.
Change the values and save the configuration until everything needed is green (OK).
Configure Scheduled Tasks
If you did not install JFFNMS in C:\jffnms you will have to change the path names within the .bat files.
Go to Start > Control Panel > Scheduled Tasks > Add Scheduled Task.
Click Next.
Click Browse.
Browse to C:\jffnms\engine\windows and select the first .bat file.
Select Daily, then click Next.
Change the Start time to 12:00 AM
Select Every 1 Days then click Next.
Enter username of ‘jffnms’ and the password you chose when creating the ‘jffnms’ user account. Click Next.
Click the 'Open advanced properties...' checkbox, then click Finish.
Change Start In to C:\jffnms\engine
Click the Schedule tab.
For autodiscovery_interfaces, consolidate, poller & rrd_analyzer only:
Click the Advanced button.
Check Repeat Task. In the Every field enter the respective times:
autodiscovery_interfaces: every 30 minutes.
consolidate: every 1 minute.
poller: every 4 minutes.
rrd_analyzer: every 30 minutes.
Duration: 24 Hours.
Click OK twice.
Repeat these steps for all six batch files in the C:\jffnms\engine\windows folder.
Now, try to access http://yourserver/
Remember to add the last slash / to the URL.
The default username and password is admin.
If you want to read more, please read the INSTALL file and skip the Unix Parts.
Last updated: 3/11/07
====================================================================
If you need anything, contact us at: jffnms-users@lists.sourceforge.net
Thank You for trying 'Just For Fun' Network Management System
Don't forget to Donate to the project if you find it useful for your work.
====================================================================
Javier Szyszlican aka SzYsZ
Buenos Aires, Argentina
javier@jffnms.org (please try the mailing list first)
ICQ #397319