


INSTALL(1)                    14all                    INSTALL(1)


11114444aaaallllllll IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn aaaannnndddd bbbbaaaassssiiiicccc ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
       This document describes the installation of the cgi script
       14all.cgi.

       14all.cgi displays web pages and graphics from rrdtool
       files. In most cases it will be used together with MRTG.

       IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn


       Script placement
           Put the file 14all.cgi in a directory where the web
           server allows execution of cgi scripts. It has to be
           readable and executable by the user id the web server
           runs. If you use the 'sgid' or 'suid' installation
           method it might have to be world readable.

       Script execution line
           Check the first line of the cgi script: It has to
           contain the full path to the perl interpreter. It
           should look like this:

           #!/usr/bin/perl -w

           or

           #!/usr/local/bin/perl -w

           If you get an error message like

           bbbbaaaasssshhhh:::: 11114444aaaallllllll....ccccggggiiii:::: ccccoooommmmmmmmaaaannnndddd nnnnooootttt ffffoooouuuunnnndddd

           the first line of the script might be wrong.

       CCCChhhhoooooooossssiiiinnnngggg tttthhhheeee ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn ffffiiiilllleeee

       Create a config file (see config.txt for syntax) and make
       sure the cgi can find it. There are several ways to tell
       the cgi which config file to use:

       hard coded in the script
           Write the config file name into the script. There is a
           section where the perl variable _$_c_f_g_f_i_l_e is set.
           Change the appropriate line. You can use a relative or
           absolute path. A relative path will be relative to the
           directory where the cgi is installed.

       with a CGI parameter
           The cgi accepts a parameter to select the config file.
           Create a web page which calls the cgi with the
           appended string

           ?cfg=file.cfg




10/Jul/2000                14all 1.0p13                         1





INSTALL(1)                    14all                    INSTALL(1)


           where "file.cfg" is your config file. This can be a
           relative or absolute path. A relative path will be
           relative to the irectory where the cgi is installed or
           the directory given in the perl variable $$$$ccccffffggggffffiiiilllleeeeddddiiiirrrr
           in the cgi script. You can change this variable in the
           script to put your config files in a different
           directory.

       through the script's name
           If no config filename is set in the script or given as
           parameter the script will build a file name from the
           script name by replacing the ending ".cgi" by ".cgi".
           I.e. if your config file is "mrtg.cfg" install the cgi
           as "mrtg.cgi" (or create a symbolic link) and the cgi
           will use your config file.










































10/Jul/2000                14all 1.0p13                         2


