NAME
lg.conf - looking glass configuration file
DESCRIPTION
lg.conf contains configuration for the looking glass scripts.
The syntax is that of perl(1). It is used to set variables that affect
run-time behavior and/or to locate resources.
VARIABLES
The following variables are used (alphabetically):
LG_AS_REG
*** not implemented.
LG_BGP_RT
Allows show ip bgp neighbor commands that can produce heavy
output, such as sh ip bgp neighbor <ip> advertised-routes for a
transit customer when the neighbor address is followed by
’advertised-routes’ for the sh ip bgp neighbor query.
LG_CACHE_DIR
Sets the location of the cache directory. The looking glass
uses this to hold lock files, log files, and output from cached
commands.
Default: ./tmp
Note that the default is relative to the directory where lg.cgi
runs in the server’s document root (e.g.:
/usr/local/www/data/lg/tmp).
LG_CACHE_TIME
Sets the number of seconds that the looking glass should cache
output from commands that tend to produce a lot of output, such
as ’show ip bgp dampened-paths’.
Default: 600
LG_CLOGINRC
Defines the location of the cloginrc(5) that the looking glass
should use. The path may be relative to the directory where the
CGI scripts run in the server’s document root.
Default: $HOME/.cloginrc
Note that the .cloginrc must be readable by the user or group
that will be running the CGI and that clogin(1) will not allow a
world readable .cloginrc. The user is normally that of the http
server (httpd).
LG_IMAGE
Defines a html image tag (<img>) which, if defined, will be
included at the top of the looking glass pages. It may contain
any html as it is simply handed off to print().
Example: $LG_IMAGE="<img src=/icons/rancid.gif hspace=0>\n <font
size=+2>FOO</font>";
LG_INFO
Defines information in html format which, if defined, will be
included at the bottom of the looking glass form page. It may
contain any html as it is simply handed off to print().
Example: $LG_INFO="For Support contact <a
href=mailto:webmaster@localhost>webmaster</a>";
LG_LOG Defines the fully qualified path name (i.e.: begins with ’/’)
for the log file or the syslog(3) facility to use for logging.
For syslog, the argument is the lowercase name of a syslog
facility (see syslog.h) without the ’LOG_’ prefix.
Example: local0
Default: $LG_CACHE_DIR/lg.log
LG_ROUTERDB
Sets the location for the router.db file in rancid’s
router.db(5) format. It lists the devices that should be
available to the looking glass users. Only those devices of
supported types and with state ’up’ are made available. If not
defined and the default file does not exist, the looking glass
will compile a list from the router.db files of all the groups
present in rancid, that is, the list will be a concatenation of
the available router.db(5) files.
Note that if the concatenation method is used, it may be
necessary to alter the mode of the router.db files in the rancid
group directories, since rancid’s default umask is 027 (see
rancid.conf(5)).
LG_STRIP
Causes the LG to strip login information from the looking glass
results. Since Expect often munges disabling echo when
passwords are entered, this is a SECURITY CONCERN! However,
this output can be very useful for debugging clogin problems.
LG_STYLE
Defines the URL of a style sheet to be used for HTML formatting.
PATH Is a colon separated list of directory pathnames in the file
system where rancid’s login scripts, clogin(1) etc.) and
programs needed within these, such as telnet(1), are located.
Its value is set by configure. Should it be necessary to modify
PATH, note that it must include $BASEDIR/bin (see above).
Queries ...................................
ENVIRONMENT
LG_CONF
Location of lg.conf file. See the FILES section for more
information.
ERRORS
lg.conf is interpreted directly by perl(1), so its syntax follows that
of perl. Syntax errors may produce quite unexpected results.
FILES
/etc/rancid/lg.conf
Configuration file described here.
lg.conf is located by the value of the environment variable
LG_CONF, in the CWD (current working directory), or the
sysconfdir defined when rancid was installed, in that order.
SEE ALSO
cloginrc(5), lg_intro(1), router.db(5)
HISTORY
In RANCID releases prior to 2.3, lg.conf was located in the util/lg
sub-directory of the install path. This was changed to be more
consistent with common file location practices.
7 Jan 2004 lg.conf(5)