-------------------------------------------
  * **munin** 
  * **Jonathan Haack**
  * **Haack's Networking**
  * **oemb1905@jonathanhaack.com**

-------------------------------------------

//munin//      

-------------------------------------------

This tutorial is for users of Debian who have already established a host with TLS/LAMP and want to create a [[http://munin-monitoring.org/|Munin]] instance to monitor the host.  If you have not yet completed that, please begin with [[https://wiki.haacksnetworking.com/doku.php?id=computing:apachesurvival|Apache Survival]].  Okay, as long as you have done that, let's proceed.  First, install Munin and the apache webserver modules required for it to run:

  sudo apt install munin libcgi-fast-perl libapache2-mod-fcgid
  
If you have WordPress CMS enabled on this same server, or Nextcloud, etc., then you will likely have the fast cgi module enabled already.  If not, then please enable as follows:

  sudo a2enmod fcgid
  
Once that is done, we need to configure to files that come with Munin to enable it to work on your host.  First, let's configure the primary configuration file:

  cd /etc/munin
  sudo nano munin.conf
  
Change the line that specifies the html directory here to reflect your location:
  
  <htmldir /var/www/site1.com/public_html/munin>
  
Change the "host tree" name to something unique.  Usually, "Munin" is sufficiently unique:

  [Munin]
    address 127.0.0.1
    use_node_name yes

Create the directory for munin, apply appropriate permissions.

  mkdir /var/www/site1.com/public_html/munin
  chown munin:munin /var/www/site1.com/public_html/munin

Now configure the apache virtual host that munin provides, and configure overrides so it can populate that directory with its webpages/metrics, etc.  After opening the file, go around and make sure the alias directory properly matches our entries above:

  sudo nano apache24.conf
  <Alias /munin /var/www/site1.com/public_html/munin>

After that, you need to change the override status, in the //primary block//, from:

  <Directory /var/cache/munin/www>
    Require local
    Options None
  </Directory>

To:

  <Directory /var/www/site1.com/public_html/munin/>
    Require all granted
    Options FollowSymLinks SymLinksIfOwnerMatch
  </Directory>

Once that is done, restart the web server and the munin services:

  sudo systemctl restart munin-node
  sudo systemctl restart apache2

The first thing you can do to verify your setup worked is navigate to the munin alias on your terminal and if it populated the munin webpages inside that directory, then the munin-node is working properly with apache.

  cd /var/www/site1.com/public_html/munin/
  ls -lah
  <If you succeed, munin will populate this directory with .html files and a few directories.>

That's all that is required for a directory set-up (not a node), so navigate to the site now as follows:

  https://site1.com/munin/
  
This should get you started!  My instance is located here:

  https://monitor.haacksnetworking.com/munin/
  
Happy hacking!

 --- //[[jonathan@haacksnetworking.com|oemb1905]] 2021/11/05 12:37//