Difference between revisions of "Ntop"

From SME Server
Jump to navigationJump to search
(installation signal events added)
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{WIP box}}
 +
this how to page will be migrated as contrib page for the FWS contrib
 +
===Version===
 +
{{#smeversion: smeserver-ntop }}
 +
[[Version::contrib9|fws]][[Has SME9::true| ]]
 +
 +
===Installation ===
 +
SME9
 +
yum install smeserver-extrarepositories-fws smeserver-extrarepositories-epel
 +
yum install smeserver-ntop --enablerepo=fws,epel
 +
 +
 +
==previous How-to==
 +
 +
===DRAFT HOWTO===
 +
This procedure has initialisation problems with the configuration file when performing the startup of ntop. Published here for test purposes only and for testers to help resolve the problem.
 +
 +
Refer to [http://forums.contribs.org/index.php/topic,44570.0.html/ this forum post]
 +
 +
ie when doing
 +
/etc/init.d/ntop start
 +
the following error is received
 +
Starting ntop:    Processing file /etc/ntop.conf for parameters...
 +
Sat Aug  8 21:18:04 2009  NOTE: Interface merge enabled by default
 +
Sat Aug  8 21:18:05 2009  Initializing gdbm databases
 +
FATAL ERROR: Unrecognized/unprocessed ntop options...
 +
                                          ,    --user ntop, ,  --db-file-path /var/ntop, ,     
 +
,    ,      --use-syslog, ,    ,      ,    ,        ,    ,   
 +
 +
 +
Note that manually starting ntop works, and it listens on port 3000, but if you connect (even from localhost), it aborts with a RST packet and logs nothing.
 +
 +
This behaviour appears to be documented here: http://lists.ntop.org/pipermail/ntop-dev/2004-January/004104.html
 +
 +
A strace shows it's just sitting there,
 +
 +
nanosleep({10, 0}, {0, 0})              = 0
 +
 +
 
===Description===
 
===Description===
 
ntop is a network monitoring tool/traffic probe that shows network usage in graphical form. A web browser is used to view traffic information and network status. For more information look [http://www.ntop.org/ here].
 
ntop is a network monitoring tool/traffic probe that shows network usage in graphical form. A web browser is used to view traffic information and network status. For more information look [http://www.ntop.org/ here].
Line 6: Line 45:
  
 
====Configuring Dag repository====
 
====Configuring Dag repository====
{{Repository|Dag}}
+
You need to activate the [[Dag]] reposity before installing this contrib.<br />
 +
 
 +
see [[dag|dag repository]] <br />
  
 
===Installation===
 
===Installation===
Line 18: Line 59:
 
  chkconfig ntop on
 
  chkconfig ntop on
 
  config set ntop service status enabled TCPPort 3000 access private
 
  config set ntop service status enabled TCPPort 3000 access private
 +
 +
Then run ntop manually from the command line and enter the admin password
 +
ntop -u ntop
 +
Enter the admin password when asked, and re-enter it when asked to confirm
 +
 +
Messages will scroll down the screen and then appear to freeze, press
 +
Ctrl C
 +
at the same time to exit. You should see the message
 +
ntop is now quitting...
 +
  
 
Note: In order to limit the use of system resources, you may only wish to run ntop as required for testing and analysing your system rather than running it continuously.
 
Note: In order to limit the use of system resources, you may only wish to run ntop as required for testing and analysing your system rather than running it continuously.
Line 27: Line 78:
  
 
To configure ntop to start automatically at boot time do the following
 
To configure ntop to start automatically at boot time do the following
  ln -s /etc/rc.d/init.d/e-smith-service /etc/rc7.d/S83ntop  
+
  ln -s /etc/rc.d/init.d/e-smith-service /etc/rc7.d/S83ntop
  
 
===Usage===
 
===Usage===
Line 60: Line 111:
  
 
Remove packages
 
Remove packages
  yum remove ntop
+
  yum remove ntop libart_lgpl perl_rrdtool rrdtool
 +
signal-event post-upgrade
 +
signal-event reboot
 +
 
 
Note: confirm that only the following packages are marked for removal before acknowledging
 
Note: confirm that only the following packages are marked for removal before acknowledging
  
  ntop           i386 3.3.8-2.el4.rf
+
  ntop
  libart_lgpl   i386 2.3.16-3
+
  libart_lgpl
  perl-rrdtool   i386 1.2.30-1.el4.rf
+
  perl-rrdtool
  rrdtool       i386 1.2.30-1.el4.rf
+
  rrdtool
  
 
===Feature Overview===
 
===Feature Overview===
 
See [http://www.ntop.org/overview.html/ here]
 
See [http://www.ntop.org/overview.html/ here]
 +
 +
 +
=== Bugs ===
 +
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 +
and select the smeserver-mailsorting component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ntop|title=this link}}.
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-ntop|noresultsmessage="No open bugs found."}}
 +
 +
 +
===Changelog===
 +
Only versions released in smecontrib are listed here.
 +
 +
{{#smechangelog: smeserver-ntop}}
  
 
----
 
----
[[Category: Howto]]
+
[[Category: Contrib]]
[[Category: Administration]]
+
[[Category: Administration:Monitoring]]

Latest revision as of 05:16, 18 April 2021

Warning.png Work in Progress:
This page is a Work in Progress. The contents off this page may be in flux, please have a look at this page history the to see list of changes.


this how to page will be migrated as contrib page for the FWS contrib

Version

smeserver-ntop
The latest version of smeserver-ntop is available in the SME repository, click on the version number(s) for more information.


fws

Installation

SME9

yum install smeserver-extrarepositories-fws smeserver-extrarepositories-epel
yum install smeserver-ntop --enablerepo=fws,epel


previous How-to

DRAFT HOWTO

This procedure has initialisation problems with the configuration file when performing the startup of ntop. Published here for test purposes only and for testers to help resolve the problem.

Refer to this forum post

ie when doing

/etc/init.d/ntop start

the following error is received

Starting ntop:    Processing file /etc/ntop.conf for parameters...
Sat Aug  8 21:18:04 2009  NOTE: Interface merge enabled by default
Sat Aug  8 21:18:05 2009  Initializing gdbm databases
FATAL ERROR: Unrecognized/unprocessed ntop options...
                                         ,     --user ntop, ,   --db-file-path /var/ntop, ,       
,     ,       --use-syslog, ,     ,       ,     ,         ,     ,     


Note that manually starting ntop works, and it listens on port 3000, but if you connect (even from localhost), it aborts with a RST packet and logs nothing.

This behaviour appears to be documented here: http://lists.ntop.org/pipermail/ntop-dev/2004-January/004104.html

A strace shows it's just sitting there,

nanosleep({10, 0}, {0, 0}) = 0


Description

ntop is a network monitoring tool/traffic probe that shows network usage in graphical form. A web browser is used to view traffic information and network status. For more information look here.

Prerequisites

To install ntop the Dag repository must be configured on your system. By default the Dag repo is not configured on sme server. If necessary follow this instruction to configure the repo, otherwise skip to the next section

Configuring Dag repository

You need to activate the Dag reposity before installing this contrib.

see dag repository

Installation

With the Dag repository configured, install as follows:

yum install ntop --enablerepo=dag
signal-event post-upgrade
signal-event reboot

Starting and Stopping ntop

Issue the following commands

chkconfig ntop on
config set ntop service status enabled TCPPort 3000 access private

Then run ntop manually from the command line and enter the admin password

ntop -u ntop

Enter the admin password when asked, and re-enter it when asked to confirm

Messages will scroll down the screen and then appear to freeze, press

Ctrl C

at the same time to exit. You should see the message

ntop is now quitting...


Note: In order to limit the use of system resources, you may only wish to run ntop as required for testing and analysing your system rather than running it continuously.

To manually start, stop and restart ntop do either of the following

/etc/init.d/ntop start
/etc/init.d/ntop stop
/etc/init.d/ntop restart

To configure ntop to start automatically at boot time do the following

ln -s /etc/rc.d/init.d/e-smith-service /etc/rc7.d/S83ntop

Usage

From the local network (LAN)

ntop provides its own default web server on port 3000:

http://yourserverIP:3000

From the Internet (WAN)

To access ntop remotely, setup SSH port forwarding (eg using PuTTY on Windows):

ssh -l root -L 3000:localhost:3000 <yourserverIP or yourservername>

Then open a web browser at:

http://localhost:3000 

From a handheld device (PDA)

A PDA (WAP) plugin is available which can access ntop via:

http://yourserverIP:3000/plugins/PDAPlugin

Removal

If you have permanenty enabled ntop do the following

rm /etc/rc7.d/S83ntop

Stop ntop

/etc/init.d/ntop stop

Delete services

chkconfig ntop off
config delete ntop

Remove packages

yum remove ntop libart_lgpl perl_rrdtool rrdtool
signal-event post-upgrade
signal-event reboot

Note: confirm that only the following packages are marked for removal before acknowledging

ntop
libart_lgpl
perl-rrdtool
rrdtool

Feature Overview

See here


Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-mailsorting component or use this link .

IDProductVersionStatusSummary (2 tasks)
12152SME Contribs10.0CONFIRMEDimport to sme10
12017SME Contribs10.0CONFIRMEDadd contrib to backup list [smeserver-ntop]


Changelog

Only versions released in smecontrib are listed here.