All rights reserved. December 2000.
The information in this document is subject to change without not i ce. The statements, configu r ations, 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 Nortel Networks NA Inc.
Trademarks
NORTEL NETWORKS is a trademark of Nortel Networks.
Bay Networks, Nortel Networks Extranet Switch 1500, Contivity, Extranet Ready, Personal Extranets, and
Infrastructure for Extranets are trademarks of Nortel Networks.
Microsoft, MS, MS -DOS, Win32, Windows, and Windows NT are registered trademar ks of Microsoft Corporation.
All other trademarks and registered trademarks are the property of their respective owners.
Restricted Rights Legend
Use, duplication, or disclosure by the United States Government is sub ject to restrictions as set forth in subparagrap h
(c)(1)(ii) of the Rights in Technical Data and Computer Software 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 clause at FAR 52.227-19.
Statement of Conditions
In the interest of improv in g inte rn al d esi gn , o pera tiona l fun c tio n, a nd/or re lia bi lity, Norte l Netwo rks NA Inc. reserves
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.
SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANT ABILIT Y AND FITNESS FOR A PARTICULAR PURPOSE.
In addition, the program and information contained herein are licensed only pursuant to a license agreement that
contains restricti ons on use and disclosure (that may incorpor ate by reference certain limitations and notices imposed
by third parties).
USA Requirements Only
311645-A Rev 00
Federal Communications Commission (FCC) Compliance Notice: Radio Frequency Notice
Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to
Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference
when the equipment is operat ed in a commercial environment. This equipment generates, uses , and can radiate radio
frequency energy. If it is not installed and used in accordance with the instruction manual, it may cause harmful
interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful
interference, in which case users will be requ ired to take whatever measures may be necessary to correct the
interference at their own expense.
European Requirements Only
EN 55 022 Statement
This is to certify that the Nortel Networks Contivity Extranet Switch is shielded against the generation of radio
interference in accordance with the application of Council Directive 89/336/EEC, Article 4a. Conformity is declared
by the application of EN 55 022 Class A (CISPR 22).
Warning: This is a Class A product. In a domestic environment, this product may cause radio interference, in which
case, the user may be required to take appropriate measures.
Achtung: Dieses ist ein Gerät der Funkstörgrenzwertklasse A. In Wohnbereichen können bei Betrieb dieses Gerätes
Rundfunkstörungen auftreten, in welchen Fällen der Benutzer für entsprechende Gegenmaßnahmen verantwortlich
ist.
Attention: Ceci est un produi t de Classe A. Dans un environnement domestique, ce produit risque de créer des
interférences radioélectriques, il appartiendra alors à l’utilisateur de prendre les mesures spécifiques appropriées.
3
EC Declaration of Conformity
This product conforms (or these products conform) to th e provisions of Council Directive 89/336/EEC and
73/23/EEC. Go to http://libra2.corpwest.baynetworks.com/cgi-bin/ndCGI.exe/DocView/ on the Nortel Networks
World Wide Web site for a copy of the Declaration of Conformity.
Japan/Nippon Requirements Only
Voluntary Control Council for Interference (VCCI) Statement
Canada Requirements Only
Canadian Department of Communications Radio Interference Regulations
This digital apparatus (Contivity Extranet Switch) does not exceed the Class A limits for radi o-noise emissions from
digital apparatus as set out in the Radio Interference Regulations of the Canadian Department of Communications.
Reference for the Contivity VPN Switch Command Line Interface
4
Règlement sur le brouillage radioélectrique du ministère des Communications
Cet appareil numérique (Contivity Extranet Switch) respecte les limites de bruits radioélectriques visant les appareils
numériques de classe A prescrites dans le Règlement sur le brouillage radioélectrique du minist ère d es
Communications du Canada.
Nortel Networks NA Inc. Software License Agreement
NOTICE: Please carefully read this license agreement before copying or using the accompanying software or
installing the hardware un it with pre -e nable d so ftware (each of which is referred to as “Software” in this Agreeme nt).
BY COPYING OR USING THE SOFTWARE, YOU ACCEPT ALL OF THE TERMS AND CONDITIONS OF
THIS LICENSE AGREEMENT. THE TERMS EXPRESSED IN THIS AGREEMENT ARE THE ONLY TERMS
UNDER WHICH NORTEL NETWORKS WILL PERMIT YOU TO USE THE SOFTWARE. If you do not accept
these terms and conditions, return th e product, unused an d in the original ship ping 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, nonexclusive, n ontransfera ble lice nse: a) to use th e So ftware eith er on a single computer or, if applicable, on
a single authorized device identified by host ID, for which it was originally acquired; b) to copy the Software solely
for backup purposes in support of aut horized use of the Software; and c) to use and copy the associated user manual
solely in support of au thorized use of the So ftware by Lic ensee. Th is license ap plies to th e Softwa re only and do es no t
extend to Nortel Networks Agent software or other Nortel Networks software products. Nortel Netw or ks 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 under cop yri ght laws.
Nortel Networks and/or its licensors retain all title and ownership in both the Software and user manuals, including
any revisions made by Nor tel Networks or its li censors. The copyright notice must be reproduced and included wit h
any copy of any portion of the Software or user manuals. Licensee may not modify, translate, decompile, disassemble,
use for any competitive an alysis, reverse engineer, distribute, or crea t e de r i va t ive works from the S o f t w are 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 us er manuals embody Nortel Networks’
and its licensors ’ co nf iden tia l an d proprietary intellectua l p rop er ty. Licensee shall not sublicense, a ssign , or oth e rwise
disclose to any thir d 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, and agents to use the Software at Licensee’s facility ,
provided they have agreed to use the Software on ly 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 i ts accompanying user manual during i ts warranty period, which begins on the date
Software is first shipped to Licensee. If any item of S oftware fails to so function durin g its warranty perio d, 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 defects in materials and workmanship under normal use for a period of 90 days
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 shipment. This warra nty does
not apply if the media has been damaged as a result of accident, misuse, or abuse. The Licensee assu mes all
responsibility for selection of the Software to achieve Lice nsee’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 operat e in the hardware or software co mbinations tha t
the Licensee may select, c) that the operati on of th e So ft ware will be uninterrupted or error free, or d) that all defects
in the operation of the Software will be corrected. Nortel Networks is not obligated to remedy any Software defect
311645-A Rev 00
that cannot be reproduced with t he latest S oftware r elease. Thes e warranties d o not a pply to the S oftware if it has been
(i) altered, except by Nortel Networks or in accordance with its instructions; (ii) used in conjunction with another
vendor’s produc t, resultin g in the defe ct; or (iii) damag ed by improp er env iron m ent, abuse , misuse , acci dent , or
negligence. THE FOREGOING WARRANTIES AND LIMITATIONS ARE EXCLUSIVE REMEDIES AND ARE
IN LIEU OF ALL OTHER W ARRANTIES EXPRE SS 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 ADVIS ED OF THE POSSIBILITY OF S UCH DAMAGES. IN NO EVENT
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 all Software and docume ntation acquired d irectly o r indirec tly by
or on behalf of the United States Government. The Software and documentation are commercial products, licensed on
the open market at market prices, and were developed entirely at private expense and without the use of any U.S.
Government funds. The license to the U.S. Gov e rnme nt is gr anted o nly with restric te d rights, and use , du p licat ion , or
disclosure by the U.S. Government is subject to the restrictions set forth in subparagraph (c)(1) of the Commercial
Computer Software––Restricted Rights clause o f FAR 52.227-19 and the limit ati ons se t o ut in th is lic ense fo r c ivilia n
agencies, and subpa ragraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause of DFARS
252.227-7013, for agencies of the 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 Co uncil 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 fro m 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 ef fective at the date of expiration of the
Nortel Networks copyright; those restriction s relatin g to use and disclosu re of Nortel Netwo rks ’ con fide n tial
information shall continue in effect. Licensee may terminate this license at any time. The license will automatically
terminate if Licensee fails to comply with any of the terms and conditions of the license. Upon termination for any
reason, Licensee will immediately destroy or return to 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 r e-exp ort. 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 behal f of itself and its subsidia ries and af fi liates, agrees th at it will not, wit hout first obtain ing
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 ther eof, to any country to which such exports o r re-exports are
restricted or em bar go ed un der U nited State s expo rt co ntr ol laws and re gula tions, o r to a ny nation al or r esi dent of such
restricted or embargoed co untrie s; or (ii) pro v ide the So ftwa re or relate d tec hnic al dat a or inform a tio n to any mi litary
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 quest i ons concerning this Agreement , contact Nortel Networks, 4401 Great America Parkway,
P.O. Box 58185, Santa Cl ara, California 95054-8185.
5
Reference for the Contivity VPN Switch Command Line Interface
6
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.
This book is intended for Nortel Network sTM ContivityTM VPN Switch managers
and administrators. It provides reference information for each of the Web browser
configuration screens.
Conventions
This guide refers to the Contivity VPN Switch as the switch.. This g uide assumes
that you are familiar with Web browsers and their general operation.
Documentation
This document uses the following conventions to distinguish among notes of
varying importance.
27
Note:
materials contained in this document.
Caution:
could result in damage to the equipment or loss of data.
Warning:
Before working on equipment, beware of the hazards involved with
electrical circuitry and standard pr act ic es f or preven ti ng accidents, such
as disconnecting equipment from its power source.
Take notice. Notes contain helpful suggestions or references to
Be careful. In this situation, you might do something that
Danger. Y o u are in a s ituat io n that could cause bodil y inj ury.
Reference for the Contivity VPN Switch Command Line Interface
28 Preface
Related publications
The following list shows the associated documentation that you will need to
configure and manage the switch and describes the document’s objectives.
•Contivity VPN Switch Release Notes provide the late st inf orma ti on, including
known problems, workarounds, and special considerations.
•Configuring the Contivity VPN Switch (included on the CD) provides
complete details to configure, monitor, and troubleshoot the switch.
•Reference for the Contivity VPN Switch provides reference information for
each of the Web browser configuration screens.
Text
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
311645-A Rev 00
bold Courier text
Indicates command names, options, and text that you
need to enter.
Example: Use the
Example: Enter
show ip
dinfo
command.
{alerts|routes}
.
braces ({})Indicate required e lements in synta x 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.
Preface 29
brackets ([ ])Indicate optional elements in syntax descriptions. Do
not type the brackets when entering the command.
Example: If the command syntax is
show ip interface [-alerts]
show ip interface
either
show ip interface -alerts
or
.
, you can enter
ellipsis points (. . . )Indicate that you repeat the last element of the
command as needed.
Example: If the command syntax is
ethernet/2/1 [<parameter> <value>]...
you enter
ethernet/2/1
and as many
,
parameter-value pairs as needed.
italic textIndicates new terms, book titles, and variables in
command syntax descriptions. Where a variable is two
or more words, the words are connected by an
underscore.
Example: If the command syntax is
show at <valid_route>, valid_route
is one
variable and you substitute one value for it.
plain Courier
text
Indicates command syntax and system output, for
example, prompts and system messages.
Example: Set Trap Monitor Filters
separator ( -> )Shows menu paths.
Example: Protocols -> IP id entif ies the IP opt ion on t he
Protocols menu.
vertical line (
)Separates choices for command keywords and
|
arguments. Enter only one of the choices. Do not type
the vertical line when entering the command.
Example: If the command syntax is
show ip {alerts|routes}
show ip alerts or show ip routes
both.
Reference for the Contivity VPN Switch Command Line Interface
, you enter either
, but not
30 Preface
Acronyms
This guide uses the following acronyms:
AUIattachment unit interfac e
BootPBootstrap Protocol
BRIbasic rate interface
CSMA/CDcarrier sense multiple access/collision detection
DLCMIData Link Control Management Interface
HDLCHigh-level Data Link Control
IPInternet Protocol
ISDNIntegrated Services Digi tal Network
ISOInternatio nal Organization for Standardization
ITU-TInternational Telecommunication
MACmedia accountants control
MAUmedia access unit
MDI-Xmedium dependent interface crossover
NBMAnonbroadcast multi-access
OSPFOpen Shortest Path First
PPPPoint-to-Point Protocol
SMDSSwitched Multimegabit Data Service
SNMPSimple Network Management Protocol
STPshielded twisted pair
TPEtwisted pair Ethernet
Hard-copy technical manuals
You can print selected technical manuals and release notes free, directly from the
Internet. Go to the www25.nortelnetworks.com/library/tpubs/ URL. Find the
product for which you ne ed do cumen tat ion. Then locate the speci fic category and
model or version for your hardware or software product. Use Adobe Acrobat
Reader to open the manuals and release notes, search for the sections you need,
and print them on most standard printers. Go to Adobe Systems at the
www.adobe.com URL to download a free copy of the Adobe Acrobat Reader.
You can purchase selected documentation sets, CDs, and technical publications
through the Internet at the www1.fatbrain.com/documentation/nortel/ URL.
You can purchase Nortel Networks documentation sets, CDs, and selected
technical publications through the Nortel Networks Collateral Catalog. The
catalog is located at support.baynetworks.com/catalog.html:
•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.
Preface 31
Make a note of the part numbers and prices of the items that you want to order.
Use the “Marketing Collateral Catalog description” link to place an order and to
print the order form.
User interface help button
Click the Help button that is located in the upper right of displays to learn about
fields on a given page. Where appropriate, the information provides cause and
effect of an action; otherwise, it might offer troubleshoot
Reference for the Contivity VPN Switch Command Line Interface
32 Preface
Nortel Networks Customer Service
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 w orks s ervic e progr am, cont act on e of t he fol lo win g
Nortel Networks Technical Solutions Centers:
Technical Solutions CenterTelephone
EMEA(33) (4) 92-966-968
North America(800) 2LANWAN or (800) 252-6926
Asia Pacific(61) (2) 9927-8800
China(800) 810-5000
An Express Routing Code (ERC) is available for many Nortel Networks products
and services. When you use an ERC, your call is routed to a technical support
person who speciali zes in supp orting t hat product or servi ce. To locate an ERC for
your product or service, go to the www12.nortelnetworks.com/ URL and click
ERC at the bottom of the page.
311645-A Rev 00
Chapter 1
Introduction
This chapter provides an int rodu ction to the Contivity VPN Switch Command
Line Interface (CLI).
Accessing the CLI
Access from a Telnet session
You access the CLI by starting a Telnet session to the switch’s Management IP
Address, for example:
telnet 10.0.16.247
You then log into the switch using an account with administrator privileges, for
example:
33
Login: admin
Password: *******
%%
Upon login, the CLI prompt appears (%%), indicating that you are in the CLI User
Exec Mode. You can execute any User Exec Mode commands or change the
command mode in order to execute other commands.
Note:
the CLI via a Telnet connection. Use the Services->Available screen to
enable the Telnet management protocol.
The Telnet protocol must be enab led on the switch in or der t o us e
Reference for the Contivity VPN Switch Command Line Interface
34 Chapter 1 Introduction
Access from the serial port menu
You can access the CLI through the Serial Port menu if you have a serial port
connection to the switch. Select L from the Serial Port menu, shown below, to
access the CLI.
Figure 1 Serial Port Menu
Command modes
The switch CLI has thre e command modes.
•User Exec Mode
•Privileged Exec Mode
•Global Configuration Mode
311645-A Rev 00
Table 1 CLI Modes, Prompts and Access
ModePromptAccess
Chapter 1 Introduction 35
User Exec ModeCES>Login via
Privileged Exec ModeCES#Enter the command
Global Config Mode
User Exec Mode
This is the initial command mode when the administrator first establishes a Telnet
connection to the switch. It is also called Exec mode.
This is a limited display mode. You cannot modify configuration parameters or
view the configuration file.
User Exec Mode prompt
CES>
User Exec Mode commands
The following table summarizes the User Exec Mode commands.
CES(config)#
with
and
Mode prompt.
Enter the command
the Privileged Exec Mode prompt.
Telnet
password
administrator name
.
enable
configure terminal
at the User Exec
at
Table 2 User Exec Mode Commands
CommandDescription
clear ip routeRemove a route from the route table
enableEnable privileged commands
exitExit the Telnet session
helpDisplay message about using help
pingSend ping message to a destination
show file systemsList available file sys tems
show flash: contentsDisplay flash se ttings
Reference for the Contivity VPN Switch Command Line Interface
36 Chapter 1 Introduction
Table 2 User Exec Mode Commands
CommandDescription
show ip access-listDisplay IP access lists
show ip ospfDisplay IP OSPF routing details
show ip ospf databaseDisplay IP OSPF database summary
show ip ospf interfaceDisplay IP OSPF interfaces
show ip ospf neighborDisplay IP OSPF neighbor list
show ip ripDisplay IP RIP details
show ip rip databaseDisplay info about routes owned and
show ip rip interfaceDisplay info about interfaces
show ip routeDisplay IP routing table
show ip route-policiesDisplay IP route policies
show ip trafficDisplay information on IP traffic to/
show ip vrrpDisplay IP VRRP settings
show reloadShow details of pending switch
show sessionsShow current switch sess ions
show versionShow switch configuration and
traceTrace the route to a destination
whoDisplay active Telnet sessions on
imported by RIP
configured fo r RIP
from switch
reboot
hardware
switch
311645-A Rev 00
Privileged Exec Mode
This command mode is entered from User Exec mode with the enable command.
The administrator c an e xi t fr om this mode with the disab le comman d, the y wi ll be
returned to User Exec mode.
This is a full display and configuration mode; it enables additional commands to
those in User Exec mode. Exec commands are typically one-time commands, for
example, show commands and clear commands.
Privileged Exec Mode prompt
CES#
Privileged Exec Mode commands
The following table summarizes the Privileged Exec Mode commands
Table 3 Privileged Exec Mode commands
CommandDescription
Chapter 1 Introduction 37
clear arp-cacheClear ARP cache
clear logging eventsClear event log
configureEnter configuration mode
disableTurn off privileged commands
helpDisplay message about using help
killTerm inate a Telnet sessio n
moreDisplay the contents of a named file
reloadReboot switch immediately
reload atSchedule a switch reboot
reload cancelCancel pending reboot
reload inSchedule a switch reboot
reload no-sessionsSchedule switch reboot when no
show arpShow ARP cache contents
show healthShow overall system health
show logging configShow configuration log contents
more sessions
Reference for the Contivity VPN Switch Command Line Interface
38 Chapter 1 Introduction
Table 3 Privileged Exec Mode commands
CommandDescription
show logging eventsShow event log contents
show logging historyShow the logging history setting
show logging securityShow security log contents
show logging syslogShow system log contents
Global Configuration Mode
This mode allows the administrator to make changes to the switch running
configuration. These changes are saved across reboots. This mode is also used to
access other configuration modes (Router, and so on, to be supported in
subsequent releases). The administrator enters this mode from Privileged Exec
mode using the configure command. To leave this mode and return to Privileged
Exec mode, the user enters Ctrl-Z.
Global Configuration Mode prompt
311645-A Rev 00
CES(config)#
Global Configuration Mode commands
The following table summarizes the Global Configuration Mode commands.
default logging historySet logging history level to default
value
enable passwordAssign privileged level password
endExit from configure mode
Chapter 1 Introduction 39
Table 4 Global Configuration Mode commands
CommandDescription
exitExit from configure mode
helpDisplay message about using help
ip http serverEnable/disable HTTP management
ldapControl LDAP server (Mini-CLI)
loadBulk load configurati on com m and s
(Mini-CLI)
logging historyControl system logging level
logoutExit the Telnet session (Mini-CLI)
resetSet s witch system boot mode
restore flashRestore factory default switch flash
restore systemRestore factory default switch
restrictRestrict management access to
save current_bootSave current boot config (Mini-CLI)
shutdownShutdown the switch (Mini-CLI )
snmp-server contactSet the contact details for the switch
snmp-server locationSet the locations details for the switch
snmp-server nameSet the administrative name for the
(Mini-CLI)
settings
configuration
(Mini-CLI)
switch
Key bindings
You can use the Nortel Networks CLI (NNCLI) commands to edit command line
text entries. Table 2 describes key bindings for NNCLI.
Table 5 NNCLI key bindings
KeysFunction
control-A start of line
control-B back 1 character
control-C abort command
Reference for the Contivity VPN Switch Command Line Interface
40 Chapter 1 Introduction
Table 5 NNCLI key bindings
KeysFunction
control-D delete 1 character
control-E end of line
control-F forward 1 character
control-H & delete character left of cursor
control-I & com mand/parameter completion
control-K delete all characters after cursor
control-L & control-Rre-display line
control-N or down arrow next history command
control-P or up arrowprevious history command
control-Q escape sequence for unprintables
control-T transpose characters
control-Udelete entire line
control-W delete word left of cursor
311645-A Rev 00
control-X delete all characters before cursor
delete character at cursor
control-z “end” out of config mode
? context-sensitive help
esc-c & esc-u capitalize character at cursor
esc-l convert character at cursor to lowercase
esc-b backward 1 word
esc-d delete 1 word to the right
esc-f forward 1 word
Chapter 2
CLI Command Summary
This chapter provides a summary of all CLI commands. The Commands are listed
in alphabetical order.
arp
This command modifies the contents of the Address Resolution Protocol (ARP)
cache. On the Conti vit y VPN Switch, only t he no form of the de fa cto comma nd is
supported. There is no command to add a permanent entry to the ARP cache.
Syntax
no arp ip-address
41
Parameters
ip-addressThe IP address to be removed from the ARP cache.
Default
None
Command mode
Global Configuration
Reference for the Contivity VPN Switch Command Line Interface
42 Chapter 2 CLI Command Summary
Next command mode
Global Configuration
Related commands
show arp
clear arp-cache
311645-A Rev 00
audible alarm
This command enables and disables the audible alarm on the switch that is
sounded under certain error conditions.
Syntax
audible alarm
no audible alarm
Parameters
None
Default
Audible alarm is enabled.
Command mode
Chapter 2 CLI Command Summary 43
Global Configuration
Next command mode
Global Configuration
Related commands
show health
Example
CES(config)#no audible alarm
This example shows the audible alarm being switched off for the switch.
Reference for the Contivity VPN Switch Command Line Interface
44 Chapter 2 CLI Command Summary
clear arp-cache
This command deletes all dynamic entries from the ARP cache, to clear the
fast-switching cache, and to clear the IP route cache
Syntax
This command has no arguments or ke ywords.
clear arp-cache
Parameters
None
Default
None
Command mode
Next command mode
Related commands
311645-A Rev 00
Privileged Exec
Privileged Exec
arp
show arp
clear ip route
This command removes a route from the route table. Note that Static Routes are
not removed from the switch browser interface by this command. This command
is intended as a troubleshooting tool for use when routing problems are being
caused by the presence of a wrong route.
Syntax
Chapter 2 CLI Command Summary 45
clear ip route
address [mask]
Parameters
addressThe address of the network to remove from route table.
maskThe mask associated with the address to remove.
Default
The mask defaults to 255.255.255.255.
Command mode
User Exec
Next command mode
User Exec
Warnings
Address not found in route table.
Reference for the Contivity VPN Switch Command Line Interface
46 Chapter 2 CLI Command Summary
Related commands
show ip route
Example
CES>clear ip route 10.11.0.12
311645-A Rev 00
clear logging events
This command is used to clear the contents of the system events log.
Syntax
clear logging events
Parameters
None
Default
None
Command mode
Chapter 2 CLI Command Summary 47
Privileged Exec
Next command mode
Privileged Exec
Related commands
show logging events
Example
CES>clear logging events
The example shows the command in use. This command does not give any
feedback to the user.
Reference for the Contivity VPN Switch Command Line Interface
48 Chapter 2 CLI Command Summary
configure
This command puts the CLI into global configuration mode. This allows the
administrator to access global configuration mode commands. To exit this mode,
the user can enter [control]-Z, the exit command, or the end command.
All global configuration commands are entered from the terminal.
Syntax
configure terminal
Parameters
None
Default
None
Command mode
Next command mode
Related commands
Examples
311645-A Rev 00
Privileged Exec
Global configuration
disable
enable
end
CES#configure
CES(config)#end
console mode
Chapter 2 CLI Command Summary 49
Note:
You must have a contr ol tunnel es tablishe d before you can set this
command.
This is a mini-CLI command that a llows emulation of CLI commands av ail able i n
earlier versions of the Contivity VPN Switch software.
This command controls which menu items are visible on the serial port console
for the switch, and what CLI commands can be used.
When this command is used to set the switch in one of the two restricted modes,
the only CLI commands that are available are:
disable
enable
exit
reload
reload at
reload in
reload no-sessions
Because none of the Global Configuration mode commands are allowed, setting
the switch into a rest ricted mode ca uses the CLI to re turn to Pri vile ged Ex ec mode
on the Telnet session where the comman d i s issued. Other Telnet sessions will not
be forced back to Pr ivileged Exec mode, but th ey will only support the above CLI
command se t.
The switch can be set back to an unrestricted mode on the System->Settings Web
management page.
Syntax
console mode {
restricted1|restricted2|show
Reference for the Contivity VPN Switch Command Line Interface
}
50 Chapter 2 CLI Command Summary
Parameters
restricted1The system reset and reload commands to change the IP
interface address and mask are enabled.
restricted2Only the system reload commands are enabled. The reload
command in the CLI only supports the boot-safe and
boot-normal parameters.
showDisplay the current console mode setting.
Default
The system boots in unrestricted mode, where all commands are enabled.
Command mode
Global configuration
Next command mode
Related commands
Examples
311645-A Rev 00
Global configuration (console mode show) or Privileged Exec
reload
reload at
reload in
reload no-sessions
CES(config)#console mode show
CONSOLE MODE is set to UNRESTRICTED
Chapter 2 CLI Command Summary 51
CES(config)#console mode restricted1
CONSOLE MODE has been set to RESTRICTED1.
CES#?
Exec commands:
disableTurn off privileged commands.
enableTurn on privileged commands.
exitExit the Telnet session.
reloadStop and perform a cold restart.
These examples show the default console mode setting, and how setting the
console mode to re stricted forces t he user back to Pr i vile ged Ex ec mode a nd limits
the available CLI commands.
Reference for the Contivity VPN Switch Command Line Interface
52 Chapter 2 CLI Command Summary
control
This command allo ws emulati on of CLI commands a v aila ble in earli er ver sions of
the switch software.
This command allows the administrator to create or delete control tunnels and to
display the currently existing control tunnels.
Control tunnels provide a secure means to manage the switch.
Syntax
control [
help
create|delete|show
] {
Parameters
helpIf present, the control command is not Executed, but some Help
about the command is displayed..
createCreate control tunnels.
deleteDelete control tunnels.
showDisplay the current control tunnels.
Command mode
Global configuration
Next command mode
Global configuration
}
Related commands
311645-A Rev 00
None
Examples
CES(config)#control Help delete
CES(config)#control create
CES(config)#control show
Chapter 2 CLI Command Summary 53
Reference for the Contivity VPN Switch Command Line Interface
54 Chapter 2 CLI Command Summary
disable
This command makes the CLI parser exit from Privileged Exec mode and return
to user Exec mode.
Syntax
disable
Parameters
None
Default
None
Command mode
Next command mode
311645-A Rev 00
Privileged Exec
User Exec
Related commands
configure
enable
end
Example
CES#disable
CES>
Chapter 2 CLI Command Summary 55
Reference for the Contivity VPN Switch Command Line Interface
56 Chapter 2 CLI Command Summary
enable
This command puts the CLI parser into Privileged Exec mode , allowing the
administrator to use additional CLI commands.
The administrator i s prompted for a case-sensitiv e password before they can enter
privileged Exec mode. This password is created when the administrator user
account is set up using the Web management pages.
The user gets three attempts to ente r the password . After the third incorrect
attempt an error message is displayed (Bad secrets) and the User Exec prompt is
redisplayed.
Syntax
enable
Parameters
Default
Command mode
Next command mode
Warnings
311645-A Rev 00
None
None
User Exec
Privileged Exec
%Bad secrets
Related commands
configure
disable
enable password
Example
CES>enable
Password: fred (The password does not display.)
CES#disable
CES>
Chapter 2 CLI Command Summary 57
Reference for the Contivity VPN Switch Command Line Interface
58 Chapter 2 CLI Command Summary
enable password
This command allows the user to change the password used by the enable
command to get into privileged Exec mode. This is the same password as set on
the Profiles->Users Web page for the administator (user admin) account.
If the new password is not different from the existing password, a warning
message is g enerated.
Syntax
enable password
password
Parameters
passwordThe password is defined that the administrator types to enter
enable mode. This password is case sensitive.
Default
The default password is defined when the (administrator) user admin account is
created on the Profiles->Users Web management page.
Command mode
Global configuration
Next command mode
Global configuration
Warnings
311645-A Rev 00
New password is same as current one.
Related commands
configure
disable
enable
Examples
CES(config)#enable password fred
CES(config)#exit
CES#disable
CES>enable
Password: fred
CES#configure
CES(config)#enable password jane
CES(config)#exit
CES#disable
CES>enable
Password: fred
Password: joan
Password: charles
% Bad secrets
Chapter 2 CLI Command Summary 59
CES>enable
Password: jane
CES#configure
CES(config)#enable password jane
The enable password you have chosen is the same as your current
password.
This is not recommended. reenter the enable password.
This first e xample sho ws the password bei ng set in global con fi guration mode and
then asked for when the administrator tries to go from user Exec mode back to
privileged Exec mode. The administrator then changes the enable password and
enters an incorrect one three times.
The last example shows the error message displayed when the administrator tries
to reuse the existing password.
Reference for the Contivity VPN Switch Command Line Interface
60 Chapter 2 CLI Command Summary
exception backup
This command allows the administrator to define backup FTP servers for the
Contivity VPN Switch. A backup FTP server receives a copy of the LDAP
database, conf igurat ion f ile, and ot her syst em fi les that ha ve changed si nce the l ast
backup. A switch supports up to three backup FTP servers.
Syntax
exception backup {
] username user_name password userpassword
hours
no exception backup {
default exception backup
Parameters
1|2|3The number of backup FTP servers being modified
backup_ip_addThe IP address for backup server
backup_file_pathIf present, specifies the file path on the backup server
hoursThe time interval in hours between backups; range is 1 to
user_nameThe user name that the switch uses to establish the FTP
1|2|3
} backup-ip-add [
1|2|3
}
(defined/undefined)
where the files should be written.
8064 hours.
connection to the backup server
backup-filepath
interval
] [
Default
311645-A Rev 00
user_passwordThe user password t hat t he swit ch uses t o est ablis h the FTP
Reference for the Contivity VPN Switch Command Line Interface
62 Chapter 2 CLI Command Summary
exit
This command allo ws t he admin istra tor t o e xit a n y con f igur ation mode o r to cl ose
an active Telnet session if they use the command when in User Exec mode.
Syntax
exit
Parameters
None
Default
None
Command mode
Next command mode
311645-A Rev 00
Available in all command modes
Either the lower level command mode, or none because the Telnet session is
terminated
Related commands
end
Example
CES(config)#exit
CES#exit
CES>
This example shows a user starting in Global configuration mode and using the
exit command twice to end in User Exec mode.
Chapter 2 CLI Command Summary 63
Reference for the Contivity VPN Switch Command Line Interface
64 Chapter 2 CLI Command Summary
help
This command displays a message about how to use the Help system.
Syntax
help
Parameters
None
Command mode
Available in all command modes
Related commands
Example
311645-A Rev 00
None
CES#help
Help may be request ed at an y point i n a command b y ente ring a quest ion mark (? ).
If nothing matches, the Help list is empty and you must back up until entering a
question mark (?) shows the available options.
Two styles of Help are provided:
1
Full Help is available when you are ready to enter a command argument (for
example, show ?) and describes each possible argument.
2
Partial Help is provided when an abbreviated argument is entered and you
want to know what arguments match the input (for example, show arp?).
host address
This command establishes the IP address, port, bind DN, and bind password
settings for the external master and slave LDAP servers. The master server is the
primary server to process queries. If the master server becomes unavailable, the
switch attempts to use the slave LDAP servers. The switch reattempts connection
to the master server every 15 minutes or upon a configuration change. The switch
has read/write access to the master LDAP server. The slave servers are read-only.
addressThe IP a ddress for the LDAP server. Can be a do tted I P addres s
Chapter 2 CLI Command Summary 65
or a host name. The host name does not have to be fully
qualified if it is in the same domain as the switch.
masterThe settings for the master LDAP server
slave1The settings for the slave 1 LDAP server
slave2The settings are for t he slave 2 LDAP server
portThe port number that connects to the LDAP server
ssl-portThe port number to connect to the LDAP server when using
SSL. In addition, the SSL encryption settings must be se.
port_numberThe port number to connect to on the LDAP server
bind-dnIf present, th e disti nguish ed name used to con nec t to the LDAP
server
Reference for the Contivity VPN Switch Command Line Interface
66 Chapter 2 CLI Command Summary
bind_dn_valueThe bind distinguished name (DN) used to connect to the
LDAP server. This is the equivalent of a user ID for an LDAP
server. It can be omitted for an LDAP server that allows
anonymous access.
bind-passwordA password must be used during connection to the FTP server.
Default
Defaults to a non-SSL conn ection made t o port 389. If ssl- port is specif ied witho ut
providing a port number value, the SSL connection attempt is made to port 636.
Command mode
Global configuration
Next command mode
Global configuration
Prerequisites
Related commands
Example
311645-A Rev 00
None
ldap-server
show ldap-server
See the example for the ldap -server command.
hostname
Syntax
Chapter 2 CLI Command Summary 67
This command allows the administrator to specify the DNS host name for the
switch. This name should co rrespond to the name in the DNS serv er to identi fy the
management address of the switch that is located on the private network.
hostname
string
Parameters
stringThe DNS name to assig n to the swit ch. This name can have up
to 64 characters.
Default
None
Command mode
Global configuration
Next command mode
Global configuration
Prerequisites
At least one DNS server should be specified.
Warnings
Validate against DNS server?
Reference for the Contivity VPN Switch Command Line Interface
68 Chapter 2 CLI Command Summary
Related commands
no hostname
ip domain-name
ip name-server
interface management
Example
CES(config)#hostname MarketingCES
This example assigns the name MarketingCES to the switch.
311645-A Rev 00
interface management
This command is used to specify the IP address that is used to connect to
systemfor the services such as HTTP, FTP, SNMP, and Telnet. The IP address
cannot be used for any other purpose.
Syntax
interface management
ip address address
exit
Parameters
addressThe I P address that is u sed t o c onnect to system serv ic es on the
switch
Chapter 2 CLI Command Summary 69
Command mode
Global configuration
Next command mode
Interface configuration
Warnings
IP Address is already in use on switch for other purposes.
Reference for the Contivity VPN Switch Command Line Interface
70 Chapter 2 CLI Command Summary
Related commands
ip http server
Example
CES(config)#interface management
Router(config-if)#ip address 10.0.3.33
Router(config-if)#exit
This command assigns the IP address 10.0.3.33 to the switch for HTTP, FTP,
Telnet, and SNMP connections.
311645-A Rev 00
ip http server
This command allows the administrator to enable or disable management of the
switch using a Web browser. If HTTP management is disabled, the switch can still
be managed using the Nortel Networks CLI.
Syntax
ip http server
no ip http server
Parameters
None
Default
This feature is enabled by default on the switch.
Chapter 2 CLI Command Summary 71
Command mode
Global configuration
Next command mode
Global configuration
Reference for the Contivity VPN Switch Command Line Interface
72 Chapter 2 CLI Command Summary
Related commands
interface loopback
Example
CES(config)#no ip http server
This command disables management of the switch using a Web browser. The
switch can still be configured using the CLI.
311645-A Rev 00
kill
Chapter 2 CLI Command Summary 73
This comma nd terminates an identified Telnet sess ion. The Telnet session I D can
be obtained using the who command.
Any in-progress session commands are completed and the session is then
terminated without any warning or message to the Telnet user.
If the sessio n ID given by the admini strator is not valid, or is not for a Telnet
session, the command displays an error message and does nothing.
Syntax
kill telnet_id
Parameters
telnet_idSession ID of Telnet session to be terminated
Command mode
Privileged Exec
Next command mode
Privileged Exec
Warnings
Invalid session ID.
Session is not a Telnet session.
Reference for the Contivity VPN Switch Command Line Interface
74 Chapter 2 CLI Command Summary
Related commands
who
show sessions
Example
CES# who
121: From 116.102.4.45
213: From 116.102.12.23
217: From 116.102.12.23
CES# kill 213
CES# who
121: From 116.102.4.45
217: From 116.102.12.23
This example shows a series of Telnet sessions active on the switch. One is
terminated using kill and the results are shown in the subsequent who command.
311645-A Rev 00
ldap
Chapter 2 CLI Command Summary 75
This is a mini-CLI command to allow emulation of CL I commands available in
versions of the switch software earlier than Release 3.0.
This command allows the administrator to:
•Start or stop the switch internal LDAP server
•Export the LDAP database to an LDIF file on the switch
•Import the LDAP database from an LDIF file on the switch
•Show the current LDAP server status
Syntax
help
ldap [
Parameters
helpIf present, the ldap command is not Executed, but some Help
exportExport the contents of the LDAP database to the named LDIF
importImport the contents of the LDAP database from the named
showDisplay the status of the LDAP server.
startStart the LDAP server running. This command cannot be
export|import|show|start|stop
] {
about the command is displayed on the terminal.
file. The LDAP server must be stopped before an ldap export
can be performed.
LDIF file. The current LDAP database contents are replaced.
The LDAP ser ver must be stopp ed before a n ldap i mport can be
performed.
performed while the LDAP server is performing an export or
import command. This command cannot be Executed unless
the LDAP server is actually stopped.
}
Reference for the Contivity VPN Switch Command Line Interface
76 Chapter 2 CLI Command Summary
stopStop the LDAP server running. This command cannot be
Executed unless the LDAP server is actually running.
Default
None
Command mode
Global configuration
Next command mode
Global configuration
Warnings
LDAP server is currently running.
Example
311645-A Rev 00
LDAP server is already running.
LDAP server is already stopped.
Invalid LDIF file name.
LDIF file does not exist.
CES(config)#ldap show
CES(config)#ldap stop
CES(config)#ldap export
CES(config)#ldap start
ldap-server
This command is used to configure the settings for the LDAP server used by the
switch to store the configuration settings that are not specific to an individual
switch. The LDAP server can be internal to the switch being administered, or can
be an external server that is shared by one or more Contivities.
Syntax
Chapter 2 CLI Command Summary 77
ldap-server {
internal|externa
Parameters
internalEnter LDAP server configuration m ode for the in ternal LDAP
server.
externalEnter LDAP server configuration mode for an external LDAP
server.
Default
When initially configured, the switch has an internal LDAP server.
Command mode
Global configuration
Next command mode
l}
LDAP server configuration
Reference for the Contivity VPN Switch Command Line Interface
78 Chapter 2 CLI Command Summary
Related commands
ldap-server source
show ldap-server
Example
CES(config)#ldap-server source internal
CES(config)#ldap-server internal
Router(config-ldap)#server stop
Router(config-ldap)#server backup bk0901
Router(config-ldap)#server start
Router(config-ldap)#exit
311645-A Rev 00
This example sets the swi tch to use the in ternal LDAP server, stops the se rver, and
backs up th e current se rver database to an LDIF file named /ide0/system/slapd/
ldif/bk0901. The prompt returns after the backup is completed, then the
administrator restarts the LDAP server.
This example specifies the settings for a master LDAP server at IP address
122.33.102.44 port number nnn, with a bind DN and base DN. The domain
delimiter is the c haract er @ an d the d omain suffix is removed. The s witch i s set to
use the external LDAP server.
ldap-server source
This command set s th e source of the LDAP server used b y the switch to eit her the
internal LDAP server on the switch itself, or an external LDAP server that can be
shared by one or more Contivities.
Syntax
ldap-server source {internal|external}
Parameters
internalUse the internal LDAP server for switch configuration data.
externalUse the external LDAP server for switch configuration data.
Default
Chapter 2 CLI Command Summary 79
When initially configured, the switch has an internal LDAP server.
Command mode
Global configuration
Next command mode
Global configuration
Prerequisites
If setting to an external LDAP server, the settings must already have been
configured fo r the LDAP server.
Reference for the Contivity VPN Switch Command Line Interface
80 Chapter 2 CLI Command Summary
Warnings
External LDAP server not configured.
Cannot reach external LDAP server.
Related commands
ldap-server
show ldap-server
Example
See the example for the ldap -server command.
311645-A Rev 00
load
Chapter 2 CLI Command Summary 81
This is a mini-CLI command to allow emulation of CL I commands available in
earlier versions of the switch software.
This command allows the administrator to use the Bulk Load facility to Execute a
command file that has been previously copied to the switch using FTP. The
commands in the file can configure various settings on the switch. This facility is
used to bulk configure the switch.
Syntax
load filename
Parameters
filenameThe name of the file on the switch that contains the bulk load
commands.
Default
None
Command mode
Global configuration
Next command mode
Global configuration
Reference for the Contivity VPN Switch Command Line Interface
82 Chapter 2 CLI Command Summary
Prerequisites
The LDAP server must be running.
Related commands
ldap
Example
CES(config)#load /ide0/s ystem/test. cmd
311645-A Rev 00
logging history
This command determines what types of messages are stored in the system logs.
Once the message type level has been established, future messages stored in the
system logs must be at or above this level for them to be saved.
This is different from the IOS implementation, where this command only affects
syslog messages.
On the switch a warning is displayed if the level set with t his command does not
agree with the level required for syslog message forwarding (as set in the logging
facility syslog command).
Syntax
Chapter 2 CLI Command Summary 83
logging history {
default logging history
Parameters
alertsLog all emergency and alert messages.
errorsPreviou s level plus critical and error conditions.
notificationsPrevious level and warnings and notifications.
debuggingAll message levels.
defaultSets logging level back to alerts for future mes sages.
Default
Defaults to a logging level of alerts.
The default logging history command sets the level to errors for future messages.
alerts|errors|notifications|debugging
}
Reference for the Contivity VPN Switch Command Line Interface
84 Chapter 2 CLI Command Summary
Command mode
Global configuration
Next command mode
Global configuration
Warnings
Does not agree with syslog forwarding settings.
Related commands
show logging history
logging facility syslog
show logging syslog
Example
311645-A Rev 00
CES(config)#logging history errors
This command sets the system logging on the switch to store emergency, alert,
critical, and error condition messages in the system log.
logout
Syntax
Parameters
Command mode
Chapter 2 CLI Command Summary 85
This is a mini-CLI command to allow emulation of CL I commands available in
earlier versions of the switch software.
This command logs the administrator off the switch and terminat es the Telnet
session. It is equivalent to using the exit command in User Exec mode.
logout
None
Global configuration
Next command mode
Global configuration
Related commands
exit
Example
CES(config)#logout
This example disconnects the session.
Reference for the Contivity VPN Switch Command Line Interface
86 Chapter 2 CLI Command Summary
more
This command displays a readable file on the switch. The file is displayed on
T eln et scree n at a time. The user can use the paginati on ke ys to see the next screen
or line in the file, or to quit from the display.
It differs from the de facto standard in that it cannot be used to display a file on a
remote file system. It also does not support the /ebcdic output switch that causes
the file to be printed in EBCDIC mode.
On the switch, this command is limited to files that are 10KB or sm aller. If the
user tries to use more on a file that is larger than 10KB, an error message is
displayed.
Syntax
more [/
Parameters
/asciiDisplay file in ASCII.
/binaryDisplay file in binary.
fileFully qualif ied na me of the switch f ile to di sp lay. The name has
Default
The default depends on the type of file. If the file contains non-printable
characters, it defaults to binary output, otherwise it defaults to ASCII output. You
cannot print a binary file in ASCII format output. If yo u attempt to print a binary
file in ASCII out put format, the switch is ignored.
ascii|/binary
the format:
diskn:[directory/]file.ext
where: diskn is either disk0 or disk1, there are zero or more
directory names and there is a file name.
] file
311645-A Rev 00
Printable chara cters are c haract ers wh ose chara cter c odes a re in the ra nge decimal
32 (space) to decimal 126 (~) inclusive, plus the characters \t (decimal 9),
\n (decimal 10), and \ r (decimal 13). Non-prin table ch aracters ar e represe nted b y a
period (.) in the ASCII part if the binary output format.
Command mode
Privileged Exec
Next command mode
Privileged Exec
Warnings
File not found.
Cannot display a file that is larger that 10KB.
Chapter 2 CLI Command Summary 87
Reference for the Contivity VPN Switch Command Line Interface
00000000: 0A210A21 204C6173 7420636F 6E666967 .!.! Las t co nfig
00000010: 75726174 696F6E20 6368616E 67652061 urat ion chan ge a
00000020: 74203134 3A30333A 32322070 73742046 t 14 :03: 22 p st F
00000030: 72692041 75672032 37203139 39390A21 ri A ug 2 7 19 99.!
00000040: 204E5652 414D2063 6F6E6669 67206C61 NVR AM c onfi g la
00000050: 73742075 70646174 65642061 74203134 st u pdat ed a t 14
00000060: 3A30393A 30392070 73742046 72692041 :09: 09 p st F ri A
00000070: 75672032 37203139 39390A21 0A766572 ug 2 7 19 99.! .ver
00000080: 73696F6E 2031322E 300A7365 72766963 sion 12. 0.se rvic
311645-A Rev 00
This first exampl e of using mo re to display the contents of a config file in ASCII
mode. The second example (with bogus file contents) of the binary output format.
ping
Chapter 2 CLI Command Summary 89
The ping (packet in ternet groper function) command provides a basic ping fa cility.
It sends three 100-byte ping packets.
The ping command does not recognize DNS names with hyphens.
Syntax
host | address
ping {
Parameters
addressThe IP address of system to ping
hostThe host name of system to ping
scr_hostThe source host name
scr_addressThe source IP address
Default
None
Command mode
User Exec
scr_host | scr_address
} [
]
Next command mode
User Exec
Reference for the Contivity VPN Switch Command Line Interface
90 Chapter 2 CLI Command Summary
Warnings
If the system cannot ma p an address for a host nam e, it returns a "%Unknown
Host" error message.
Related commands
trace ip {
Examples
CES>ping 122.104.11.112
PING 122.104.11.112: 56 data bytes
64 bytes from 122.104.11.112: icmp_seq=0. time= 16 ms
64 bytes from 122.104.11.112: icmp_seq=1. time=<16 ms
64 bytes from 122.104.11.112: icmp_seq=2. time=<16 ms
----122.104.11.112 PING Statistics----
3 packets transmitted, 3 packets received, 0% packet loss
round-trip (ms) min/avg/max = <16/<16/16
CES>ping badaddress.com
ping: unknown host baddaddress.com
CES>ping 10.0.4.44
host | address
}
311645-A Rev 00
PING 10.0.4.44: 56 data bytes
ping: timeout
no answer from 10.0.4.44
The examples show a successful ping command, an attempt to ping an unknown
host address, and an attempt to ping an unreachable IP address.
reload
Syntax
Chapter 2 CLI Command Summary 91
This command forces the switch to reboot immediately. Options can be specified
to determine whether the switch turns off or reboots, which configuration to use
after a reboot, and other settings.
The user is prompted to confirm that they want to continue with the reload. If they
say yes and if the reload command is valid, the system reload commences in
approximately 10 seconds.
The Safe and Normal boot modes are used for secure management of the switch.
In Normal mode, the switch operates normally. In Safe mode, the HTTP, or FTP
traffic is allowed. No other VPN traffic is allowed through the secure management
tunnel or the switch.
This reboots the switch from ide0, using the factory installed defaults and
disabling logins after the reboot to allow for system maintenance. Reason is to
"Upgrade software." The user must press [CR], or any subset of the string “yes”,
to confirm that they want the reload to proce ed.
Comments
311645-A Rev 00
After a successful reload command, the switch will reboot in approximately 10
seconds. For most Telnet client softw ar e, the reboot will cause the Telnet client to
close the connection to the switch.
If there are any outstanding reboot commands, they will be canceled. There can
only be one reboot scheduled at any time.
reload at
Syntax
Parameters
Chapter 2 CLI Command Summary 95
This command sets a time in the future at which the switch will reboot. Options
can be specified to determine whether the switch turns off or reboots, which
configuration to use after a reboot, and other settings.
The user is prompted to confirm that they want to continue with the reload. If they
say yes and if the reload command is valid, the system reload will start at the
specified time.
reload at hh:mm [power-off|restart] [boot-safe|boot-normal]
[boot-drive {ide0|ide1}]
hh:mmThe time at which the shutdown will commence. Values are
based on a 24 hour clock. If this time has already passed today,
then the reload will occur at this time tomorrow.
power-off If prese nt, the switc h will power down after i t has comple ted
shutdown.
restart If present, the switch restarts after it has completed shutdown.
boot-safeIf present, switch restarts in safe boot mode.
boot-normalIf present, switch restarts in normal boot mode.
boot-driveSpecify the drive from which the switch will reboot.
ide0|ide1Disk drive from which bootable image will be loaded.
config-fileSpecify which configuration should be used after a reboot.
latestThe switch should be reb ooted wit h th e late st configuration file.
Reference for the Contivity VPN Switch Command Line Interface
96 Chapter 2 CLI Command Summary
factoryThe switch shou ld be re booted wi th the reset conf ig urati on f il e.
This file sets the switch to basic defaults, the contents of the
LDAP database and other settings are still maintained.
config-nameName of previously saved configuration to use on reboot.
disable-loginsNo more logins should be permitted before the reboot occurs.
disable-after-restart Logins should not be permitted after the reboot. This is
intended to support sys tem maintenance tasks after a reboot .
textIf present, this gives the reason for a reloa d command. This
reason will be displayed on the Admin->Shutdown and
Status->System Web management pages.
If the value for the text paramete r contains spaces, it may be
enclosed in double quotes so that it has a single parameter
value.
Default
Command mode
Next command mode
311645-A Rev 00
The default settings for this command are determined by any previous reload
command. For the first reload c ommand, the following defaults apply:
restart
boot-drive ide0
config-file latest
Privileged Exec
Privileged Exec
Prerequisites
A named configuration file can only be used after it has been created.
Warnings
Any warnings cause the command to fail. The user must reenter the command
after correc ting the parameters in error.
Configuration file does not exist.
Related commands
reload
reload cancel
reload in
reload no-sessions
Chapter 2 CLI Command Summary 97
show reload
Reference for the Contivity VPN Switch Command Line Interface
98 Chapter 2 CLI Command Summary
Example
CES#reload at 22:00 restart boot-drive ide0
disable-after-restart Backup LDAP database
Reload Scheduled Shutdown at 22:00:00
Reload Explanation: Backup LDAP database
After Shutdown: Restart
Disable New Logins: No
Disable Logins after Restart: Yes
Boot Mode: Normal
Config File: latest
Boot Drive: /ide0/
Proceed with reload? [confirm]y
Comments
311645-A Rev 00
This reboots the switch from ide0, using the latest configuration and disabling
logins after the reboot to allow for system maintenance. Reason is to "Backup
LDAP database."
After a successful reload at command, the switch will reboot at the time specified
based on internal clock settings. For most Telnet client software, the reboot will
cause the Telnet client to close the connection to the switch.
If there are an y outsta nding rebo ot commands, t hey wi ll be can celed. Ther e can be
only be one reboot scheduled at any time.
reload cancel
This command cancels any pending reload command. There can only be one
pending reload at any given time.
When a reload has been canceled the details for the pending reload are displayed.
Syntax
reload cancel
Parameters
None
Default
None
Chapter 2 CLI Command Summary 99
Command mode
Privileged Exec
Response
The command will output a message giving details about the type of reload
command that was canceled.
Reference for the Contivity VPN Switch Command Line Interface
100 Chapter 2 CLI Command Summary
Next command mode
Privileged ExecPrerequisites
A reload must already have been scheduled.
Warnings
No currently scheduled reload operation.
Related commands
reload
reload at
reload in
reload no-sessions
311645-A Rev 00
show reload
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.