Avaya Using Technician Interface Scripts Users Manual
2015-06-01
: Avaya Avaya-Using-Technician-Interface-Scripts-Users-Manual-734540 avaya-using-technician-interface-scripts-users-manual-734540 avaya pdf
Open the PDF directly: View PDF
.
Page Count: 805
Using Technician
Interface Scripts
Router Software Version 11.0
Site Manager Software Version 5.0
Part No. 114087 Rev. A
August 1996
4401 Great America Parkway
Santa Clara, CA 95054
8 Federal Street
Billerica, MA 01821
Copyright © 1988–1996 Bay Networks, Inc.
All rights reserved. Printed in the USA. August 1996.
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 take full responsibility for their applications of any products specified in this document.
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.
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 Software clause at DFARS 252.227-7013.
Notice for All Other Executive Agencies
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 clause at FAR 52.227-19.
Trademarks of Bay Networks, Inc.
ACE, AFN, AN, BCN, BLN, BN, BNX, CN, FN, FRE, GAME, LN, Optivity, PPX, SynOptics, SynOptics
Communications, Wellfleet and the Wellfleet logo are registered trademarks and ANH, ASN, Bay•SIS, BCNX,
BLNX, EZ Install, EZ Internetwork, EZ LAN, PathMan, PhonePlus, Quick2Config, RouterMan, SPEX,
Bay Networks, Bay Networks Press, the Bay Networks logo and the SynOptics logo are trademarks of
Bay Networks, Inc.
Third-Party Trademarks
All other trademarks and registered trademarks are the property of their respective owners.
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 products 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.
Portions of the code in this software product are Copyright © 1988, Regents of the University of California. All rights
reserved. Redistribution and use in source and binary forms of such portions are permitted, provided that the above
copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials,
and other materials related to such distribution and use acknowledge that such portions of the software were
developed by the University of California, Berkeley. The name of the University may not be used to endorse or
promote products derived from such portions of the software without specific prior written permission.
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 restrictions on use and disclosure (that may incorporate by reference certain limitations and notices imposed
by third parties).
ii
114087 Rev. A
Bay Networks Software License
Note: This is Bay Networks basic license document. In the absence of a
software license agreement specifying varying terms, this license -- or the
license included with the particular product -- shall govern licensee’s use of
Bay Networks software.
This Software License shall govern the licensing of all software provided to licensee by Bay Networks (“Software”).
Bay Networks will provide licensee with Software in machine-readable form and related documentation
(“Documentation”). The Software provided under this license is proprietary to Bay Networks and to third parties from
whom Bay Networks has acquired license rights. Bay Networks will not grant any Software license whatsoever, either
explicitly or implicitly, except by acceptance of an order for either Software or for a Bay Networks product
(“Equipment”) that is packaged with Software. Each such license is subject to the following restrictions:
1.
Upon delivery of the Software, Bay Networks grants to licensee a personal, nontransferable, nonexclusive license
to use the Software with the Equipment with which or for which it was originally acquired, including use at any
of licensee’s facilities to which the Equipment may be transferred, for the useful life of the Equipment unless
earlier terminated by default or cancellation. Use of the Software shall be limited to such Equipment and to such
facility. Software which is licensed for use on hardware not offered by Bay Networks is not subject to restricted
use on any Equipment, however, unless otherwise specified on the Documentation, each licensed copy of such
Software may only be installed on one hardware item at any time.
2.
Licensee may use the Software with backup Equipment only if the Equipment with which or for which it was
acquired is inoperative.
3.
Licensee may make a single copy of the Software (but not firmware) for safekeeping (archives) or backup
purposes.
4.
Licensee may modify Software (but not firmware), or combine it with other software, subject to the provision
that those portions of the resulting software which incorporate Software are subject to the restrictions of this
license. Licensee shall not make the resulting software available for use by any third party.
5.
Neither title nor ownership to Software passes to licensee.
6.
Licensee shall not provide, or otherwise make available, any Software, in whole or in part, in any form, to any
third party. Third parties do not include consultants, subcontractors, or agents of licensee who have licensee’s
permission to use the Software at licensee’s facility, and who have agreed in writing to use the Software only in
accordance with the restrictions of this license.
7.
Third-party owners from whom Bay Networks has acquired license rights to software that is incorporated into
Bay Networks products shall have the right to enforce the provisions of this license against licensee.
8.
Licensee shall not remove or obscure any copyright, patent, trademark, trade secret, or similar intellectual
property or restricted rights notice within or affixed to any Software and shall reproduce and affix such notice on
any backup copy of Software or copies of software resulting from modification or combination performed by
licensee as permitted by this license.
114087 Rev. A
iii
Bay Networks Software License (continued)
9.
Licensee shall not reverse assemble, reverse compile, or in any way reverse engineer the Software. [Note: For
licensees in the European Community, the Software Directive dated 14 May 1991 (as may be amended from time
to time) shall apply for interoperability purposes. Licensee must notify Bay Networks in writing of any such
intended examination of the Software and Bay Networks may provide review and assistance.]
10. Notwithstanding any foregoing terms to the contrary, if licensee licenses the Bay Networks product “Site
Manager,” licensee may duplicate and install the Site Manager product as specified in the Documentation. This
right is granted solely as necessary for use of Site Manager on hardware installed with licensee’s network.
11. This license will automatically terminate upon improper handling of Software, such as by disclosure, or Bay
Networks may terminate this license by written notice to licensee if licensee fails to comply with any of the
material provisions of this license and fails to cure such failure within thirty (30) days after the receipt of written
notice from Bay Networks. Upon termination of this license, licensee shall discontinue all use of the Software
and return the Software and Documentation, including all copies, to Bay Networks.
12. Licensee’s obligations under this license shall survive expiration or termination of this license.
iv
114087 Rev. A
Contents
About This Guide
Audience ........................................................................................................................... xi
Before You Begin ..............................................................................................................xii
Conventions .....................................................................................................................xiii
Acronyms .........................................................................................................................xiv
Ordering Bay Networks Publications ..............................................................................xvii
Technical Support and Online Services
Bay Networks Customer Service ..................................................................................... xx
Bay Networks Information Services .................................................................................xxi
World Wide Web ........................................................................................................xxi
Customer Service FTP ..............................................................................................xxi
Support Source CD ..................................................................................................xxii
CompuServe ............................................................................................................xxii
InfoFACTS ............................................................................................................... xxiii
How to Get Help ...................................................................................................... xxiii
Chapter 1
Introducing Technician Interface Scripts
What Are Technician Interface Scripts? ..........................................................................1-2
Script Types ..............................................................................................................1-2
Script Command Categories ....................................................................................1-3
Installing .bat and .mnu Files ..........................................................................................1-5
Setting Up Scripts ...........................................................................................................1-6
Using Script Commands .................................................................................................1-8
Using the show Command .......................................................................................1-8
Using the enable and disable Commands .............................................................1-14
114087 Rev. A
v
Using the Menu Utility ...................................................................................................1-16
Displaying Menus ...................................................................................................1-16
Configuring Menus .................................................................................................1-19
Adding a Command .........................................................................................1-20
Deleting a Command .......................................................................................1-20
Clearing All Commands ...................................................................................1-20
Editing a Command .........................................................................................1-21
Editing a Menu Title .........................................................................................1-21
Loading a New Menu .......................................................................................1-21
Toggling Menu Titles and Commands .............................................................1-22
Saving Changes Made to Menus .....................................................................1-24
Chapter 2
Using the show Command
show appn ......................................................................................................................2-2
show at .........................................................................................................................2-43
show atm ......................................................................................................................2-59
show atmarp .................................................................................................................2-69
show atmdxi ..................................................................................................................2-76
show atmsig ..................................................................................................................2-85
show atm line ................................................................................................................2-90
show aurp ...................................................................................................................2-102
show autoneg .............................................................................................................2-112
show bgp ....................................................................................................................2-117
show bisync ................................................................................................................2-126
show bootp .................................................................................................................2-136
show bot .....................................................................................................................2-141
show bridge ................................................................................................................2-148
show circuits ...............................................................................................................2-154
show console ..............................................................................................................2-165
show csmacd ..............................................................................................................2-172
show dcmmw ..............................................................................................................2-185
show decnet ...............................................................................................................2-188
show dls ......................................................................................................................2-202
show ds1e1 ................................................................................................................2-213
show dsx3 ...................................................................................................................2-238
vi
114087 Rev. A
show dvmrp ................................................................................................................2-251
show e1 ......................................................................................................................2-261
show egp ....................................................................................................................2-268
show fddi ....................................................................................................................2-271
show fr ........................................................................................................................2-287
show ftp ......................................................................................................................2-296
show hardware ...........................................................................................................2-298
show hssi ....................................................................................................................2-305
show igmp ..................................................................................................................2-314
show ip .......................................................................................................................2-318
show ipx ......................................................................................................................2-342
show iredund ..............................................................................................................2-376
show isdn ....................................................................................................................2-379
show isdn bri ...............................................................................................................2-388
show lane ...................................................................................................................2-395
show lapb ...................................................................................................................2-405
show lnm ....................................................................................................................2-410
show nbip ...................................................................................................................2-420
show nml ....................................................................................................................2-423
show ntp .....................................................................................................................2-427
show osi ......................................................................................................................2-431
show ospf ...................................................................................................................2-439
show packet ................................................................................................................2-447
show ping ...................................................................................................................2-456
show ppp ....................................................................................................................2-461
show process ..............................................................................................................2-488
show protopri ..............................................................................................................2-493
show rarp ....................................................................................................................2-497
show rptr .....................................................................................................................2-500
show rredund ..............................................................................................................2-509
show rsc .....................................................................................................................2-517
show sdlc ....................................................................................................................2-521
show smds ..................................................................................................................2-525
show snmp .................................................................................................................2-530
show span ..................................................................................................................2-538
114087 Rev. A
vii
show sr .......................................................................................................................2-545
show srspan ...............................................................................................................2-557
show st2 .....................................................................................................................2-564
show sta .....................................................................................................................2-568
show state ..................................................................................................................2-571
show sws ....................................................................................................................2-574
show sync ...................................................................................................................2-592
show system ...............................................................................................................2-602
show t1 .......................................................................................................................2-607
show tcp .....................................................................................................................2-615
show telnet .................................................................................................................2-618
show tftp .....................................................................................................................2-620
show token ..................................................................................................................2-621
show vines ..................................................................................................................2-633
show wcp ....................................................................................................................2-644
show x25 ....................................................................................................................2-651
show xb ......................................................................................................................2-660
show xns .....................................................................................................................2-670
Chapter 3
Using enable/disable Commands
enable/disable appn ........................................................................................................3-2
enable/disable at .............................................................................................................3-5
enable/disable atm ..........................................................................................................3-6
enable/disable atmdxi .....................................................................................................3-8
enable/disable aurp ........................................................................................................3-9
enable/disable autoneg .................................................................................................3-10
enable/disable bootp .....................................................................................................3-11
enable/disable bridge ...................................................................................................3-12
enable/disable circuits ..................................................................................................3-13
enable/disable csmacd .................................................................................................3-14
enable/disable dcmmw .................................................................................................3-15
enable/disable decnet ...................................................................................................3-16
enable/disable dls .........................................................................................................3-17
enable/disable ds1e1 ....................................................................................................3-18
enable/disable dvmrp ...................................................................................................3-19
viii
114087 Rev. A
enable/disable e1 ..........................................................................................................3-20
enable/disable fddi ........................................................................................................3-21
enable/disable fr ...........................................................................................................3-22
enable/disable ftp ..........................................................................................................3-23
enable/disable hssi .......................................................................................................3-24
enable/disable igmp ......................................................................................................3-25
enable/disable ip ...........................................................................................................3-26
enable/disable ipx .........................................................................................................3-27
enable/disable iredund ..................................................................................................3-28
enable/disable isdn .......................................................................................................3-29
enable/disable isdn bri ..................................................................................................3-31
enable/disable lapb .......................................................................................................3-32
enable/disable lnm ........................................................................................................3-33
enable/disable nbip .......................................................................................................3-34
enable/disable nml ........................................................................................................3-35
enable/disable osi .........................................................................................................3-36
enable/disable ospf .......................................................................................................3-37
enable/disable packet ...................................................................................................3-38
enable/disable ppp ........................................................................................................3-39
enable/disable rarp .......................................................................................................3-40
enable/disable rptr ........................................................................................................3-41
enable/disable rredund .................................................................................................3-42
enable/disable sdlc .......................................................................................................3-43
disable/enable snmp .....................................................................................................3-44
enable/disable span ......................................................................................................3-45
enable/disable sr ...........................................................................................................3-46
enable/disable srspan ...................................................................................................3-47
enable/disable sta .........................................................................................................3-48
enable/disable sws .......................................................................................................3-49
enable/disable sync ......................................................................................................3-50
enable/disable t1 ...........................................................................................................3-51
enable/disable tcp .........................................................................................................3-52
enable/disable telnet .....................................................................................................3-53
enable/disable tftp .........................................................................................................3-54
enable/disable token .....................................................................................................3-55
enable/disable vines .....................................................................................................3-56
114087 Rev. A
ix
enable/disable wcp .......................................................................................................3-57
enable/disable x25 ........................................................................................................3-58
enable/disable xb ..........................................................................................................3-59
enable/disable xns ........................................................................................................3-60
Index
x
114087 Rev. A
About This Guide
Use this guide if you are responsible for monitoring and maintaining the
performance of Bay Networks™ routers and BNX® platforms using the Bay
Networks Technician Interface. Refer to this guide for
•
An overview of Technician Interface scripts
•
Instructions on how to
-- Load scripts
-- Set up scripts
-- Use script commands
-- Use the menu utility
•
Instructions on how to display (show a snapshot, or monitor via periodic
polling) statistical and configuration information about router services
•
Instructions on how to enable or disable router or BNX services
•
Instructions on how to configure the Packet Capture utility on the router or
BNX platform
Audience
Written for network managers and router technicians, this guide assumes that you
have a working knowledge of TCP/IP networking, and have some familiarity with
network management principles concerning the MIB, SNMP, configuration and
statistics management.
114087 Rev. A
xi
Using Technician Interface Scripts
Before You Begin
Before using this guide to run Technician Interface commands on a router or BNX
platform, you must
•
Install the router or BNX platform
•
Use one of the following methods to establish a connection to the router or
BNX platform:
-- Connect the serial port of an ASCII terminal device (for example, a DEC
VT100) directly to the console port of the router or BNX platform
-- Connect the serial port of a workstation or PC directly to the console port
of the router or BNX platform. (Run ASCII terminal emulation software
on the workstation or PC.)
-- Dial in to the console port of the router or BNX platform from a
workstation or PC running ASCII terminal emulation software. (This
alternative requires one modem locally attached to your workstation or
PC, and another modem locally attached to the console port of the router
or BNX platform you want to access.)
-- Establish a Telnet (in-band) connection to the router or BNX platform
Note: Before you can access the Technician Interface using Telnet, the router
or BNX platform must have at least one assigned IP address. Although there is
no limit to the number of Telnet connections that you can make to the
Technician Interface, we recommend that you establish no more than one
Telnet session per router or BNX platform.
xii
114087 Rev. A
About This Guide
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 command syntax is ping ,
you enter ping 192.32.10.12
bold text
Indicates text that you need to enter, command names,
and buttons in menu paths.
Example: Enter wfsm &
Example: Use the dinfo command.
Example: ATM DXI > Interfaces > PVCs identifies the
PVCs button in the window that appears when you
select the Interfaces option from the ATM DXI menu.
brackets ([ ])
ellipsis points
Indicate optional elements. You can choose none, one,
or all of the options.
.
Horizontal (. . .) and vertical ( .. ) ellipsis points indicate
omitted information.
italic text
Indicates variable values in command syntax
descriptions, new terms, file and directory names, and
book titles.
quotation marks (“ ”)
Indicate the title of a chapter or section within a book.
screen text
Indicates data that appears on the screen.
Example: Set Bay Networks Trap Monitor Filters
separator ( > )
Separates menu and option names in instructions and
internal pin-to-pin wire connections.
Example: Protocols > AppleTalk identifies the
AppleTalk option in the Protocols menu.
Example: Pin 7 > 19 > 20
vertical line (|)
Indicates that you enter only one of the parts of the
command. The vertical line separates choices. Do not
type the vertical line when entering the command.
Example: If the command syntax is
show at routes | nets, you enter either
show at routes or show at nets, but not both.
114087 Rev. A
xiii
Using Technician Interface Scripts
Acronyms
xiv
ACE
Advanced Communications Engine
AFN
Access Feeder Node
ALN
Access Link Node
AN
Access Node
ANH
Access Node Hub
APING
APPN Ping
APPN
Advanced Peer-to-Peer Routing
ARP
Address Resolution Protocol
ASCII
American Standard Code for Information Interchange
ASN
Access Stack Node
ASN.1
Abstract Syntax Notation
AT
AppleTalk Protocol
ATM
Asynchronous Transfer Mode
AURP
Appletalk Update-based Routing Protocol
BCN
Backbone Concentrator Node
BGP
Border Gateway Protocol
BLN
Backbone Link Node
BLN-2
Backbone Link Node (2 power supplies)
BOOTP
Bootstrap Protocol
CLNP
Connectionless Network Protocol
CN
Concentrator Node
CPU
Central Processing Unit
CRC
Cyclic Redundancy Check
CSMA/CD
Carrier Sense Multiple Access with Collision Detection
DCM
Data Collection Module
DLCMI
Data Link Control Management Interface
DLSw
Data Link Switch
DOS
Disk Operating System
DRAM
Dynamic RAM
DSAP
Destination Service Access Point
DVMRP
Distance Vector Multicast Routing Protocol
114087 Rev. A
About This Guide
114087 Rev. A
EOF
End of File
EGP
Exterior Gateway Protocol
FAT
File Allocation Table
FDDI
Fiber Distributed Data Interface
FIFO
First In First Out
FRSW
Frame Relay Switch
FTP
File Transfer Protocol
FN
Feeder Node
FR
Frame Relay
FRE
Fast Routing Engine
GAME
Gate Access Management Entity
GMT
Greenwich Mean Time
HDLC
High-level Data Link Control
HSSI
High Speed Serial Interface
ICMP
Internet Control Message Protocol
IGMP
Internet Group Membership Protocol
IN
Integrated Node
IP
Internet Protocol
IPX
Internet Packet Exchange
ISDN
Integrated Services Digital Network
LAN
Local Area Network
LAPB
Link Access Procedure Balanced
LED
Light Emitting Diode
LLC
Logical Link Control
LMI
Local Management Interface
LN
Link Node
LNM
LAN Network Manager
LSP
Link State Packet
MAC
Media Access Control
MCT1
Multichannel T1
MIB
Management Information Base
MOSY
Managed Object Syntax
NML
Native Mode LAN
xv
Using Technician Interface Scripts
xvi
NSAP
Network Service Access Point
NVFS
Non-Volatile File System
OSI
Open Systems Interconnection
OSPF
Open Shortest Path First
PCMCIA
Personal Computer Memory Card International Association
PPP
Point-to-Point Protocol
PPX
Parallel Packet Express
PROM
Programmable Read-Only Memory
QENET
Quad Ethernet
RAM
Random Access Memory
RARP
Reverse Address Resolution Protocol
RIF
Routing Information Field
RFC
Request for Comment
SAP
Service Access Point
SDLC
Synchronous Data Link Control
SIMM
Single In-line Memory Module
SMDS
Switched Multimegabit Data Services
SNAP
SubNetwork Access Protocol
SNMP
Simple Network Management Protocol
SR
Source Routing
SRM-L
System Resources Link Module
STA
Statistics, Thresholds, and Alarms
SYSCON
System Controller board
SWS
Switched Services
TCP
Transport Control Protocol
TFTP
Trivial File Transfer Protocol
TIP
Terminal Interface Program
TP
Transaction Program
VC
Virtual Circuit
VINES
Virtual Networking System
WAN
Wide Area Network
XB
Translation Bridge
XNS
Xerox Networking Systems
114087 Rev. A
About This Guide
Ordering Bay Networks Publications
To purchase additional copies of this document or other Bay Networks
publications, order by part number from the Bay Networks Press™ at the following
telephone or fax numbers:
• Telephone - U.S./Canada
• Telephone - International
• Fax
1-888-4BAYPRESS
1-510-490-4752
1-510-498-2609
You can also use these numbers to request a free catalog of Bay Networks Press
product publications.
114087 Rev. A
xvii
Technical Support and Online Services
To ensure comprehensive network support to our customers and partners
worldwide, Bay Networks Customer Service has Technical Response Centers
in key locations around the globe:
•
•
•
•
•
Billerica, Massachusetts
Santa Clara, California
Sydney, Australia
Tokyo, Japan
Valbonne, France
The Technical Response Centers are connected via a redundant Frame Relay
Network to a Common Problem Resolution system, enabling them to transmit and
share information, and to provide live, around-the-clock support 365 days a year.
Bay Networks Information Services complement the Bay Networks Service
program portfolio by giving customers and partners access to the most current
technical and support information through a choice of access/retrieval means.
These include the World Wide Web, CompuServe, Support Source CD, Customer
Support FTP, and InfoFACTS document fax service.
114087 Rev. A
xix
Using Technician Interface Scripts
Bay Networks Customer Service
If you purchased your Bay Networks product from a distributor or authorized
reseller, contact that distributor’s or reseller’s technical support staff for assistance
with installation, configuration, troubleshooting, or integration issues.
Customers can also purchase direct support from Bay Networks through a variety
of service programs. As part of our PhonePlus™ program, Bay Networks Service
sets the industry standard, with 24-hour, 7-days-a-week telephone support
available worldwide at no extra cost. Our complete range of contract and
noncontract services also includes equipment staging and integration, installation
support, on-site services, and replacement parts delivery -- within approximately
4 hours.
To purchase any of the Bay Networks support programs, or if you have questions
on program features, use the following numbers:
Region
Telephone Number
Fax Number
United States and
Canada
1-800-2LANWAN; enter Express Routing
Code (ERC) 290 when prompted
(508) 670-8766
(508) 436-8880 (direct)
Europe
(33) 92-968-300
(33) 92-968-301
Asia/Pacific Region
(612) 9927-8800
(612) 9927-8811
Latin America
(407) 997-1713
(407) 997-1714
In addition, you can receive information on support programs from your local
Bay Networks field sales office, or purchase Bay Networks support directly
from your authorized partner.
xx
114087 Rev. A
Technical Support and Online Services
Bay Networks Information Services
Bay Networks Information Services provide up-to-date support information as a
first-line resource for network administration, expansion, and maintenance. This
information is available from a variety of sources.
World Wide Web
The Bay Networks Customer Support Web Server offers a diverse library of
technical documents, software agents, and other important technical information
to Bay Networks customers and partners.
A special benefit for contracted customers and resellers is the ability to access the
Web Server to perform Case Management. This feature enables your support staff
to interact directly with the network experts in our worldwide Technical Response
Centers. A registered contact with a valid Site ID can
•
View a listing of support cases and determine the current status of any open
case. Case history data includes severity designation, and telephone, e-mail,
or other logs associated with the case.
•
Customize the listing of cases according to a variety of criteria, including
date, severity, status, and case ID.
•
Log notes to existing open cases.
•
Create new cases for rapid, efficient handling of noncritical network
situations.
•
Communicate directly via e-mail with the specific technical resources
assigned to your case.
The Bay Networks URL is http://www.baynetworks.com. Customer Service is a
menu item on that home page.
Customer Service FTP
Accessible via URL ftp://support.baynetworks.com (134.177.3.26), this site
combines and organizes support files and documentation from across the
Bay Networks product suite, including switching products from our Centillion™
and Xylogics® business units. Central management and sponsorship of this FTP
site lets you quickly locate information on any of your Bay Networks products.
114087 Rev. A
xxi
Using Technician Interface Scripts
Support Source CD
This CD-ROM -- sent quarterly to all contracted customers -- is a complete Bay
Networks Service troubleshooting knowledge database with an intelligent text
search engine.
The Support Source CD contains extracts from our problem-tracking database;
information from the Bay Networks Forum on CompuServe; comprehensive
technical documentation, such as Customer Support Bulletins, Release Notes,
software patches and fixes; and complete information on all Bay Networks
Service programs.
You can run a single version on Macintosh Windows 3.1, Windows 95,
Windows NT, DOS, or UNIX computing platforms. A Web links feature enables
you to go directly from the CD to various Bay Networks Web pages.
CompuServe
For assistance with noncritical network support issues, Bay Networks Information
Services maintain an active forum on CompuServe, a global bulletin-board
system. This forum provides file services, technology conferences, and a message
section to get assistance from other users.
The message section is monitored by Bay Networks engineers, who provide
assistance wherever possible. Customers and resellers holding Bay Networks
service contracts also have access to special libraries for advanced levels of
support documentation and software. To take advantage of CompuServe’s recently
enhanced menu options, the Bay Networks Forum has been re-engineered to allow
links to our Web sites and FTP sites.
We recommend the use of CompuServe Information Manager software to access
these Bay Networks Information Services resources. To open an account and
receive a local dial-up number in the United States, call CompuServe at
1-800-524-3388. Outside the United States, call 1-614-529-1349, or your nearest
CompuServe office. Ask for Representative No. 591. When you are on line with
your CompuServe account, you can reach us with the command GO BAYNET.
xxii
114087 Rev. A
Technical Support and Online Services
InfoFACTS
InfoFACTS is the Bay Networks free 24-hour fax-on-demand service. This
automated system has libraries of technical and product documents designed to
help you manage and troubleshoot your Bay Networks products. The system
responds to a fax from the caller or to a third party within minutes of being
accessed.
To use InfoFACTS in the United States or Canada, call toll-free 1-800-786-3228.
Outside North America, toll calls can be made to 1-408-764-1002. In Europe,
toll-free numbers are also available for contacting both InfoFACTS and
CompuServe. Please check our Web page for the listing in your country.
How to Get Help
Use the following numbers to reach your Bay Networks Technical Response
Center:
114087 Rev. A
Technical Response Center Telephone Number
Fax Number
Billerica, MA
1-800-2LANWAN
(508) 670-8765
Santa Clara, CA
1-800-2LANWAN
(408) 764-1188
Valbonne, France
(33) 92-968-968
(33) 92-966-998
Sydney, Australia
(612) 9927-8800
(612) 9927-8811
Tokyo, Japan
(81) 3-5402-0180
(81) 3-5402-0173
xxiii
Chapter 1
Introducing Technician Interface Scripts
This chapter provides an overview of the Technician Interface scripts and explains
how to run them. It also describes how to
•
Load scripts
•
Set up scripts
•
Use script commands
•
Use the menu utility
This manual assumes that you have a working knowledge of the Bay Networks
Technician Interface. For complete information about this router management
tool, refer to Using Technician Interface Software. For information on how to
write your own Technician Interface scripts, refer to Writing Technician Interface
Scripts.
114087 Rev. A
1-1
Using Technician Interface Scripts
What Are Technician Interface Scripts?
The Technician Interface show/monitor and enable/disable scripts are programs
that enable you to view and use information stored in the Bay Networks
Management Information Base (MIB). You use scripts to display statistical and
configuration information about various router services, and to enable or disable
those services.
Script Types
Most Technician Interface scripts run from a .bat (batch) file.
The system loads a specific .bat file into active memory when you enter a scripts
command such as show appn directory statistics. The system software supports
one .bat file for each router protocol or service. Each .bat file contains the routines
for all script subcommand options for a protocol or service. The routine called by
each subcommand generates and prints (to the router console) statistics that reveal
a particular view of that protocol or service.
As an alternative to entering show/enable/disable commands at the Technician
Interface prompt, you can also access protocol-specific menus from the scripts
main menu. You enter (choose by number) a protocol/service submenu from the
scripts main menu. From a submenu, you can access all scripts options for a
protocol or service without entering commands. All scripts menus exist as *.mnu
files you install during initial configuration of each router. To save file space,
install only the .bat and .mnu files that pertain to the protocols or services you
want to support on each router.
Other Technician Interface scripts are programs embedded within the router
software image. The router software currently includes embedded scripts for the
following services:
• CSMACD
• TFTP
• IP
• SNMP
• FR
• SYNC
• FTP
• TELNET
• TCP
1-2
114087 Rev. A
Introducing Technician Interface Scripts
These scripts run more efficiently than their batch file counterparts. You enter at
the Technician Interface prompt the command for any script, regardless of type
(batch or embedded) in the same way, as follows:
{show|enable|disable} {} {}
Script Command Categories
The system software supports scripts in the following command categories:
show
Displays configuration, state, and statistical information
about a router service. This command helps you isolate
problems such as circuits that are not working, packets that
are not being forwarded, and so on. It uses the show.bat file.
monitor
Displays the same information as the show command but
refreshes the display periodically so you can observe trends
and changes. Since you can use monitor in place of show,
this manual does not describe syntax for the monitor
command. This command uses the monitor.bat file.
enable/disable
Enables or disables system features, protocols, drivers, or
individual circuits. These commands use the enable.bat and
disable.bat files.
menu
Provides a menu interface to the scripts. Also provides a
menu-building feature that enables you to create custom
menus. This command uses menu.bat and various .mnu files.
Each show command supports a subset of commands that display statistical and
configuration information about a particular service or driver running on the
router.
114087 Rev. A
1-3
Using Technician Interface Scripts
Some show commands present a broad or collective view of router status and
resources. For example,
show circuits
Displays information about all drivers running on the
router. You can use this command to display information
about all circuits without needing to know the driver that
runs on each circuit.
show drivers
Displays information about the configuration of all link
modules in the router.
show hardware
Displays backplane, configuration file, image, memory,
PROM, and slot information about the router’s hardware.
show protocols
Displays information about the protocols configured on
every slot in the router.
show state
Displays information about the current state of services
running on the router.
show system
Displays information about router memory, buffers, drivers,
and configured protocols.
Note: You can abbreviate command names, using the first three characters of
the command name, as long as the abbreviation uniquely identifies the
command.
To establish the search path used to find the script files, use the run setpath
command. It defines the aliases that integrate scripts into the Technician Interface
command set. The section “Setting Up Scripts” explains the run setpath
command, which uses the setpath.bat script.
1-4
114087 Rev. A
Introducing Technician Interface Scripts
Installing .bat and .mnu Files
You can use the Bay Networks implementation of File Transfer Protocol (FTP) to
install .bat version scripts and .mnu script menu files on a memory card in the
router. FTP enables you to install more than one script at a time.
Before installing any scripts on a router:
•
Log in to the router. (Refer to Chapter 1 of Using Technician Interface
Software if you need more information on login procedures.)
•
Enable the FTP service on the router.
•
Run the dir command to verify that you have sufficient contiguous freespace
on the NVFS volume reserved for scripts and their associated menu files.
(Refer to Chapter 4 of Using Technician Interface Software if you need more
information on how to run the dir command.)
•
Run the compact command on the NVFS volume reserved for scripts and
their associated menu files. (Refer to Chapter 8 of Using Technician Interface
Software if you need more information on how to run the compact
command.)
To install all the .bat scripts and .mnu menu files located in a directory on a UNIX
workstation, change to that directory using the cd command. Then enter the
following commands at the UNIX command line prompt:
$: ftp
Name: Manager
Password:
ftp> cd :
ftp> bin
ftp> prompt
ftp> mput *.bat
ftp> mput *.mnu
The prompt command disables the prompt that asks whether you want to transfer
each file.
114087 Rev. A
1-5
Using Technician Interface Scripts
Note: You must have Manager access to write to an NVFS volume using the
Bay Networks implementation of FTP.
This procedure installs all of the .bat and .mnu files on a file system volume in the
router. To conserve space on a router’s local file system, load only scripts for the
protocols and drivers you need to run on that router.
If you want to use the Trivial File Transfer Protocol (TFTP) to install .bat and
.mnu files one at a time, refer to Chapters 4 and 5 of Using Technician Interface
Software.
Setting Up Scripts
Once you log in to a Technician Interface session on a router, you can enter any
embedded script commands at the command line prompt without any additional
preparations. However, before you run any .bat version scripts, designate a default
file system volume, as shown in the following example:
dir 2:
Next, define the search path and alias definitions for your .bat and .mnu version
script files by using the run setpath command. The search path is a list of volume
IDs you want the system to search for any script file. There are two ways to
specify a search path, as shown in the following examples.
Example 1 -- Entering the volume IDs on the command line
run setpath "2:;3:;4:"
1-6
114087 Rev. A
Introducing Technician Interface Scripts
Example 2 -- Letting the setpath command prompt you for input
run setpath
NVFS File System:
VOL
STATE
TOTAL SIZE
FREE SPACE
CONTIG FREE SPACE
--------------------------------------------------------------3:
FORMATTED
2097152
1218683
1017067
2:
FORMATTED
2097152
431128
431128
Please enter the volume ID that contains the script files.
More than one volume may be entered; each separated by a semi-colon.
Format: :[;: ...]
Example: 2:;3:;4:
Enter volume(s)[2:]: 3:
You can also use the Manager or User autoscript features to automatically run the
setpath.bat script (the run setpath command). Specify a file system search path,
Manager or User script file, and logout mechanism using following
wfSerialPortEntry (router serial port) attributes:
•
Login Script Search Path
•
Manager’s Login Script
•
User’s Login Script
•
Force User Logout
You can set up separate Manager and User autoscript files for login. The User
autoscript contains a switch that enables you to lock the user into the script. With
the switch enabled, the autoscript automatically logs out a user that tries to break
out of the script. For more information on the autoscript feature, see Chapter 2 of
Using Technician Interface Software.
114087 Rev. A
1-7
Using Technician Interface Scripts
Using Script Commands
This section provides an overview of the show/monitor and enable/disable
commands.
Using the show Command
After you set up scripts with the run setpath command, you can use the show