|
|
Line 1: |
Line 1: |
− | Networking → How to Install and Configure MRTG on Ubuntu Server
| + | Sumber: https://www.howtoforge.com/tutorial/how-to-install-and-configure-mrtg-on-ubuntu-1804/ |
| | | |
− | 200 Comments
| |
− | August 13th, 2009 by iceflatline
| |
| | | |
− | (20140528) – The steps in this post were amended to address changes in recent versions of software. Minor editorial corrections were also made. — iceflatline
| |
| | | |
− | This post will describe how to install and configure Tobi Oetiker’s MRTG (Multi Router Traffic Grapher) on your Ubuntu server. All steps assume that the Apache http server is installed and operating correctly. Once configured, you’ll be able to use MRTG to monitor the traffic in and out of your network using the SNMP capability in your network’s gateway\router. MRTG generates static HTML pages containing PNG images which provide a visual representation of this traffic. MRTG typically produces daily, weekly, monthly, and yearly graphs. MRTG is written in perl and works on Unix/Linux as well as Windows. MRTG is free software licensed under the GNU GPL.
| + | MRTG also known as "Multi Router Traffic Grapher" is a free and open source tool to monitor the traffic load on network links. You can monitor daily, weekly, monthly and yearly network traffic using MRTG. MRTG supports for Windows and Linux operating system. MRTG provides a simple web interface to display network traffic data in graphical form. |
| | | |
− | Software versions used in this post were as follows:
| + | In this tutorial, we will learn how to install MRTG on Ubuntu 18.04 server. |
− | Ubuntu Server v14.04 x64 LTS) | + | Requirements |
− | mrtg_2.17.4-2ubuntu2_amd64
| |
| | | |
− | So, let’s get started.
| + | A server running Ubuntu 18.04. |
| + | A non-root user with sudo privileges. |
| | | |
− | Download and Install
| + | Install Required Packages |
| | | |
− | First, update your package list:
| + | Before starting, you will need to install some packages to your system. You can install all of them by running the following command: |
− | sudo apt-get update
| |
| | | |
− | Then download and install MRTG:
| + | sudo apt-get install apache2 snmp snmpd -y |
− | sudo apt-get install mrtg | |
| | | |
− | If this is the first time installing MRTG on your server you’ll likely be presented with the following message (See Figure 1). Answering “Yes” means that the MRTG configuration file will not be readable by others (file permissions set to 640). Answering “No” means that the file is readable by others (file permissions set to 644). In this example we’re going to accept the default Yes.
| + | Once all the packages are installed, start apache and snmp service and enable them to start on boot with the following command: |
| | | |
− | Screenshot showing install message regarding MRTG file permissions
| + | sudo systemctl start apache2 |
− | Figure 1
| + | sudo systemctl enable apache2 |
| + | sudo systemctl start snmpd |
| + | sudo systemctl enable snmpd |
| | | |
− | MRTG installs a sample configuration file /etc/mrtg.cfg used to hold the SNMP information obtained from your gateway\router. For a full listing of what MRTG installs and where, run the locate command: | + | Install and Configure MRTG |
− | sudo updatedb && locate mrtg
| |
| | | |
− | Technically speaking, mrtg.cfg could remain in /etc, but just to keep things tidy let’s create a directory for it and move it into that directory:
| + | By default, MRTG is available in the Ubuntu 18.04 default repository. You can install it by just running the following command: |
− | sudo mkdir /etc/mrtg && sudo mv /etc/mrtg.cfg /etc/mrtg
| |
| | | |
− | That’s it for installing MRTG. Now let’s move on and configure it.
| + | sudo apt-get install mrtg -y |
| | | |
− | Configure
| + | After installing MRTG, you will need to configure it to monitoring target devices. First, create a MRTG directory inside Apache root directory: |
| | | |
− | MRTG includes a script called cfgmaker that will help us populate /etc/mrtg/mrtg.cfg with the information obtained from your gateway\router. But before you run cfgmaker, you should setup the SNMP service in your gateway\router. This usually involves logging into your gateway\router and enabling SNMP. The default SNMP community name is typically “public.” If you change the SNMP community name to something else, make note of it. Now, run the following command, substituting your SNMP community name, if you’ve changed it, and adding the IP address of your gateway\router:
| |
− | sudo cfgmaker --output=/etc/mrtg/mrtg.cfg public@your-router's-IP-address
| |
− |
| |
− | If you would like to add more than one gateway\router to MRTG simply append the additional URL(s) to the same mrtg.cfg file. Then, when you build the web page using the indexmaker command described below, all the gateway\routers (and their associated graphs) will be displayed on the same HTML page.
| |
− | 1 sudo cfgmaker --output /etc/mrtg/mrtg.cfg public@the-first-router's-IP-address public@the-second-router's-IP-address
| |
− |
| |
− | Next, open /etc/mrtg/mrtg.cfg and make sure under Global Configuration Options that the lines “WorkDir: /var/www/mrtg” (under Debian), and “Options[_]: growright, bits” (under Global Defaults) are uncommented. Finally, add the following lines to the existing line EnableIPv6: nounder the Global Defaults section:
| |
− | RunAsDaemon: Yes
| |
− | Interval: 5
| |
− |
| |
− | What does all this do? The line RunAsDaemon: Yes will enable MRTG to…um… run as a daemon. This is beneficial because MRTG is launched only once, thus the parsing of the /etc/mrtg/mrtg.cfg file is done only once, not repeatedly as would be the case if one were to run MRTG as a cron task – another acceptable method for running MRTG. Also, when running as a daemon, MRTG itself is responsible for timing the measurement intervals; therefore, we need to add the Interval line option and assign it a value – in this example 5. This means that every five minutes MRTG will poll the SNMP service in your gateway\router and update its graphs. We’ve also provided MRTG a directory to place its log file using the Logdir option, and finally, because many gateway\routers do not currently support SNMP over IPv6, we’ll retain the line EnableIPv6: no.
| |
− |
| |
− | Speaking of graphs, by default MRTG graphs grow to the left, so by adding the option “growright” the direction of the traffic visible in MRTG’s graphs flips causing the current time to be at the right edge of the graph and the history values to the left. We’ve also chosen the “bits” option, which means that the monitored traffic values obtained from your gateway\router are multiplied by 8 and displayed bits per second instead of bytes per second.
| |
− |
| |
− | Okay, now it’s time to create the web pages which display the MRTG graphs using the indexmaker command. Run the following commands:
| |
| sudo mkdir /var/www/mrtg | | sudo mkdir /var/www/mrtg |
− | sudo indexmaker --output=/var/www/mrtg/index.html /etc/mrtg/mrtg.cfg
| |
− |
| |
− | Open /etc/apache2/apache.conf and add the following lines in the section containing similar Directory directives:
| |
− | 1 Alias /mrtg "/var/www/mrtg/"
| |
− | 2
| |
− | 3 <Directory "/var/www/mrtg/">
| |
− | 4 Options None
| |
− | 5 AllowOverride None
| |
− | 6 Require all granted
| |
− | 7 </Directory>
| |
− |
| |
− | Then restart Apache:
| |
− | sudo service apache2 restart
| |
| | | |
− | When restarting Apache you may receive a warning concerning its inability to “…reliably determine the server’s fully qualified domain name…” This non-critical error can be fixed by adding the following line to /etc/apache2/apache.conf:
| + | Next, give proper ownership to the mrtg directory: |
− | ServerName locahost:80
| |
| | | |
− | MRTG has been configured. Let’s start it up and see what it displays.
| + | sudo chown -R www-data:www-data /var/www/mrtg |
| | | |
− | Start
| + | Next, rebuild MRTG configuration with the following command: |
| | | |
− | There’s something important to keep in mind when starting MRTG, and that is that MRTG requires the environmental variable “LANG” to be C in order to run properly. Since most Linux systems these days, including Ubuntu server, use UTF-8 (run echo $LANG to see what your system uses), let’s change LANG to C and start MRTG using the following command:
| + | sudo cfgmaker public@localhost > /etc/mrtg.cfg |
− | sudo env LANG=C /usr/bin/mrtg /etc/mrtg/mrtg.cfg --logging /var/log/mrtg.log | |
| | | |
− | When you run MRTG for the first time you may see a lot of complaints about missing log files. No worries, this is normal for the first 2-3 times you start MRTG this way. If, however, it continues to complain you may want to look into the source of the problem.
| + | You should see the following output: |
| | | |
− | Well, that’s it. Now point your browser to http://your-server-address/mrtg and you should see a page that resembles Figure 2. You may have more or less graphs depending on the number of interfaces reported by your gateway\router(s).
| + | cfgmaker public@localhost > /etc/mrtg.cfg |
| + | --base: Get Device Info on public@localhost: |
| + | --base: Vendor Id: Unknown Vendor - 1.3.6.1.4.1.8072.3.2.10 |
| + | --base: Populating confcache |
| + | --base: Get Interface Info |
| + | --base: Walking ifIndex |
| + | --base: Walking ifType |
| + | --base: Walking ifAdminStatus |
| + | --base: Walking ifOperStatus |
| + | --base: Walking ifMtu |
| + | --base: Walking ifSpeed |
| | | |
− | Screenshot showing the default MRTG web page
| + | Next, Create an index file for the /web server with the following command: |
− | Figure 2
| |
| | | |
− | Because of the aforementioned option in /etc/mrtg/mrtg.cfg, you’ll see the graph starting “grow” to the right as the traffic is monitored over time, and the Y axis displayed as bits per second. If you click on any one of these graphs you’ll be taken to another page showing individual graphs for 30 minute, two hour, and daily averages, along with the maximum, average, and current bit rate in and out of that particular interface. Only interested in displaying one particular interface? Don’t like the look of the page? No worries, just edit /etc/mrtg/mrtg.cfg and/or /var/www/mrtg/index.html until you get pages looking the way you want.
| + | sudo indexmaker /etc/mrtg.cfg > /var/www/mrtg/index.html |
| | | |
− | Okay, so now that we have MRTG installed, configured and running let’s move on and discuss how to keep it running.
| + | Configure Apache for MRTG |
| | | |
− | Operate
| + | Next, you will need to create an apache virtual host file for MRTG. You can do this with the following command: |
| | | |
− | Starting MRTG by hand is not ideal in the long run. So perhaps after you’ve done some tweaking on MRTG and are satisfied with the results, you can automate the process of running MRTG by using a startup script in your system startup sequence. Here’s the script that I use:
| + | sudo nano /etc/apache2/sites-available/mrtg.conf |
− | 1 #! /bin/sh
| |
− | 2 ### BEGIN INIT INFO
| |
− | 3 # Provides: mrtg
| |
− | 4 # Required-Start:
| |
− | 5 # Required-Stop:
| |
− | 6 # Default-Start: 2 3 4 5
| |
− | 7 # Default-Stop: 0 1 6
| |
− | 8 # Short-Description: mrtg init script
| |
− | 9 # Description: This file is used to start, stop, restart,
| |
− | 10 # and determined status of the mrtg daemon.
| |
− | 11 # Author: iceflatline <iceflatline@gmail.com>
| |
− | 12 ### END INIT INFO
| |
− | 13
| |
− | 14 ### START OF SCRIPT
| |
− | 15 set -e
| |
− | 16 # PATH should only include /usr/* if it runs after the mountnfs.sh script
| |
− | 17 PATH=/sbin:/usr/sbin:/bin:/usr/bin
| |
− | 18 DESC="mrtg"
| |
− | 19 NAME=mrtg
| |
− | 20 DAEMON=/usr/bin/$NAME
| |
− | 21 DAEMON_ARGS="/etc/mrtg/mrtg.cfg --logging /var/log/mrtg.log"
| |
− | 22 PIDFILE=/etc/mrtg/$NAME.pid
| |
− | 23 SCRIPTNAME=/etc/init.d/$NAME
| |
− | 24
| |
− | 25 # Exit if the mrtg package is not installed
| |
− | 26 [ -x "$DAEMON" ] || exit 0
| |
− | 27
| |
− | 28 # Load the VERBOSE setting and other rcS variables
| |
− | 29 . /lib/init/vars.sh
| |
− | 30
| |
− | 31 # Define LSB log_* functions.
| |
− | 32 # Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
| |
− | 33 . /lib/lsb/init-functions
| |
− | 34
| |
− | 35 # Function that starts the mrtg daemon
| |
− | 36 start()
| |
− | 37 {
| |
− | 38 env LANG=C start-stop-daemon --start --quiet \
| |
− | 39 --exec $DAEMON -- $DAEMON_ARGS
| |
− | 40 }
| |
− | 41
| |
− | 42 # Function that stops the mrtg daemon
| |
− | 43 stop()
| |
− | 44 {
| |
− | 45 start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 \
| |
− | 46 --pidfile $PIDFILE
| |
− | 47 }
| |
− | 48
| |
− | 49 case "$1" in
| |
− | 50 start)
| |
− | 51 log_daemon_msg "Starting $DESC"
| |
− | 52 start
| |
− | 53 case "$?" in
| |
− | 54 0) log_end_msg 0 ;;
| |
− | 55 1) log_end_msg 1 ;;
| |
− | 56 esac
| |
− | 57 ;;
| |
− | 58 stop)
| |
− | 59 log_daemon_msg "Stopping $DESC"
| |
− | 60 stop
| |
− | 61 case "$?" in
| |
− | 62 0) log_end_msg 0 ;;
| |
− | 63 1) log_end_msg 1 ;;
| |
− | 64 esac
| |
− | 65 ;;
| |
− | 66 restart|force-reload)
| |
− | 67 log_daemon_msg "Restarting $DESC"
| |
− | 68 stop
| |
− | 69 case "$?" in
| |
− | 70 0|1)
| |
− | 71 start
| |
− | 72 case "$?" in
| |
− | 73 0) log_end_msg 0 ;;
| |
− | 74 1) log_end_msg 1 ;;
| |
− | 75 esac
| |
− | 76 ;;
| |
− | 77 esac
| |
− | 78 ;;
| |
− | 79 status)
| |
− | 80 status_of_proc "$DAEMON" "$NAME"
| |
− | 81 ;;
| |
− | 82 *)
| |
− | 83 echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload}"
| |
− | 84 ;;
| |
− | 85 esac
| |
− | 86 exit 0
| |
− | 87 ### END OF SCRIPT
| |
| | | |
− | To use the script, save it to your home directory as mrtg and make it executable. Then move or copy it to /etc/init.d:
| + | Add the following lines: |
− | cd ~
| |
− | chmod +x mrtg
| |
− | sudo mv mrtg /etc/init.d/
| |
| | | |
− | Now, link the mrtg script to all of Ubuntu server’s multi-user run levels (2-5):
| + | <VirtualHost *:80> |
− | sudo update-rc.d mrtg defaults
| + | ServerAdmin admin@yourdomain.com |
| + | DocumentRoot "/var/www/mrtg" |
| + | ServerName yourdomain.com |
| + | <Directory "/var/www/mrtg/"> |
| + | Options None |
| + | AllowOverride None |
| + | Order allow,deny |
| + | Allow from all |
| + | Require all granted |
| + | </Directory> |
| + | TransferLog /var/log/apache2/mrtg_access.log |
| + | ErrorLog /var/log/apache2/mrtg_error.log |
| + | </VirtualHost> |
| | | |
− | Now, let’s start MRTG using our script. If it’s currently running then substitute restart for start in the following command:
| + | Save and Close the file, when you are finished. Then enable virtual host and restart apache service to apply all the changes: |
− | sudo service mrtg start
| |
| | | |
− | That’s it. Now if for some reason your server is rebooted, MRTG should fire up automatically. If you would like to remove the MRTG script from the server’s multi-user run levels, use the command sudo update-rc.d -f mrtg remove).
| + | sudo a2ensite mrtg |
| + | sudo systemctl restart apache2 |
| | | |
− | Conclusion
| + | Now, open your web browser and type the URL http://yourdomain.com. You will be redirected to the following page: |
| | | |
− | This concludes the post on how to install and configure MRTG on Ubuntu server. As you can see, MRTG isn’t terribly complicated and proves to be a really nice open source package for monitoring and displaying traffic in and out your network from virtually anywhere you have a web browser. For a full list of all the configuration options and other information I encourage you to visit the MRTG web site.
| |
| | | |
| | | |
| ==Referensi== | | ==Referensi== |
| | | |
− | * http://oss.oetiker.ch/mrtg/doc/index.en.html
| + | * https://www.howtoforge.com/tutorial/how-to-install-and-configure-mrtg-on-ubuntu-1804/ |
− | * http://lqman.wordpress.com/2011/10/22/network-monitoring-dengan-mrtg-dan-shorewall-ip-accounting/
| |
− | * https://www.iceflatline.com/2009/08/how-to-install-and-configure-mrtg-on-ubuntu-server/ | |
| | | |
| ==Pranala Menarik== | | ==Pranala Menarik== |
| | | |
− | * [[Linux Howto]] | + | * [[SNMP]] |
Sumber: https://www.howtoforge.com/tutorial/how-to-install-and-configure-mrtg-on-ubuntu-1804/
MRTG also known as "Multi Router Traffic Grapher" is a free and open source tool to monitor the traffic load on network links. You can monitor daily, weekly, monthly and yearly network traffic using MRTG. MRTG supports for Windows and Linux operating system. MRTG provides a simple web interface to display network traffic data in graphical form.
In this tutorial, we will learn how to install MRTG on Ubuntu 18.04 server.
Requirements
A server running Ubuntu 18.04.
A non-root user with sudo privileges.
Install Required Packages
Before starting, you will need to install some packages to your system. You can install all of them by running the following command:
sudo apt-get install apache2 snmp snmpd -y
Once all the packages are installed, start apache and snmp service and enable them to start on boot with the following command:
sudo systemctl start apache2
sudo systemctl enable apache2
sudo systemctl start snmpd
sudo systemctl enable snmpd
Install and Configure MRTG
By default, MRTG is available in the Ubuntu 18.04 default repository. You can install it by just running the following command:
sudo apt-get install mrtg -y
After installing MRTG, you will need to configure it to monitoring target devices. First, create a MRTG directory inside Apache root directory:
sudo mkdir /var/www/mrtg
Next, give proper ownership to the mrtg directory:
sudo chown -R www-data:www-data /var/www/mrtg
Next, rebuild MRTG configuration with the following command:
sudo cfgmaker public@localhost > /etc/mrtg.cfg
You should see the following output:
cfgmaker public@localhost > /etc/mrtg.cfg
--base: Get Device Info on public@localhost:
--base: Vendor Id: Unknown Vendor - 1.3.6.1.4.1.8072.3.2.10
--base: Populating confcache
--base: Get Interface Info
--base: Walking ifIndex
--base: Walking ifType
--base: Walking ifAdminStatus
--base: Walking ifOperStatus
--base: Walking ifMtu
--base: Walking ifSpeed
Next, Create an index file for the /web server with the following command:
sudo indexmaker /etc/mrtg.cfg > /var/www/mrtg/index.html
Configure Apache for MRTG
Next, you will need to create an apache virtual host file for MRTG. You can do this with the following command:
sudo nano /etc/apache2/sites-available/mrtg.conf
Add the following lines:
<VirtualHost *:80>
ServerAdmin admin@yourdomain.com
DocumentRoot "/var/www/mrtg"
ServerName yourdomain.com
<Directory "/var/www/mrtg/">
Options None
AllowOverride None
Order allow,deny
Allow from all
Require all granted
</Directory>
TransferLog /var/log/apache2/mrtg_access.log
ErrorLog /var/log/apache2/mrtg_error.log
</VirtualHost>
Save and Close the file, when you are finished. Then enable virtual host and restart apache service to apply all the changes:
sudo a2ensite mrtg
sudo systemctl restart apache2
Now, open your web browser and type the URL http://yourdomain.com. You will be redirected to the following page:
Referensi
Pranala Menarik