Avaya Using Technician Interface Scripts User Manual
BayRS Version 14.00
Part No. 308658-14.00 Rev 00
September 1999
4401 Great America Parkway
Santa Clara, CA 95054
Using Technician Interface Scripts
Copyright © 1999 Nortel Networks
All rights reserved. Printed in the USA. September 1999.
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 o f a ny products specifi ed in this d ocum ent.
The information in this document is proprietary to Nortel Networks NA 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
NORTEL NETWORKS is a trademark of Nortel Networks.
Bay Networks, AN, BCN, BLN, BN, and FRE are registered trademarks and Advanced Remote Node, ANH, ARN,
ASN, BayRS, BaySecure, BayStack, BayStream, BCC, BCNX, BLNX, and System 5000 are trademarks of Nortel
Networks.
Microsoft, MS, MS-DOS, Win32, Windows, and Windows NT are registered trademarks of Microsoft Cor poration.
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 Sof tware 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 improvi ng internal design, operational fun c tion , an d/o r re lia bi lity, Nortel Networks NA Inc. reserve s
the right to make changes to the products described in this document without notice.
Nortel Networks NA 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 may be 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 docu mentation, advertising
materials, and other materials related to such distribution and use acknowledge that su ch 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 containe d 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).
Nortel Networks NA 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).
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
ii
308658-14.00 Rev 00
UNDER WHICH NORTEL 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. Nortel Networks NA Inc. (“Nortel Networks”) grants the end user of the Software (“Licensee”) a
personal, nonex clusive, nontransfera ble lic ense: a) to u se the Softw are eit her on a single compute r or, if applicab le, 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 t he Software; and c) to use and copy the associated user manual
solely in support of authoriz ed use of th e Softwa re b y Licen see. Thi s license applies t o the So ftware o nly and d oes not
extend to Nortel Networks Agent software or other Nortel Networks software products. Nortel Networks Agent
software or other Nortel Networks software products are licensed for use under the terms of the applicable Nortel
Networks NA Inc. Software License Agreement that accompanies 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 und er copyright laws.
Nortel Networks and/or its licensors retain all title and ownership in both the Software and user manuals, including
any revisions made by Nortel Networks or its licensors. The copyright 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 competitive analysis, reverse engineer, distribute, or create derivative works from the Software 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 Software and user manuals embody Nortel Networks’
and its licensors’ confidential and propriet ary in telle c tu al pro p erty. Licensee shall not sublicense, assign, or ot herwise
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 Nortel 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 . Nortel Networks warrants each item of Software, as delivered by Nortel Networks and properly
installed and operated on Nortel Networks hardware or other equipment it is originally licensed for, to function
substantially as described in its accompanying user manual 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 Nortel Networks will at its discretion provide a suitable fix, patch, or workaround for the problem that may be
included in a future Software release. Nortel Networks further warrants to Licensee that the media 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. Nortel Networks will replace defective media at no charge if it is
returned to Nortel Netw orks during the warranty period along with proof of the date of ship ment. This warranty does
not apply if the media has been damaged as a result of accident, misuse, or abuse. The Licensee assumes all
responsibility for selection of the Software to achieve Licensee’s intended results and for the installation, use, and
results obtained from the Software. Nortel Networks does not warrant a) that the functions contained in the software
will meet the Licensee’s requirements, b) that the Software will operate in the hardware or software combinations that
the Licensee may select, c) that the operation of the Software will be uninterrupted or error free, or d) that all defects
in the operation of the Softw are will be corrected . Nortel Network s is not obligate d to remedy an y Software defect that
cannot be reproduced with the latest Software release. These warranties do not apply to the Software if it has been (i)
altered, except by Nortel Networks or in accordance with i ts instructions; (ii) used in conjunction with another
vendor’s product, resulting in the de fect; or (iii) damage d 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 WITHOUT 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 NORTEL 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
PROFITS ARISING OUT OF OR IN CONNECTION WITH THE PERFORMANCE OF THE SOFTWARE, EVEN
IF NORTEL NETWORKS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT
308658-14.00 Rev 00
iii
SHALL THE LIABILITY OF NORTEL NETWORKS RELATING TO THE SOFTWARE OR THIS AGREEMENT
EXCEED THE PRICE PAID TO NORTEL NETWORKS FOR THE SOFTWARE LICENSE.
5. Government Licensees. This provision applies to a ll Softwa re and docum entation acquired d irectly or i ndirectly 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 th e 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 limitations set out in thi s licen se 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 Communities Directive dated 14 May, 1991, will apply to the
examination of the Software to facilitate interoperability. Licensee agrees to notify Nortel Networks of any such
intended examination of the Software an d may procure support and assistance from Nortel Networks.
7. Term and termination. This license is effective until terminated; however, all of the restrictions with respect to
Nortel Networks’ copyright in the Software and user manuals will cease being effective at the date of expiration of the
Nortel Networks copyright; those restrictions relating to use and disclosure of Nortel 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 immediat ely destroy or return to Nortel Networks the Software, user manuals, and all copies.
Nortel 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 Un ite d Sta t e s e xport control law s an d r egulations, or to any 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 unenforceable 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 Nortel Networks, 4401 Great America Par kwa y,
P.O. Box 58185, Santa Clara, Ca lifornia 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 NORTEL 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 NORTEL
NETWORKS UNLESS NORTEL NETWORKS GIVES ITS EXPRESS WRITTEN CONSENT, INCLUDING AN
EXPRESS WAIVER OF THE TERMS OF THIS AGREEMENT.
iv
308658-14.00 Rev 00
Contents
Preface
Before You Begin .............................................................................................................xiii
Text Conventions .............................................................................................................xiv
Acronyms ........................... .......................... .......................... ......................... .................xvi
Hard-Copy Technical Manuals ........................................................... ....... ...... ....... ...... ....x ix
How to Get Help .............................................................................................................. xx
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-15
Using the Menu Utility ...................................................................................................1-17
Displaying Menus ...................................................................................................1-17
Configuring Menus .................................................................................................1-20
Adding a Command .........................................................................................1-21
Deleting a Command .......................................................................................1-21
Clearing All Commands ...................................................................................1-21
Editing a Command ........................ ............................................. ...... ....... .......1 -2 2
Editing a Menu Title .........................................................................................1-22
Loading a New Menu .......................................................................................1-22
Toggling Menu Titles and Commands .............................................................1-23
Saving Changes Made to Menus ....................... ....... ...... ...... ....... ...... ....... ...... .1-2 7
308658-14.00 Rev 00
v
Chapter 2
Using the show Command
show ahb ........................................................................................................................2-2
show appn ......................................................................................................................2-6
show at .........................................................................................................................2-50
show atm ......................................................................................................................2-66
show atmarp .................................................................................................................2-76
show atmdxi ..................................................................................................................2-84
show atmsig ..................................................................................................................2-94
show atm line ................................................................................................................2-99
show aurp ...................................................................................................................2-111
show autoneg .............................................................................................................2-120
show bgp ....................................................................................................................2-127
show bisync ................................................................................................................2-136
show bootp .................................................................................................................2-146
show bot .....................................................................................................................2-151
show bridge ................................................................................................................2-158
show circuits ...............................................................................................................2-164
show console ..............................................................................................................2-175
show csmacd ..............................................................................................................2-182
show dcm ...................................................................................................................2-195
show decnet ...............................................................................................................2-200
show dls ......................................................................................................................2-214
show ds1e1 ................................................................................................................2-226
show dsx3 ...................................................................................................................2-251
show dvmrp ................................................................................................................2-266
show e1 ......................................................................................................................2-275
show egp ....................................................................................................................2-281
show fddi ....................................................................................................................2-284
show fr ........................................................................................................................2-300
show ftp ......................................................................................................................2-318
show fwall ...................................................................................................................2-319
show hardware ...........................................................................................................2-321
show hifn ....................................................................................................................2-328
show hssi ....................................................................................................................2-331
vi
308658-14.00 Rev 00
show igmp ..................................................................................................................2-339
show ip .......................................................................................................................2-343
show ip6 .....................................................................................................................2-370
show ipx ......................................................................................................................2-377
show iredund ..............................................................................................................2-411
show isdn ....................................................................................................................2-413
show isdn bri ...............................................................................................................2-424
show l2tp ....................................................................................................................2-432
show lane ...................................................................................................................2-435
show lapb ...................................................................................................................2-445
show lnm ....................................................................................................................2-451
show mospf ................................................................................................................2-462
show mpoa .................................................................................................................2-466
show nbip ...................................................................................................................2-469
show nhrp ...................................................................................................................2-471
show nml ....................................................................................................................2-478
show ntp .....................................................................................................................2-482
show osi ......................................................................................................................2-486
show ospf ...................................................................................................................2-495
show packet ................................................................................................................2-504
show ping ...................................................................................................................2-513
show ppp ....................................................................................................................2-517
show process ..............................................................................................................2-547
show protopri ..............................................................................................................2-552
show radius .................................................................................................................2-555
show rarp ....................................................................................................................2-562
show rip6 ....................................................................................................................2-565
show rptr .....................................................................................................................2-567
show rredund ..............................................................................................................2-576
show rsc .....................................................................................................................2-584
show rsvp ...................................................................................................................2-588
show sdlc ....................................................................................................................2-590
show smds ..................................................................................................................2-594
show snmp .................................................................................................................2-599
show span ..................................................................................................................2-607
308658-14.00 Rev 00
vii
show sr .......................................................................................................................2-615
show srspan ...............................................................................................................2-628
show sta .....................................................................................................................2-635
show stac ....................................................................................................................2-638
show state ..................................................................................................................2-640
show sws ....................................................................................................................2-643
show sync ...................................................................................................................2-662
show system ...............................................................................................................2-681
show t1 .......................................................................................................................2-686
show tcp .....................................................................................................................2-694
show telnet .................................................................................................................2-697
show tftp .....................................................................................................................2-699
show token ..................................................................................................................2-700
show vines ..................................................................................................................2-712
show wcp ....................................................................................................................2-723
show wep ....................................................................................................................2-731
show x25 ...................................................................................................................2-737
show xb ......................................................................................................................2-748
show xns .....................................................................................................................2-758
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 dcm .......................................................................................................3-15
enable/disable decnet ...................................................................................................3-17
enable/disable dls .........................................................................................................3-18
enable/disable ds1e1 ....................................................................................................3-19
viii
308658-14.00 Rev 00
enable/disable dvmrp ...................................................................................................3-20
enable/disable e1 ..........................................................................................................3-21
enable/disable fddi ........................................................................................................3-22
enable/disable fr ...........................................................................................................3-23
enable/disable ftp ..........................................................................................................3-24
enable/disable hssi .......................................................................................................3-25
enable/disable igmp ......................................................................................................3-26
enable/disable ip ...........................................................................................................3-27
enable/disable ipx .........................................................................................................3-28
enable/disable iredund ..................................................................................................3-29
enable/disable isdn .......................................................................................................3-30
enable/disable isdn bri ..................................................................................................3-32
enable/disable lapb .......................................................................................................3-33
enable/disable lnm ........................................................................................................3-34
enable/disable nbip .......................................................................................................3-35
enable/disable nml ........................................................................................................3-36
enable/disable osi .........................................................................................................3-37
enable/disable ospf .......................................................................................................3-38
enable/disable packet ...................................................................................................3-39
enable/disable ppp ........................................................................................................3-40
enable/disable rarp .......................................................................................................3-41
enable/disable rptr ........................................................................................................3-42
enable/disable rredund .................................................................................................3-43
enable/disable sdlc .......................................................................................................3-44
disable/enable snmp .....................................................................................................3-45
enable/disable span ......................................................................................................3-46
enable/disable sr ...........................................................................................................3-47
enable/disable srspan ...................................................................................................3-48
enable/disable sta .........................................................................................................3-49
enable/disable sws .......................................................................................................3-50
enable/disable sync ......................................................................................................3-51
enable/disable t1 ...........................................................................................................3-52
enable/disable tcp .........................................................................................................3-53
enable/disable telnet .....................................................................................................3-54
enable/disable tftp .........................................................................................................3-55
308658-14.00 Rev 00
ix
enable/disable token .....................................................................................................3-56
enable/disable vines .....................................................................................................3-57
enable/disable wcp .......................................................................................................3-58
enable/disable x25 ........................................................................................................3-59
enable/disable xb ..........................................................................................................3-60
enable/disable xns ........................................................................................................3-61
Index
x
308658-14.00 Rev 00
Tables
Table 1-1. Displaying Service Information ................................................................1-9
Table 1-2. Enabling and Disabling Services ...........................................................1-15
308658-14.00 Rev 00
xi
Preface
This guide describe s ho w to use Technician Interface sc ripts (
display statistical and configuration information about Nortel Networks
Before You Begin
Before using this guide to issue Technician Interface
complete the following procedures:
• Install the hardware pla tform.
• Use one of the following methods to establish a connection to the platform:
-- Connect the serial port of an ASCII terminal device (for example, a DEC
VT100) directly to the console port of the platform.
-- Connect the serial port of a workstat io n or PC di rectly to the console port
of the platform. (Run ASCII terminal emulation software on the
workstation or PC.)
-- Dial in to the console port of the platform from a workstation or PC
running ASCII terminal emul at ion software. This al ternativ e requires one
modem locally attached to your workst ati on or PC, and another modem
locally attached to the console port of the platform you want to access.
-- Establish a Telnet (in-band) connection to the platform.
show
commands) to
show
commands, you must
™
routers.
Note:
platform must ha v e at lea st one assi gned IP addres s. Althou gh there is no limi t
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 platform.
308658-14.00 Rev 00
Before you can access the Technician Interface using Telnet, the
xiii
Using Technician Interface Scripts
Text Conventions
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.
xiv
Example: If the command syntax is:
ethernet/2/1
ethernet/2/1
[<
parameter> <value
>]
and as many parameter-value pairs as
needed.
. . .
, you enter
308658-14.00 Rev 00
Preface
italic text Indicates file and directory names, new terms, book
titles, and variables in command syntax descriptions.
Where a variable is two or mor e 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 text Indicates system output, for example, prompts and
system messages.
Example:
Set Trap Monitor Filters
separator ( > ) Shows menu paths.
Example: Protocols > I P ide nti fies the I P opt ion 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 enteri ng 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.
308658-14.00 Rev 00
xv
Using Technician Interface Scripts
Acronyms
AN Access Node
ANH Access Node Hub
APING APPN Ping
APPN Advanced Peer-to-Peer Routing
ARP Address Resolution Protocol
ASCII American Stand ard Code for In formation Inte rchange
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
xvi
BLN Backbone Link Node
BLN-2 Backbone Link Node (2 power supplies)
BOOTP Bootstrap Protocol
CLNP Connectionless Network Protocol
CPU Centr al 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
308658-14.00 Rev 00
Preface
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
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 Con trol Message Proto col
IGMP Internet Group Membership Protocol
IN Integrated N ode
IP Internet P rotocol
IP6 Internet Protocol version 6
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
LNM LAN Network Manager
LSP Link State Packet
MAC Media Access Control
MCT1 Multichannel T1
308658-14.00 Rev 00
xvii
Using Technician Interface Scripts
MIB Management Information Base
MOSY Managed Object Syntax
NML Native Mode LAN
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
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
Association
xviii
RIP Routing Information Protocol
RIP6 Routing Information Protocol version 6
RIF Routing Information Field
RFC Request for Comment
SAP Service Access Point
SDLC Synchronous Data Link Control
SIMM Single In-line Memory Module
SMDS S witched Multimegabit Data Serv ices
SNAP SubNetwork Access Protocol
SNMP Simple Network Management Protocol
SR Sour ce Rout ing
SRM-L System Resources Link Module
STA Statistics, Thresholds, and Alarms
SYSCON System Controller board
308658-14.00 Rev 00
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
Hard-Copy Technical Manuals
You can print selected technical manuals and release notes free, directly from the
Internet. Go to support.baynetworks.com/library/tpubs/. Find the product for
which you need documentation. Then locate the specific category and model or
version for your hardw are or soft ware product . Usi ng Adobe Ac robat Re ader, you
can open the manuals and releas e notes, search for the sections you ne ed, and print
them on most standard printers. You can download Acrobat Reader free from the
Adobe Systems Web site, www.adobe.com.
Preface
You can purchase selected documentation sets, CDs, and technical publications
through the collateral catalog. The catalog is located on the World Wide Web at
support.baynetworks.com/catalog.html and is divided into sections arranged
alphabetically:
• 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.
308658-14.00 Rev 00
xix
Using Technician Interface Scripts
How to Get Help
If you purchased a service contract for your Nortel Networks product from a
distributor or authorized reseller, contact the technical support staff for that
distributor or reseller for assistance.
If you purchased a Nort el Net wor ks s ervice pr ogram, c ontact one of the f ollowing
Nortel Networks Technical Solutions Centers:
Technical Solutions Center Telephone Number
Billerica, MA 800-2LANWAN (800-252-6926)
Santa Clara, CA 800-2LANWAN (800-252-6926)
Valbonne, France 33-4-92-96-69-68
Sydney, Australia 61-2-9927-8800
Tokyo, Japan 81-3-5402-7041
xx
308658-14.00 Rev 00
Chapter 1
Introducing Technician Interface Scripts
This chapter pro vides an o ve rvie w of the Technic ian Interf ac e scripts and explai ns
how to run them. It also describes how to:
• Load scripts.
• Set up scrip ts.
• Use script commands.
• Use the menu utility.
This guide assumes that you have a working knowledge of the Nortel Networks
Technician Interface. For complete information about this router management
tool, see Using Technician Interface Software. For information on how to write
your own Technician Interface scripts, see Writing Technician Interface Scripts.
308658-14.00 Rev 00
1-1
Using Technician Interface Scripts
What Are Technician Interf ace Scripts?
Script Types
The Technicia n I nterf ac e
show/monitor
enable/disable
and
scripts are programs
that enable you to view and use information stored in the Nortel 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.
Most Technician Interface scripts run from a <protocol_name>.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 supp orts
one .bat file for each router protoc ol or service. Each .bat f ile c ontains t he routi nes
for all script subcommand options for a protoc ol or ser vi ce. The rout i ne cal led by
each subcommand genera tes and pri nts (to the router cons ole) stat istics that re v eal
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.
1-2
Other Technician Interface scripts are programs embedded within the router
software image. The router software currently includes embedded scripts for the
following services:
• CSMACD • SNMP
• FR • SYNC
• FTP • TCP
• IP • TELNET
• MOSPF • TFTP
•RIP
308658-14.00 Rev 00
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 so ftware supports scripts in the following command categories:
show
monitor
enable/disable
menu
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.
Displays the same information as the show command but
refreshes the display periodically so you can observe trends
and changes. Since you can use
this manual does not describe syntax for the
command. This command uses the monitor.bat file.
Enables or disables system features, protocols, drivers, or
individual circuits. These commands use the enable.bat and
disable.bat files.
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.
<protocol_name>
} {
<subcommand_option>
monitor in place of show,
}
monitor
Each
configuration information about a particular service or driver running on the
router.
308658-14.00 Rev 00
show command supports a subset of commands that display statistical and
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 abou t router memory , b uff ers, driv ers,
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.
1-4
To establish the search path used to find the script files, use the
run setpath
command. It define s the aliases that integrate scripts in to the Technician Interface
command se t. The sectio n “Setting Up Scripts” explains the
run setpath
command, which uses the setpath.bat script.
308658-14.00 Rev 00
Installing .bat and .mnu Files
You can use the Nortel 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.
dir
•Run the
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
command to verify that you have sufficient contiguous freespace
dir
command.)
Introducing Technician Interface Scripts
•Run the
compact
command on the NVFS volume reserved for scripts and
their associated me nu files. (Refer t o Cha pter 8 of Using Technician Interfac e
Softwar e 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 direct ory on a UNIX
workstation, change to that directory using the
cd
command. Then enter the
following commands at the UNIX command line prompt:
ftp
$:
<router IP address>
Manager
Name:
Password:
ftp>
ftp>
ftp>
ftp>
ftp>
<Technician_Interface_password>
cd
<router volume>
bin
prompt
mput *.bat
mput *.mnu
:
The
each file.
308658-14.00 Rev 00
prompt
command disables t he pr ompt that asks whether you w ant to transfer
1-5
Using Technician Interface Scripts
Note:
You must have Manager access to write to an NVFS volume using the
Nortel Networks implementation of FTP.
This procedure inst alls al l of th e . 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. Ho wever, before you run an y . bat ver sion scri pts, des ignate a def ault
file system volume, as shown in the following example:
1-6
dir 2:
Next, define the search path and alias definitions for your .bat and .mnu version
script f iles b y usin g t he
run setpath
command. The search path is a li st of v o lume
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 -- Ente ring the volume IDs on the command line
run setpath "2:;3:;4:"
308658-14.00 Rev 00
Introducing Technician Interface Scripts
Example 2 -- Letting the
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: <vol>:[;<vol>: ...]
Example: 2:;3:;4:
Enter volume(s)[2:]:
setpath
3:
command prompt you for input
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 i nformation on the autoscript feature, see Chapter 2 of
Using Technician Interface Software.
308658-14.00 Rev 00
1-7
Using Technician Interface Scripts
Using Script Commands
This section provides an overview of the
commands.
Using the show Command
After you set up scripts with the
<subcommand> <option> command to obtain a snapshot view of various data
stored in the router. For continuously updated (polled) views of system statistical
and configurat ion data, use th e
For all protocols, you can view circuit alerts, the base record, disabled or enabled
circuits, and statistics.
Table 1-1
lists the
software entity. Alternatively, obtain an active list of
subcommands directly from the router by entering at the Technician Interface
prompt
show
<entity_name>
or:
show
<entity_name>
For example, to list the AppleTalk subcommands, enter
For a detailed description of all
they generate, refer to Chapte r 2 .
show/monitor
?
help
run setpath
monitor
command in place of the
show/monitor
command, you can use the
enable/disable
and
show
subcommands for a specific service or
show/monitor
show at
show
commands and samples of the information
or
show
command.
show at ?
.
1-8
308658-14.00 Rev 00
Introducing Technician Interface Scripts
Table 1-1. Displaying Service Information
To Display Information about This Service Use This Command
Command Type
(runs from a batch
or embedded file)
batch embedded
Asynchronous Transfer Mode Half-Bridge (AHB) service
(base, circuits, hosts, routes, statistics)
Advanced Peer-to-Peer Networking service
(adjacencies, class of service, directories, DLC, DLUR,
endpoints, ISR, memory, mode, ports, topology, tunnels,
VRN)
AppleTalk service (AARP, circuits, configuration, routes,
statistics, zones, zone filters)
Asynchronous Transfer Mode service (interfaces, lines,
PVCs, statistics)
ATM Address Resolution Protocol service (ATMARP
client/server mode identification, ATM addresses,
interface sta tis tic s)
Asynchronous Transfer Mode DXI service (lines, PVCs,
statistics)
ATM line signaling service (ATM ILMI and SAAL
statistics)
Asynchronous Transfer Mode (ATM) Adaption Layer
Controller (ALC) link module service (circuits, phy,
transmit and receive errors, transmit and receive
statistics)
AppleTalk Update-based Routing Protocol service
(connection, statistics, zone filters)
Automatic line sp eed negot iation on 100Base-T Ethernet
interfaces (alerts, circuits enabled/disabled)
Border Gateway Protocol service (errors, peers, routes,
timers, statistics, summary, weights, version)
Binary Synchronous service (errors, sample periods,
circuit statistics)
Bootstrap Protocol service (clients, relay agents,
statistics)
show ahb
show appn
show at
show atm
show atmarp
show atmdxi
show atmsig
show atm line
show aurp
show autoneg
show bgp
show bisync
show bootp
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
(continued)
308658-14.00 Rev 00
1-9
Using Technician Interface Scripts
Table 1-1. Displaying Service Information
To Display Information about This Service Use This Command
Binary Synchronous Communication (BSC) over TCP
service (circuit, port, peer, and control unit connection
statistics)
Bridge service (circuits, forwarding tables, statistics)
Circuits for all drivers (configuration; hardware filters;
receive, transmit, and system errors; statistics)
Console (configuration, statistics)
CSMA/CD service (hardware filters; receive, transmit
and system errors; statistics; sample data)
N11 Data Collection Module (DCM) information for the
8-Port Access Node Hub (ANH)
DECnet service (adjacency, circuits, designated router,
routes, statistics, traffic filters)
Data Link Switching service (circuits, configuration,
connections, MAC, NETBIOS, peer, SAPs, slot numbers)
DS1/E1 lines (clock, E1 framer and E1 port, FDL;
receive, transmit, and system errors; sample data;
statistics; T1 framer and T1 port; timeslots)
DS3/E3 lines (circuit stats for ATM interfaces)
Distance Vector Multicast Routing Protocol service
(circuits, neighbors, routes, statistics, tunnels)
E1 lines (frame and line errors)
Exterior Gateway Protocol service (neighbors, statistics)
Fiber Distributed Dat a Interf ace s ervice (hardware filters;
MAC, port, and SMT parameters; receive, transmit, and
system errors; sample data; statistics)
Frame Relay service (LAPF, lines, passthrough, PVCs,
signalling, statistics, SVCs, virtual connections)
File Transfer Protocol service (login, error, and transfer
rate statistics)
(continued)
show bot
show bridge
show circuits
show console
show csmacd
show dcm
show decnet
show dls
show ds1e1
show dsx3
show dvmrp
show e1
show egp
show fddi
show fr
show ftp
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
<option>
Command Type
(runs from a batch
or embedded file)
batch embedded
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
✔
(continued)
1-10
308658-14.00 Rev 00
Loading...