All rights reserved. Printed in the USA. November 1998.
The information in this document is subject to change without notice. The statements, configurations, technical data,
and recommendations in this document are believed to be accurate and reliable, but are presented without express or
implied warranty. Users must tak e full re spo nsibility fo r th eir a pplic atio ns o f a ny products specifi ed in th is d ocume nt .
The information in this document is proprietary to Bay Networks, Inc.
The software described in this document is furnished under a license agreement and may only be used in accordance
with the terms of that license. A summary of the Software License is included in this document.
Trademarks
AN, BCN, BLN, BN, and Bay Networks are registered trademarks and BayRS, BCC, and the Bay Networks logo are
trademarks of Bay Networks, Inc.
Internet Explorer, Microsoft, MS, MS-DOS, Win32, Windows, and Windows NT are registered trademarks of
Microsoft Corporation.
All other trademarks and registered trademarks are t he property of their respective owners.
Restricted Rights Legend
Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subparagraph
(c)(1)(ii) of the Rights in Technical Data and Computer So ftware clause at DFARS 252.227-7013.
Notwithstanding any other license agreement that may pertain to, or accompany the delivery of, this computer
software, the rights of the United States Government regarding its use, reproduction, and disclosure are as set forth in
the Commercial Computer Software-Restricted Rights cl ause at FAR 52.227-19.
Statement of Conditions
In the interest of improving internal design, operational function, and/or reliability, Bay Networks, Inc. reserves the
right to make changes to the pr oducts described in this document without notice.
Bay Networks, Inc. does not assume any liability that may occur due to the use or application of the product(s) or
circuit layout(s) described herein.
SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
In addition, the program and information contained herein are licensed only pursuant to a license agreement that
contains restricti ons on use and disclosure (that may incorporate by reference certai n limitations and no tices imposed
by third parties).
Bay Networks, Inc. Software License Agreement
NOTICE: Please carefully read this license agre ement before copying or using the accompanying software or
installing the hardware unit with pre-enabled software (each of which is referred to as “Software” in this Agreement).
ii
300019-B Rev. 00
BY COPYING OR USING THE SOFTWARE, YOU ACCEPT ALL OF THE TERMS AND CONDITIONS OF
THIS LICENSE AGREEMENT. THE TERMS EXPRESSED IN THIS AGREEMENT ARE THE ONLY TERMS
UNDER WHICH BAY NETWORKS WILL PERMIT YOU TO USE THE SOFTWARE. If you do not accept these
terms and conditions, return the product, unused and in the original shipping container, within 30 days of purchase to
obtain a credit for the full purchase price.
1. License Grant. Bay Networks, Inc. (“Bay Networks”) grants the end user of the Software (“Licensee”) a personal,
nonexclusive, nontransferable license: a) to use the Software either on a single computer or, if applicable, on a single
authorized device identified by host ID, for which it was originally acquired; b) to copy the Software solely for backup
purposes in support of authorized use of the Software; and c) to use and copy the associated user manual solely i n
support of authorized use of the Software by Licensee. This license applies to the Software only and does not extend
to Bay Networks Agent software or other Bay Networks software products. Bay Networks Agent software or other
Bay Networks software products are licensed for use under the terms of the applicable Bay Networks, Inc. Software
License Agreement that accomp anies such software and upon payment by the end user of the applicable license fees
for such software.
2. Restrictions on use; reservation of rights. The Software and user manuals are protected under copyright laws.
Bay Networks and/or it s licensors retain all title and ownership in both the Software and user manuals, including any
revisions made by Bay Networks or i ts licensors. The copyr ight notice must be reproduced and included with any
copy of any portion of the Software or user manuals. Licensee may not modify, translate, decompile, disassemble, use
for any competitiv e analysis, re v erse engineer , distrib ute, or create deriv ati ve works from the Softwa re or user manuals
or any copy, in whole or in part. Except as expressly provided in this Agreement, Licensee may not copy or transfer
the Software or user manuals, in whole or in part. The Soft ware and user manuals embody Bay Networks’ and its
licensors’ confidential and proprietary intellectual property. Licensee shall not sublicense, assign, or otherwise
disclose to any third party the Software, or any information about the operation, design, performance, or
implementation of the Software and user manuals that is confidential to Bay Networks and its licensors; however,
Licensee may grant permission to its consultants, subcontractors, a nd agents to use the Softw are at Licensee’s facility,
provided they have agreed to use the Software only in accordance with the terms of this license.
3. Limited warranty. Bay Networks warrants each item of Software, as delivered by Bay Networks and properly
installed and operated on Bay Networks hardware or other equipment it is originally licensed for, to function
substantially as described in its accompanying user m anual during its warranty period , which begins on the date
Software is first shipped to Licensee. If an y item of S oftware f ails to so function d uring its w arranty period, as the sole
remedy Bay Networks will at its discretion provide a suitable fix, patch, or workaround for the problem that may be
included in a future Software release. Bay Network s fur ther w arra nts to Licen see that the medi a on which the
Software is provided will be free from defec ts in materials and wo rkman ship under no rmal use for a peri od of 90 da ys
from the date Software is first shipped to Licensee. Bay Networks will replace defective media at no charge if it is
returned to Bay Netw orks during the warran ty perio d alon g with proof of the date of shipment . This war ranty do es not
apply if the media has been dam aged as a resul t of acci dent, misuse , or ab use. The Licen see assumes all re sponsibilit y
for selection of the Software to achieve Licensee’s intended results and for the installation, use, and results obtained
from the Software. Bay Networks does not warrant a) that the functions contained in the software will meet the
Licensee’ s requireme nts, b) that the Software will operate in the hardw are or soft wa re c ombi nations th a t the L icensee
may select, c) that the operation of the Softw a re will be uninterru pte d or error free, or d) that all defec ts in the
operation of the Software will be corrected. Bay Networks is not obligated to remedy any Software defect that cannot
be reproduced with the latest Software release. These warranties do not apply to the So ftw are if i t has been (i) altered,
except by Bay Netwo rks or in a ccordance with its instru ction s; (ii) used in con junc tion with another v en dor’s product,
resulting in the defect; or (iii) damaged by improper environment, abuse, misuse, accident, or negligence. THE
FOREGOING WARRANTIES AND LIMITATIONS ARE EXCLUSIVE REMEDIES AND ARE IN LIEU OF ALL
OTHER WARRANTIES EXPRESS OR IMPLIED, INCLUDING W ITHOUT LIMITATION ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Licensee is responsible for the security of
its own data and information and for maintaining adequate procedures apart from the Software to reconstruct lost or
altered files, data, or programs.
4. Limitation of liability. IN NO EVENT WILL BAY NETWORKS OR ITS LICENSORS BE LIABLE FOR ANY
COST OF SUBSTITUTE PROCUREMENT; SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES; OR ANY DAMAGES RESULTING FROM INACCURATE OR LOST DATA OR LOSS OF USE OR
300019-B Rev. 00
iii
PROFITS ARISING OUT OF OR IN CONNECTION WITH THE PERFORMANCE OF THE SOFTWARE, EVEN
IF BAY NETWORKS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT
SHALL THE LIABILITY OF BAY NETWORKS RELATING TO THE SOFTWARE OR THIS AGREEMENT
EXCEED THE PRICE PAID TO BAY NETWORKS FOR THE SOFTWARE LICENSE.
5. Government Licensees. This provision applies to all Software and documentation acquired directly or indirectly
by or on behalf of the United States Government. The Software and documentation are commercial products, licensed
on the open market at market prices, and were developed entirely at private expense and without the use of any U.S.
Government funds. The license to the U.S. Government is granted only with restricted rights, and use, duplication, or
disclosure by the U.S. Government is subject to the restrictions set forth in subparagraph (c)(1) of the Commercial
Computer Software––Restricte d Rig hts cla u se o f FAR 52.227-19 and the limitatio ns set o ut in this license for civilian
agencies, and subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause of DFARS
252.227-7013, for agencies of t he Department of Defense or their successors, whichever is applicable.
6. Use of Software in the European Community. This provision applies to all Software acquired for use within the
European Community. If Licensee uses the Software within a country in the European Community, the Software
Directive enacted by the Council of European Commun ities Directive dated 14 May, 1991, will apply to the
examination of the Software to facilitate interoperability. Licensee agrees to notify Bay Networks of any such
intended examination of the Software and may procure support and assistance from Bay Networks.
7. Term and termination. This license is effective until terminated; however, all of the restrictions with respe ct to
Bay Networks’ copyright in the Software and user manuals will cease being effective at the date of expiration of the
Bay Networks copyright; those restrictions relating to use and disclosure of Bay Networks’ confidential information
shall continue in effect. Licensee may terminate this license at any time. The license will automatically terminate if
Licensee fails to comply with any of the terms and conditions of the license. Upon termination for any reason,
Licensee will immediately destroy or return to Bay Networks the Software, user manuals, and all copies. Bay
Networks is not liable to Licensee for damages in any form solely by reason of the termination of this license.
8. Export and Re-export. Licensee agrees not to export, directly or indirectly, the Software or related technical data
or information without first obtaining any required export licenses or other governmental approvals. Without limiting
the foregoing, Licensee, on behalf of itself and its subsidiaries and affiliates, agrees that it will not, without first
obtaining all export licenses and approvals required by the U.S. Government: (i) export, re-export, transfer, or divert
any such Software or technical data, or any direct product thereof, to any country to which such exports or re-exports
are restricte d or em b argoed under United States expor t con t ro l la w s an d r egulations, or to an y national or resident of
such restricted or embargoed countries; or (ii) provide the Software or related technical data or information to any
military end user or for any military end use, including the design, development, or production of any chemical,
nuclear, or biological weapons.
9. General. If any provision of this Agreement is held to be invalid or unenf orceable by a court of competent
jurisdiction, the remainder of the provisions of this Agreement shall remain in full force and effect. This Agreement
will be governed by the laws of the state of California.
Should you have any questions concerning this Agreement, contact Bay Networks, Inc., 4401 Great America Parkway,
P.O. Box 58185, Santa Clara, California 95054- 8185.
LICENSEE ACKNOWLEDGES THAT LICENSEE HAS READ THIS AGREEMENT, UNDERSTANDS IT, AND
AGREES TO BE BOUND BY ITS TERMS AND CONDITIONS. LICENSEE FURTHER AGREES THAT THIS
AGREEMENT IS THE ENTIRE AND EXCLUSIVE AGREEMENT BETWEEN BAY NETWORKS AND
LICENSEE, WHICH SUPERSEDES ALL PRIOR ORAL AND WRITTEN AGREEMENTS AND
COMMUNICATIONS BETWEEN THE PARTIES PERTAINING TO THE SUBJECT MATTER OF THIS
AGREEMENT. NO DIFFERENT OR ADDITIONAL TERMS WILL BE ENFORCEABLE AGAINST BAY
NETWORKS UNLESS BAY NETWORKS GIVES ITS EXPRESS WRITTEN CONSENT, INCLUDING AN
EXPRESS WAIVER OF THE TERMS OF THIS AGREEMENT.
iv300019-B Rev. 00
Contents
Preface
Before You Begin .............................................................................................................. ix
Text Conventions ...............................................................................................................x
Acronyms ........................... .......................... .......................... ......................... .................. xi
Bay Networks Technical Publications ............................................................................... xi
How to Get Help ...............................................................................................................xii
Chapter 1
Starting and Configuring the HTTP Server
Site Manager Parameters .............................................................................................. A-2
Appendix B
Show Commands for the HTTP Server
Sample show Command Output ................................................................................... B-2
Online Help for show Commands .................................................................................. B-2
Show Commands for the HTTP Server ......................................................................... B-3
show http summary ................................................................................................. B-3
show http requests .................................................................................................. B-4
show http responses ............................................................................................... B-4
Index
300019-B Rev. 00
vii
Preface
This guide describes how to configure and use the Bay Networks® HTTP Server,
an embedded Web-based router management tool include d with the Bay Networ ks
router operating system software and accessible from any standard Web browser.
Using HTTP Server software, you can monitor network devices, viewing
summary, fault, and statistical information on a
device-by-device basis.
You can use the Bay Command Conso le (BCC
HTTP Server software on a router. In this guide, you will find configuration
instructions using both the BCC and Site Manager.
Before You Begi n
Before using this guide, you must complete the following procedures. For a new
router:
•Install the router (see the installation guide that came with your router).
•Connect the router to the network and create a pilot configuration file (see
Quick-Starting Routers
•Configure IP on the router (see
Make sure that you are running the latest version of Bay Networks BayRS
Site Manager software. For information about upgrading BayRS and Site
Manager, see the upgrading guide for your version of BayRS.
™
) or Site Manager t o conf i gure the
).
Configuring IP Services
).
™
and
300019-B Rev. 00
ix
Managing Routers Using the HTTP Server
Text Con ventions
This guide uses the following text conventions:
angle brackets (< >)Indicate that you choose the text to enter based on the
description inside the brackets. Do not type the
brackets when entering the command.
Example: If the command syntax is:
ping <
ip_address
ping 192.32.10.12
>
, you enter:
bold text
Indicates command names and options and text that
you need to enter.
Example: Enter
show ip {alerts | routes
Example: Use the
dinfo
command.
}.
braces ({})Indicate required elements in syntax descriptions
where there is more than one option. You must choose
only one of the options. Do not type the braces when
entering the command.
Example: If the command syntax is:
show ip {alerts | routes
show ip alerts or show ip routes
}
, you must enter either:
, but not both.
brackets ([ ])Indicate optional elements in syntax descriptions. Do
not type the brackets when entering the command.
Example: If the command syntax is:
show ip interfaces [-alerts
show ip interfaces
or
]
, you can enter either:
show ip interfaces -alerts
.
ellipsis points (. . . )Indicate that you repeat the last element of the
command as needed.
Example: If the command syntax is:
ethernet/2/1 [<
ethernet/2/1
and as many parameter-value pairs as
parameter> <value
>] . . .
, you enter
needed.
x
300019-B Rev. 00
Preface
italic textIndicates file and directory names, new terms, book
titles, and variables in command syntax descriptions.
Where a variable is two or more words, the words are
connected by an underscore.
Example: If the command syntax is:
show at <
valid_route
valid_route
>
is one variable and you substitute one value
for it.
screen textIndicates system output, for example, prompts and
system messages.
Example:
Set Bay Networks Trap Monitor Filters
separator ( > )Shows menu paths.
Example: Protocols > I P ide nti fies the IP option on the
Protocols menu.
vertical line (
)Separates choices for command keywords and
|
arguments. Enter only one of the choices. Do not type
the vertical line when entering the command.
Example: If the command syntax is:
show ip {alerts | routes}, you enter either:
show ip alerts or show ip routes, but not both.
300019-B Rev. 00
xi
Managing Routers Using the HTTP Server
Acronyms
ARPAddress Resolution Protocol
BootPBootstrap Protocol
FDDIFiber Distributed Data Interface
FTPFile Transfer Protocol
HSSIHigh-Speed Sserial Interface
HTTPHypertext Transfer Protocol
ICMPInternet Control Message protocol
IPInternet P rotocol
IPXInternet Packet Exchange
MACmedia access control
RIPRouting Information Protocol
SAPService Advertising Protocol
SMDSSwitched Multimegabit Data S ervice
SNMPSimple Network Management Protocol
TCPTransaction Control Protocol
Bay Networks Technical Publications
You can now print Bay Networks technical manuals and release notes free,
directly from the Internet. Go to support.baynetwork s.com/libr ary/ tpubs/ . Fi nd the
Bay Networks product for which you need documentation. Then locate the
specific category and model or ve rsion for your hardware or software product.
Using Adobe Acrobat Re ader, you can open the manuals and rel ease n otes, searc h
for the sections you need, and print them on most standard printers. You can
download Acrobat Reader free from the Adobe Systems Web site,
www.adobe.com.
You can purchase Bay Networks documentation sets, CDs, and selected technical
publications through the Bay Networks Collateral Catalog. The catalog is located
on the World Wide Web at support.baynetworks.com/catalog.html and is divided
into sections arranged alphabetically:
xii
300019-B Rev. 00
•The “CD ROMs” section lists available CDs.
•The “Guides/Books” section lists books on technical topics.
•The “Technical Manuals” section lists available printed documentation sets.
Make a note of the part numbers and prices of the items that you want to order.
Use the “Marketing Collateral Catalog description” link to place an order and to
print the order form.
How to Get Help
For product assistance, support contracts, or information about educational
services, go to the following URL:
http://www.baynetworks.com/corporate/contacts/
Or telephone the Bay Networks Technical Solutions Center at:
800-2LANWAN
Preface
300019-B Rev. 00
xiii
Managing Routers Using the HTTP Server
xiv
300019-B Rev. 00
Chapter 1
Starting and Configuring the HTTP Server
The Bay Networks HTTP Server is an embedded Web-based router management
tool included with the Bay Networks router operating system software and
accessible from any sta ndard Web browser . Using HTTP Ser ver soft ware, you can
monitor network de vices, viewi ng summary, fault, and statisti cal i nforma tion o n a
device-by-device basis.
Before you can use the HTTP Server to monitor a router, you must configure and
enable the HTTP Server software on the router using the Quick-Start installation
script install.bat, the Bay Command Console (BCC™), or Site Manager.
Browser Requirements
Starting the HTTP Server Using install.bat
Starting the HTTP Server Using the BCC
Starting the HTTP Server Using Site Manager
Setting HTTP Server Security
Go to “Starting and Configuring the HTTP Server.”
Browser Requirements
Your Web browser must support frames, Java applets, and cascading style sheets;
for example, Netscape 4.0 or higher and Microsoft
higher. If you have changed the default settings for these browsers, you must
ensure that Java is enabled. If you configure digest authentication, your browser
must be enabled for this capability; oth erwise, authentication reverts to basic.
Caution:
security reasons, it is wise not to store your password.
300019-B Rev. 001-1
Internet Explorer lets you store your browser password. For
®
Internet E xplorer® 4.0 or
Managing Routers Using the HTTP Server
Go to “Starting and Configuring the HTTP Server.”
Starting the HTTP Serve r Us ing
A new router comes wit h a flash mem ory card containing the software im age for
the router, two configuration files (config and ti.cfg), and the Quick-Start script
install.bat.
The Quick-Start installation scr ipt creates an initial IP network interface on the
router, so that your router can communicate with the configuration workstation
from which you will manage the rout er. The install.bat script prompts you t o enter
the network information that dynamically configures the initia l IP interface .
As the following example shows, the script asks whether you want to enable
HTTP. Answer yes to this question. (The default is no.)
Step 7. Enable HTTP
Enable the HTTP (Web) Server
----------------------------
Do you want to enable the HTTP (Web) server? (y/n)[n]:
HTTP server enabled.
Note:
For complete ins truct ion s on runn ing the ins tall. bat scr ipt an d verif ying
that the installation is successful, see Quick-Starting Routers.
install.bat
y
When you enable the HTTP Ser ver duri ng the Qui ck-St art pr ocedur e, you ca n use
the HTTP Server with its default configuration settings after completing the
install.bat procedure. For information on modifying the default HTTP Server
settings, see Customizing HTTP Parameters
.
After you run the install.bat script, you can install Site Manager software, as
described in Quick-Starting Routers.
Go to “Starting and Configuring the HTTP Server
1-2300019-B Rev. 00
.”
Starting and Configuring the HTTP Server
Starting the HTTP Serve r Us ing the BCC or Site Manager
If you did not use the Quick-Start procedure to start the HTTP Server, you can
start it using the BCC or Site Manager. When you complete this procedure, the
HTTP Server software is configured on the router. Before you start the HTTP
Server, verify that you have configured IP on an interface.
You can start the HTTP Server using default values for all parameters. For
information on modifying the default HTTP Server settings, see Customizing
HTTP Parameters.
Using the BCC
Adding the HTTP Server to a router automatically loads TCP on all slots. To add
the HTTP Server to a router, navigate to the box prompt and enter:
http
For example, the following command adds HTTP Server to a router:
box#
http
http#
Go to “Starting and Configuring the HTTP Server.”
300019-B Rev. 001-3
Managing Routers Using the HTTP Server
Using Site Manager
You can configure HTTP Server software in any Configuration Manager mode.
To start HTTP Server software, complete the following tasks:
You do thisSystem responds
Site Manager Procedure
1. In the Configuration Manager window,
Protocols
choose
2. Choose
3. Choose
4. Choose
5. Choose
6. Choose
7. Choose
8. Choose
Global Protocols
TCP
Create TCP
Protocols
Global Protocols
HTTP
Create HTTP
.
.The Global Protocols menu opens.
.The TCP menu opens.
.You return to the Configuration Manager
.The Protocols menu opens.
.The Global Protocols menu opens.
.The HTTP menu opens.
.You return to the Configuration Manager
Go to “Starting and Configuring the HTTP Server
Setting HTTP Server S ecurity
The HTTP Server allows access to device information from anywhere in the
network. To protect your network information, you can implement security
controls. The HTTP Server offers access control through: user name/password
security, basic access or digest authentication, and network address filtering.