summaryrefslogtreecommitdiffstats
path: root/share/lgnotes.html
blob: 3f12357a72fd32dcba26602a8078738b704c3dd1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>

<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<title>Looking Glass Notes</title>
</head>

</strong></font><font face="Arial"> </font><font
size=+3><strong>&nbsp;&nbsp;&nbsp;Looking Glass Notes
</strong></font></p>
<br>
<p>
<ul>
Just a few straight forward notes on our implementation of
Ed Kern's looking glass (which was http://nitrous.digex.net).
</ul>
</p>
<p>
<UL>
<li>Some items are not implemented for the junipers/foundrys yet (so, as i get
    to it) or no equivalent command exists.
<li>If there is something which you feel is missing, feel free to ask
    and/or send comments to <a href=mailto:rancid@shrubbery.net>
    rancid@shrubbery.net</a>.  No guarantees.</li>
<li>Only one query per router allowed at any given time.  This is to avoid
    resource deprivation on the looking glass host or the router.  The
    looking glass will attempt to serialize queries.</li>
<li>The looking glass will ping a router prior to querying it to avoid
    trying to query routers which are down or otherwise inaccessible.</li>
<li>Login failures can be intermittent or permanent, either due to the
    router being inaccessible from the looking glass machine, 
    or authorization failure(s).  Contact your local network engineering
    folks to resolve login failures.</li>
<li>Queries followed by &lt;something&gt; require an argument(s) in the text
    window below the query list.  Some queries take optional arguments
    denoted by [something].  Multiple arguments should be separated by a
    space.</li>
<li>Note that output from certain queries is cached by the server and may
    be slightly out of date.  These queries will be noted as such in the
    output.  This is limited to queries which could produce lots of output,
    such as 'sh ip bgp dampened-paths'.</li>
<li>Note that some queries have potential to produce great load on the router
    and produce lots of output, such as 'sh ip bgp' or 'sh ip bgp reg '^3561'.
    The looking glass attempts to deny such commands.</li>
</ul>
<p>
Some useful hints:
<UL>
<li>Show interfaces can take arguments other than an interface name, assuming
    the router is running an O/S version with the capability.  For example; a
    cisco can take 'descriptions' or 'brief' and 'terse' for the juniper. </li>
<li>Show ip bgp neighbor can take additional arguments (if configured to allow
    it), such as 'advertised routes', 'flap-statistics', 'received-routes',
    and 'routes'.  The argument will be converted for the platform.</li>
</ul>

</body>
</html>