summaryrefslogtreecommitdiffstats
path: root/share/lgnotes.html
diff options
context:
space:
mode:
Diffstat (limited to 'share/lgnotes.html')
-rw-r--r--share/lgnotes.html61
1 files changed, 61 insertions, 0 deletions
diff --git a/share/lgnotes.html b/share/lgnotes.html
new file mode 100644
index 0000000..9f28ec3
--- /dev/null
+++ b/share/lgnotes.html
@@ -0,0 +1,61 @@
+<!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. See the original at
+<a href=http://nitrous.digex.net>http://nitrous.digex.net</a>.
+</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>