.. _initial_configuration:

=======================
 Initial configuration
=======================

Node
====

Plugins
-------

Decide which plugins to use. The munin node runs all plugins present
in CONFDIR/plugins/

The quick auto-plug-and-play solution:

.. code-block:: bash

 munin-node-configure --shell --families=contrib,auto | sh -x

Access
------

The munin node listens on all interfaces by default, but has a
restrictive access list. You need to add your master's IP address.

The "cidr_allow", "cidr_deny", "allow" and "deny" statements are used.

cidr_allow uses the following syntax (the /32 is not implicit, so for
a single host, you need to add it):

    | cidr_allow 127.0.0.0/8
    | cidr_allow 192.0.2.1/32

allow uses regular expression matching against the client IP address.

    | allow '^127\.'
    | allow '^192\.0\.2\.1$'

For specific information about the syntax, see `Net::Server
<http://search.cpan.org/dist/Net-Server/lib/Net/Server.pod>`_. Please
keep in mind that cidr_allow is a recent addition, and may not be
available on all systems.

Startup
-------

Start the node agent (as root) SBINDIR/munin-node. Restart it if it
was already started. The node only discovers new plugins when it is
restarted.

You probably want to use an init-script instead and you might find a
good one under build/dists or in the build/resources directory (maybe
you need to edit the init script, check the given paths in the script
you might use).

Master
======

Add some nodes
--------------

Add some nodes to CONFDIR/munin.conf

[node.example.com]
  address 192.0.2.4

[node2.example.com]
  address node2.example.com

[node3.example.com]
  address 2001:db8::de:caf:bad

Configure web server
====================

On the master, you need to configure a web server.

If you have installed "munin" through distribution
packages, a webserver may have been configured for you already.

If you installed from source, there is a minimal configuration example
in the "resources" directory in the source tarball.

For a more complex example, see :ref:`example-webserver-apache`
