1lg_intro(1)                 General Commands Manual                lg_intro(1)
2
3
4

NAME

6       lg_intro - introduction to the looking glass
7

INTRODUCTION

9       The  looking  glass  offers  a  web based interface to routers to users
10       without their needing permission to login to the router.  This may be a
11       perfect  interface  for  customer support or less savvy folks, and many
12       ISPs have given public access to such an interface as a "route server."
13

DESCRIPTION

15       The looking glass consists of  two  CGI  perl(1)  scripts,  lg.cgi  and
16       lgform.cgi, and the lg.conf(5) configuration file.
17
18       Both  of  these  scripts begin with reading the configuration file.  If
19       there is an error in the file's syntax or if the file can not be found,
20       error  messages  will  be displayed on standard-error.  The Apache http
21       server redirects standard-error to its error log file by default.
22
23       lgform.cgi displays a html form consisting of a list of possible router
24       commands  that  can  be  run and a scrolling list of routers that these
25       commands may be run on.  When the form is submitted, lg.cgi is run.
26
27       lg.cgi begins by performing some basic checks on the  arguments  passed
28       to it.  If these checks pass, lg.cgi either displays cached data from a
29       previous invocation, if that  data  exists  and  is  within  the  cache
30       interval,  or  uses  clogin(1)  to  login to the device and execute the
31       command.  The results of the  command  are  cached  if  applicable  and
32       displayed for the user.
33

GETTING STARTED

35       Besides  lg.conf(5), additional instructions for setting up the looking
36       glass    can    be    found    in     the     README     file     under
37       /usr/share/rancid/README.lg.
38
39       Note  that  the  looking  glass  scripts require a few perl modules not
40       included with rancid.  Rancid's configure process does  not  check  for
41       these.  See the README file.
42

SEE ALSO

44       cloginrc(5), clogin(1), lg.conf(5)
45

HISTORY

47       Rancid's  looking  glass is based on Ed Kern's (included by permission,
48       thanks Ed!), which could once be found on http://nitrous.digex.net/ but
49       has  apparently been removed.  Support for Juniper and Foundry devices,
50       use of rancid's device  login  scripts,  and  additional  commands  and
51       checks have been added to the original.
52
53
54
55                                  24 Jan 2001                      lg_intro(1)
Impressum