Welcome to MRTG
===============

> In order to MRTG build on a UNIX machine the following things are
> required.

  * a C compiler, preferably gcc or egcs 
  * a recent copy of perl, Version 5.004_4 should do -> www.perl.com

    >> in RedHat 5.2 there is a BROKEN version of Perl. Make sure you
       get an update from RedHat before continuing <<

  * the GD library from Thomas Boutell -> www.boutell.com

    >> if you have gdlib version < 1.6 mrtg will be configured to produce
       png images. For compilation this may require you to install libz
       and libpng. See gdlib documentation for details.
    
    >> if you are not experienced with handling shared libraries,
       make sure you build static versions of libz, libpng and libgd
       in their respective documentation you will find how this is done.

       you should end-up with a lib*.a and a set of *.h files for each of the
       libraries.

  Once these are in compiled and installed type:

  ./configure

  configure will make sure your evironment is fit for building mrtg
  if it finds a problem, it will tell you so and it will also tell
  you what todo about it. If everything is OK, you will end up with
  a custom Makefile for your system. Now type:

  make

  this builds the rateup binary and edits all the perl pathnames in
  the scripts. All the software required by MRTG is now in the run
  subdirectory.

> If you downloaded the zip archive for NT, there is a precompiled
> version of rateup in the run directory ...


The next step is to configure MRTG by writing a mrtg.cfg file. You can
either do this by hand, using the config.txt and the sample-mrtg.cfg
file in the doc subdirectory, or you can use the cfgmaker program in
the run directory.

In any case, make sure you read the mrtg documentation in the
doc subdirectory. Especially the manual.txt.

tobi oetiker <oetiker@ee.ethz.ch>
