nPULSE - Web-based network monitoring package for Linux and Unix
nPULS:
nPulse is a web-based network monitoring package for Linux and Unix-like
operating systems. It can quickly monitor tens, hundreds, even thousands
of sites/devices at a time on multiple ports. nPulse is written in
Perl and comes with its own (SSL optional) web server for extra security.
Also, instead of re-inventing existing code, nPulse uses many excellent
OpenSource (GPL) products including
* Nmap www.insecure.org/nmap [required]
* Perl www.cpan.org [required]
* OpenSSL www.openssl.com [optional]
* Net::SSLeay and Mail::Mailer www.cpan.org [optional]
* Java Telnet App www.mud.de/se/jta [included]
* A modified version of miniserv.pl www.webmin.com [included]
------------------
Required Software
------------------
Linux/Unix Version 2.1 or greater (www.redhat.com)
Perl Version 5.004 or later (www.cpan.org)
Nmap Version 2.51 or later (www.insecure.org/nmap)
nPulse is entirely written in Perl 5. For port scanning it uses the excellent
package Nmap, available from www.insecure.org. nPulse will not work without Nmap.
--------------------------
Installation Instructions
--------------------------
Direct Download: wget http://dl.packetstormsecurity.net/UNIX/nmap/npulse/npulse-0.54.tar.gz
1. Unpack the distribution into a directory of choice, preferably one owned
by root and not visible to other users.
CMD: tar -zxf npulse-0.54.tar.gz
or
CMD: gunzip npulse-0.54.tar.gz
tar -xf npulse-0.54.tar
(If you are reading this, then you probably have already done so. :)
2. As root, execute the setup file.
CMD: ./setup.sh
3. Follow the instructions.
4. That's it. (Advanced users might want to tweak the preferences file.)
Last few steps of the installatoin:
After # ./setup.sh
…
…
…
Web server port [19000]:
Administrator's Login Name: admin
Enter the admin password:
Password again:
Web server hostname or ip address [192.168.158.128]:
***********************************************************************
Setup has gathered the following information. Please check it for
correctness. If anything is incorrect, exit setup and start again.
Current Directory: /usr/src/npulse-0.54
Install Directory: /usr/local/npulse
Config Directory: /usr/local/npulse/etc
Log Directory: /usr/local/npulse/log
Data Directory: /usr/local/npulse/data
Nmap command: /usr/bin/nmap
Traceroute command: /bin/traceroute
Perl 5 command: /usr/bin/perl
Automatic monitoring: every 2 minutes
Email notification: OFF
Allow Telnet: yes
Secure Server (SSL): off
Web server hostname: your-server-IP
Web server port: 19000
***********************************************************************
nPulse has been installed and started successfully.
Use your web browser to go to
http://your-server-IP:19000/
and log in as 'admin' with the password you entered previously.
To restart nPulse use /usr/local/npulse/etc/restart
To stop nPulse use /usr/local/npulse/etc/stop
***********************************************************************
tweak the preferences files:
NOTICE: There have been reports of problems when using newer versions of nmap with nPulse. If you are using a newer version of nmap try the following:
Stop nPulse (/usr/local/npulse/etc/stop)
As root edit the file /usr/local/npulse/lib/util.pl
Change line 89 from
$site{ports} .= $p[0].',';
to
$site{ports} .= $p[0].',' if $p[1] =~ /open/i;
As root edit the file /usr/local/npulse/autorecheck.pl (fix by: D Parker)
Change line 240 from
foreach (split(/,\s*/, $ports)) { push(@currentports, (split(/\//,$_))[0]); }
to
foreach (split(/,\s*/, $ports)) { push(@currentports, (split(/\//,$_))[0]) if $_ =~ /open/i; }
Start nPulse (/usr/local/npulse/etc/start)
# service iptables stop
http://your-server-IP:19000/
Starting screen:
Home page:
Setup page:
To change the admin password do the following:
As root, issue the following command:
# ./usermod -m admin newpassword
That's it...
nPulse is a web-based network monitoring package for Linux and Unix-like
operating systems. It can quickly monitor tens, hundreds, even thousands
of sites/devices at a time on multiple ports. nPulse is written in
Perl and comes with its own (SSL optional) web server for extra security.
Also, instead of re-inventing existing code, nPulse uses many excellent
OpenSource (GPL) products including
* Nmap www.insecure.org/nmap [required]
* Perl www.cpan.org [required]
* OpenSSL www.openssl.com [optional]
* Net::SSLeay and Mail::Mailer www.cpan.org [optional]
* Java Telnet App www.mud.de/se/jta [included]
* A modified version of miniserv.pl www.webmin.com [included]
------------------
Required Software
------------------
Linux/Unix Version 2.1 or greater (www.redhat.com)
Perl Version 5.004 or later (www.cpan.org)
Nmap Version 2.51 or later (www.insecure.org/nmap)
nPulse is entirely written in Perl 5. For port scanning it uses the excellent
package Nmap, available from www.insecure.org. nPulse will not work without Nmap.
--------------------------
Installation Instructions
--------------------------
Direct Download: wget http://dl.packetstormsecurity.net/UNIX/nmap/npulse/npulse-0.54.tar.gz
1. Unpack the distribution into a directory of choice, preferably one owned
by root and not visible to other users.
CMD: tar -zxf npulse-0.54.tar.gz
or
CMD: gunzip npulse-0.54.tar.gz
tar -xf npulse-0.54.tar
(If you are reading this, then you probably have already done so. :)
2. As root, execute the setup file.
CMD: ./setup.sh
3. Follow the instructions.
4. That's it. (Advanced users might want to tweak the preferences file.)
Last few steps of the installatoin:
After # ./setup.sh
…
…
…
Web server port [19000]:
Administrator's Login Name: admin
Enter the admin password:
Password again:
Web server hostname or ip address [192.168.158.128]:
***********************************************************************
Setup has gathered the following information. Please check it for
correctness. If anything is incorrect, exit setup and start again.
Current Directory: /usr/src/npulse-0.54
Install Directory: /usr/local/npulse
Config Directory: /usr/local/npulse/etc
Log Directory: /usr/local/npulse/log
Data Directory: /usr/local/npulse/data
Nmap command: /usr/bin/nmap
Traceroute command: /bin/traceroute
Perl 5 command: /usr/bin/perl
Automatic monitoring: every 2 minutes
Email notification: OFF
Allow Telnet: yes
Secure Server (SSL): off
Web server hostname: your-server-IP
Web server port: 19000
***********************************************************************
nPulse has been installed and started successfully.
Use your web browser to go to
http://your-server-IP:19000/
and log in as 'admin' with the password you entered previously.
To restart nPulse use /usr/local/npulse/etc/restart
To stop nPulse use /usr/local/npulse/etc/stop
***********************************************************************
tweak the preferences files:
NOTICE: There have been reports of problems when using newer versions of nmap with nPulse. If you are using a newer version of nmap try the following:
Stop nPulse (/usr/local/npulse/etc/stop)
As root edit the file /usr/local/npulse/lib/util.pl
Change line 89 from
$site{ports} .= $p[0].',';
to
$site{ports} .= $p[0].',' if $p[1] =~ /open/i;
As root edit the file /usr/local/npulse/autorecheck.pl (fix by: D Parker)
Change line 240 from
foreach (split(/,\s*/, $ports)) { push(@currentports, (split(/\//,$_))[0]); }
to
foreach (split(/,\s*/, $ports)) { push(@currentports, (split(/\//,$_))[0]) if $_ =~ /open/i; }
Start nPulse (/usr/local/npulse/etc/start)
# service iptables stop
http://your-server-IP:19000/
Starting screen:
Home page:
Setup page:
To change the admin password do the following:
As root, issue the following command:
# ./usermod -m admin newpassword
That's it...
Comments
Post a Comment