Difference between revisions of "Ntop"

From ArchWiki
Jump to: navigation, search
m (Updates)
(26 intermediate revisions by 12 users not shown)
Line 1: Line 1:
[[Category:Networking (English)]]
+
[[Category:Networking]]
[[Category:HOWTOs (English)]]
+
[[it:Ntop]]
==Introduction==
+
[http://www.ntop.org/products/ntop/ Ntop] is a network traffic probe based on [http://www.tcpdump.org/ libcap], that offers RMON-like network traffic statistics accessible via a web browser.
Ntop is a network traffic probe based on [http://www.tcpdump.org/ libcap], that offers RMON-like network traffic statistics accessible via a web browser.
+
  
==Installation & Configuration==
+
== Installation and configuration ==
*Ntop is available in the Extra repository
+
# pacman -S ntop
+
*Before running ntop, you must set the admin password while logged in as root (or via sudo)
+
# ntop --set-admin-password=''password''
+
*Next, start the ntop service:
+
# /etc/rc.d/ntop start
+
*Also, if preferred, add ntop to DAEMONS list in /etc/rc.conf to start process automatically at boot
+
  
 +
[[pacman|Install]] {{Pkg|ntop}} from the [[official repositories]].
 +
The first run of ntop, you must set the admin password:
 +
# ntop
 +
Next, you need to edit the configuration file ({{ic|/etc/conf.d/ntop}}) to adapt on your needs. Below is an example configuration, with the focus on the host to get as much as information from the hosts connections:
 +
{{hc|/etc/conf.d/ntop|<nowiki>
 +
# Parameters to be passed to ntop.
 +
NTOP_ARGS="-K -W 2323 -i enp1s0,wlp2s0 -M -s -4 -6 -s -u ntop -c -r 30 -w3c -t 3 -a /var/log/ntop/http.log -O /var/log/ntop/ -q --skip-version-check 0"
  
==Access ntop web interface==
+
# Location of the log file.
*To access ntop's web interface, enter http://127.0.0.1:3000/ into your web browser. To make changes to the server, you will need to enter your username (admin) and password.
+
NTOP_LOG="/var/log/ntop/ntop.log"
 +
</nowiki>}}
 +
Start the ntop service:
 +
# systemctl start ntop
 +
If you want to start ntop at boot enable the relative [[Systemd]] service:
 +
# systemctl enable ntop
 +
 
 +
== Tips and tricks ==
 +
 
 +
=== Web interface ===
 +
 
 +
To access ntop's web interface, enter [http://127.0.0.1:3000/ http://127.0.0.1:3000/] into your web browser. To make changes to the server, you will need to enter your username (default = ''admin'') and password.
 +
 
 +
If ntop is not just used locally on your machine, but network wide by multiple users, you'd be better off by allowing SSL connections (http'''s''') '''only'''.
 +
 
 +
# ntop -w 4223
 +
 
 +
Additional paramethers are allowed. Now direct our browser to [https://127.0.0.1:4223/ https://127.0.0.1:4223/].
 +
 
 +
You can also provide ntop with your own SSL certificate. Simply put it in ntop's config directory and name it '''ntop-cert.pem'''
 +
 
 +
# cd /etc/ntop/
 +
# openssl req -x509 -nodes -days 365
 +
  \-subj '/C=US/L=Portland/CN=swim'
 +
  \-newkey rsa:1024 -keyout ntop-cert.pem -out ntop-cert.pem
 +
 
 +
=== Group and user ===
 +
 
 +
In order that the ''-u'' parameter is able to work properly and to secure your ntop setup a bit more, you should create an own group and user for it.
 +
 
 +
# useradd -M -s /sbin/nologin ntop
 +
# passwd -l ntop
 +
 
 +
{{Note|The {{ic|passwd}} command here is optional, but recommended, as it will render the system more secure regarding your sshd.}}
 +
 
 +
== Troubleshooting ==
 +
 
 +
=== **ERROR** RRD: Disabled - unable to create base directory (err 13, /var/lib/ntop/rrd) ===
 +
 
 +
Directory {{ic|/var/lib/ntop/rrd/}} may not exist. Create it and make sure it belongs to user nobody.
 +
 
 +
=== Please enable make sure that the ntop html/ directory is properly installed ===
 +
 
 +
If you receive this warning while trying to access the web interface, edit /etc/conf.d/ntop to include your IP and restart the daemon. For example:
 +
 
 +
NTOP_ARGS="-i enp1s0 -w 127.0.0.1:3000"
 +
 
 +
This is the IP you will use to access the web interface.

Revision as of 13:23, 30 May 2013

Ntop is a network traffic probe based on libcap, that offers RMON-like network traffic statistics accessible via a web browser.

Installation and configuration

Install ntop from the official repositories. The first run of ntop, you must set the admin password:

# ntop

Next, you need to edit the configuration file (/etc/conf.d/ntop) to adapt on your needs. Below is an example configuration, with the focus on the host to get as much as information from the hosts connections:

/etc/conf.d/ntop
# Parameters to be passed to ntop.
NTOP_ARGS="-K -W 2323 -i enp1s0,wlp2s0 -M -s -4 -6 -s -u ntop -c -r 30 -w3c -t 3 -a /var/log/ntop/http.log -O /var/log/ntop/ -q --skip-version-check 0"

# Location of the log file.
NTOP_LOG="/var/log/ntop/ntop.log"

Start the ntop service:

# systemctl start ntop

If you want to start ntop at boot enable the relative Systemd service:

# systemctl enable ntop

Tips and tricks

Web interface

To access ntop's web interface, enter http://127.0.0.1:3000/ into your web browser. To make changes to the server, you will need to enter your username (default = admin) and password.

If ntop is not just used locally on your machine, but network wide by multiple users, you'd be better off by allowing SSL connections (https) only.

# ntop -w 4223

Additional paramethers are allowed. Now direct our browser to https://127.0.0.1:4223/.

You can also provide ntop with your own SSL certificate. Simply put it in ntop's config directory and name it ntop-cert.pem

# cd /etc/ntop/
# openssl req -x509 -nodes -days 365 
  \-subj '/C=US/L=Portland/CN=swim' 
  \-newkey rsa:1024 -keyout ntop-cert.pem -out ntop-cert.pem

Group and user

In order that the -u parameter is able to work properly and to secure your ntop setup a bit more, you should create an own group and user for it.

# useradd -M -s /sbin/nologin ntop
# passwd -l ntop
Note: The passwd command here is optional, but recommended, as it will render the system more secure regarding your sshd.

Troubleshooting

**ERROR** RRD: Disabled - unable to create base directory (err 13, /var/lib/ntop/rrd)

Directory /var/lib/ntop/rrd/ may not exist. Create it and make sure it belongs to user nobody.

Please enable make sure that the ntop html/ directory is properly installed

If you receive this warning while trying to access the web interface, edit /etc/conf.d/ntop to include your IP and restart the daemon. For example:

NTOP_ARGS="-i enp1s0 -w 127.0.0.1:3000"

This is the IP you will use to access the web interface.