Here are links where you can find what you miss :

Once you have properly installed the whole list of required software , you can install Grillon. But you have to be 'root' to do such an installation. Once you have gained the 'root' rights, you just have to execute the following script : 'install.sh'.
(But before, don't forget to check that the 'root' user is able to create items on your local mysql server).

bash# ./install.sh

To complete this installation , answer the questions the script will ask.(path of your html root directory & apache user ID)

Once this installation is done, the following file hierarchy will appear under your htlm root directory :

|
|
 \your html root directory
        |
        |
         \grillon
                |
                |
                 \grillon php scripts
                |
                |
                 \templates
                        |
                        |
                         \template_mrtg.cfg
                         \template_add.cfg
        |
        |
         \grillon_data
                |
                |
                 \icons
                |
                |
                 \crontab.tab
                |
                |
                 \sav

template_mrtg.cfg & template_add.cfg represent a part of the original mrtg.cfg file & contain TAGS which will be updated by the grillon php scripts.

Both template files will finally be concatenated (once they will be well configured) to produce a global mrtg configuration file . This global configuration file will be named with the group name ((a group is composed of several sites/network equipments) Each of template files have a special role :

Moreover you will find int your /etc directory :

\etc
        |
        |
         \mrtg
                |
                |
                 \mrtg.cfg
        |
        |
         \grillon.conf

Where grillon.conf is the configuration file for grillon's php script collection.

To Install Grillon from the RPM package , just type this command : rpm -ivh grillon-X.XX.rpm (where X.XX represents the Grillon version number) If the dependencies test is OK it will install automatically the package.

Once installation process is over, you will have to configure Grillon and Apache to access to Grillon software.

	You will have to modify your Apache configuration in order to be able to use Grillon.
	You can choose between 2 solutions :
		-to create a virtual host for Grillon
		-to add a simple 'directory' to your html root directory for Grillon.

        <VirtualHost ip_address_of_your_web_server>
                ServerAdmin you_web_admin_email
                DocumentRoot your_html_root_directory/ (<--- same than the one you've provided during grillon installation)
                ServerName name_of_your_virtual_host_server
                ErrorLog file_where_to_log_error_for_this_virtual_host
                CustomLog file_where_to_log_acces_for_this_virtual_host common
        </VirtualHost>

Moreover to permit Apache to use mod_auth_mysql for authentication, for the both solutions, you have to uncomment or add the following line in Apache configuration file :

LoadModule mysql_auth_module modules/mod_auth_mysql.so
Add the following line to the <Directory /var/www/html > definition (if the document root of you web server is /var/www/html ) : AllowOverride All

Once you have modified the configuration file , relaunch the Apache server.

You will also have to configure the file your_html_root_directory/grillon/.htaccess correctly.

Once this is done, you will be able to access & use Grillon by entering the following url in your web browser :

The login used by default to access Grillon is 'test' and the password is 'test'. You also have an 'admin' profile, that you can use to manage :

For further details and forthcoming questions, feel free to email at peppers@chez.com

License

Copyright (C) 2002-2003 Johann Lallemand

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.