INSTALL.win32.txt

   1 Windows 2000/XP Install Procedure
   2 =================================
   3
   4
   5 Note: This will not work for Windows 95/98/Me, it's only for Windows 2000/XP and maybe NT 4.0
   6
   7 The installation should be done as and Administrator User.
   8
   9 This guide is for Apache2 with PHP5. If you want to use older versions,
  10 read the JFFNMS 0.7.9 INSTALL.win32.txt file.
  11
  12 Installation:
  13 -------------
  14
  15 Install Apache:
  16         Download Apache2 from: http://www.apache.org/dist/httpd/binaries/win32/
  17         Get the latest release "no_ssl.msi" package, like "apache_2.0.52-win32-x86-no_ssl.msi".
  18         Complete Install, Click on Next until Finish.
  19         You should see Apache running in your taskbar.
  20         Test it going browsing to http://localhost/ or http://IP.OF.YOUR.BOX/
  21
  22 Install MySQL:
  23         Download from: http://www.mysql.com/downloads/mysql/4.1.html
  24         Scroll down until you find MySQL Essentials for Windows.
  25
  26         Select the "Complete Install", Click on Next until Finish.
  27
  28         When you go into the configuration phase, select "Server Machine",
  29         and then "Non-Transacctional Database Only".
  30
  31         Then set a new root password.
  32
  33         All other configuration leave as default.
  34
  35 Install PHP:
  36         Download PHP 5 from: http://www.php.net/downloads.php
  37         Get the "Windows Binaries ZIP package" with all the modules (First One).
  38
  39         Extract the archive to c:\php
  40
  41         Execute the following:
  42             c:\> copy c:\php\php.ini-dist c:\windows\php.ini
  43             c:\> copy c:\php\libmysql.dll c:\windows\
  44
  45         Create Folder c:\usr
  46         Copy c:\php\extra\mibs to c:\usr\mibs
  47
  48 Install JFFNMS:
  49         Download the .zip file (I'm sure you already have done this) and extract it to c:\jffnms
  50
  51         Create the User 'jffnms' in the Windows User Manager with any password you choose.
  52
  53         Remember to CHECK 'Password Never Expires' and UNCHECK 'Must Change password at next logon' for this user.
  54
  55         Give the 'jffnms' user FULL CONTROL over the c:\jffnms folder (and its sub-folders)
  56
  57 Install RRDTOOL:
  58         Download from: http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/pub/?M=D
  59         Get the rrdtool-1.0.49-win32-bin.zip (or newer) file.
  60         Extract the archive to a temporary location.
  61         Copy the rrdtool.exe file from inside the archive to c:\jffnms
  62
  63 Install NMAP: (If you are running Windows XP please read the NMAP page carefully, it may not work)
  64         Download it from: http://www.insecure.org/nmap/nmap_download.html
  65         Get the nmap-3.81-win32.zip file (or newer)
  66         Extract the nmap.exe file from the archive to c:\jffnms\
  67
  68 Install WinPCAP for NMAP:
  69
  70         Download it from: http://winpcap.polito.it/
  71         Choose the Auto-Installer.
  72         Complete Install, Click on Next until Finish.
  73
  74
  75 Configuration:
  76 --------------
  77
  78 Configure Apache for PHP5:
  79
  80         Add this to the bottom of your c:\program files\apache group\Apache2\conf\httpd.conf file:
  81
  82         LoadModule php5_module c:/php/php5apache2.dll
  83         AddType application/x-httpd-php .php
  84
  85         NameVirtualHost *
  86
  87         <VirtualHost *>
  88             ServerAdmin webmaster@your-domain.com
  89             DocumentRoot c:\jffnms\htdocs
  90             ServerName nms.yourdomain.com
  91             DirectoryIndex index.php
  92             LimitRequestLine 20000
  93         </VirtualHost>
  94
  95         * Make sure you modify the above information to match your needed settings
  96
  97 Configure PHP:
  98         Make sure you have this on your php.ini file:
  99
 100         register_globals = On
 101         register_argc_argv = On
 102         allow_url_fopen = On
 103
 104         extension_dir = c:\php\ext
 105
 106         (Uncomment the following):
 107         extension=php_gd2.dll
 108         extension=php_snmp.dll
 109         extension=php_mysql.dll
 110         extension=php_sockets.dll
 111
 112         SMTP = your.mail.server.com     (set it to your mail server IP or DNS name)
 113
 114         Now Restart the Apache Service.
 115
 116         if you don't change these, JFFNMS will not work.
 117
 118 Configure MySQL:
 119
 120         To create the JFFNMS DB run the following:
 121
 122         Check the path to mysql.exe
 123
 124         c:\> c:\Program Files\MySQL\MySQL Server 4.1\bin\mysql.exe -u root -p<Root MySQL Password>
 125
 126         mysql>CREATE DATABASE jffnms;
 127         mysql>GRANT ALL PRIVILEGES ON jffnms.* TO jffnms@localhost IDENTIFIED BY 'jffnms';
 128         mysql>FLUSH PRIVILEGES;
 129         mysql>quit;
 130
 131         And:
 132
 133         c:\> c:\Program Files\MySQL\MySQL Server 4.1\bin\mysql.exe -ujffnms -pjffnms jffnms < c:\jffnms\docs\jffnms-0.8.x.mysql
 134
 135         Replace x with the version you are installing.
 136
 137 Configure JFFNMS:
 138
 139         -----------------
 140         I M P O R T A N T
 141         -----------------
 142
 143         Go to: http://yourserver/
 144
 145         Verify and change (if needed) the options.
 146
 147         Don't mind the errors on diff, neato, smsclient, fping, ntpq, PgSQL and SOAP.
 148
 149         Save the configuration and change the values until everything needed is Green.
 150
 151         Everything else SHOULD be OK.
 152
 153         Scheduled Tasks:
 154         ----------------
 155                 If you did not install jffnms in c:\jffnms you will have to change the
 156                 contents of the .bat files (path).
 157
 158                 Start/Settings/Control Panel/Scheduled Tasks/Add Scheduled Task.
 159                         1) Next
 160                         2) Click Browse
 161                         3) Browse to c:\jffnms\engine\windows and select the first .bat file.
 162                         4) Select Daily, then Next.
 163                         5) Change the Start time to 12:00 AM
 164                         6) Select Every 1 Days then Next.
 165                         7) Enter Username: jffnms and Password: (the one you choosed before), then Next.
 166                         8) Click the 'Open Avanced...' checkbox, then click Finish
 167                         9) Change "Start In" to c:\jffnms\engine
 168                         10) Click the Schedule tab
 169                         11) For autodiscovery_interfaces, consolidate, poller & rrd_analizer:
 170                                 Click on the Advanced Button.
 171                                 Check Repeat Task.  In the Every Field enter the respective times:
 172                                         autodiscovery_interfaces every 30 minutes.
 173                                         consolidate Every 1 Minute.
 174                                         poller Every 4 minutes.
 175                                         rrd_analizer every 30 minutes.
 176                                 Duration: 24 Hours.
 177
 178                         12) Click on OK.
 179                         13) Click on OK.
 180
 181                 ** REPEAT THESE STEPS FOR EACH .BATCH FILE IN THE C:\JFFNMS\ENGINE\WINDOWS PATH!
 182
 183
 184 Now... try to access http://yourserver/ or http://yourserver/jffnms/ (if you took this way)
 185 Remember to add the last slash / to the URL.
 186 The Default Username and password is "admin".
 187
 188 If you want to read more, please read the INSTALL file and skip the Unix Parts.
 189
 190
 191 =========================================================================
 192
 193 If you need anything, contact us at: jffnms-users@lists.sourceforge.net
 194
 195 Thank You for trying 'Just For Fun' Network Management System
 196
 197 Don't forget to Donate to the project if you find it useful for your work.
 198
 199 =========================================================================
 200 Javier Szyszlican aka SzYsZ
 201 Buenos Aires, Argentina
 202 javier@jffnms.org (please try the mailing list first)
 203 ICQ #397319