All rights reserved. December 2000.
The information in this document is subject to change without notice. The statements, configurations, tech nical 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 trademark s 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 disclosu re by the United States Government i s subject to restrictions as set forth in sub paragraph
(c)(1)(ii) of th e Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.
Notwithstanding any other license agreement that may pert ain to, or accompany the deliv ery 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-Restr icted Rights clause at FAR 52.227-19.
Statement of Conditions
In the interest of imp rov in g inte rn al d esi gn , ope ratio na l fun c tio n, and /or re lia bi lity, Nortel Networks NA Inc. re serves
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) describe d herein.
SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A P ARTICULAR PURPOSE.
In addition, the progra m and information contained herein are licensed onl y pursuant to a license agreem ent that
contains restrict ions on use and disclo sure (that may incor porate by reference certain limita tions and notices imposed
by third parties).
USA Requirements Only
311645-A Rev 00
Page 3
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 operated in a commercial environment. This equipment gen erates, uses, and can radiate radio
frequency energy. If it is not installed and used in accordance with the instruct i on 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 b e required to take whatever measures ma y 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 (CI SPR 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 pro duit de Classe A. Dans un environnement domestique, ce pr oduit risque de créer des
interférences radioélectriques, il appartiendra alors à l’utilisateur de prendre les mesures spécifi ques appropriées.
3
EC Declaration of Conformity
This product co nforms (or these products conform) to the provision s 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 radio-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
Page 4
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 pr escrites dans le R èglement sur le brouillage radioél ectrique du ministère des
Communications du Canada.
Nortel Networks NA Inc. Software License Agreement
NOTICE: Please carefully read this license agreement before copy in g or using the accompanyin g soft ware or
installing the hardware unit with pre-enabled software (each of which is referred to a s “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
UNDER WHICH NORTEL NETWORKS WILL PERMIT YOU TO USE THE SOFTWARE. If you do not accept
these terms and con ditions, 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 Netwo r ks NA Inc. (“Nortel Networks”) grants the end user of the Software (“Licensee”) a
personal, nonexclusive , nontran sferable license: a) to use the So ftware e ither on a singl e compu ter or, if applicable, on
a single authorized device identified by ho st ID, for which it was originally acquired; b) to copy the Software solely
for backup purposes in suppor t of authorized use of the Software; and c) t o use and copy the associated user ma nual
solely in support of authori zed use o f the Software by Licensee . This license a pplies to the So ftware on ly and does not
extend to Nortel Networks Agent software or other Nortel Networks software products. Nor tel 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 S oft ware 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 co pyright 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 co mpetitive analysis , r ev erse engineer , di s t ri b u te, or create derivativ e works from the Software or us e r
manuals or any copy, in whole or in part. Except as express ly provided in this Agreement, Licensee may not copy or
transfer the Software or user manuals, in whol e or in part. The Software and user manuals embo dy Nortel Networks ’
and its licens ors’ con fide n tia l an d pro pr iet ary intellectual property . Li cen see sh a ll n o t su bli cen se, a ssign , or oth e rwise
disclose to any thi rd party the Sof tware, or any infor mation about t he 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 facilit y,
provided they have agreed to use the Soft ware only in accordance with the terms of this lic ense.
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 describ ed in its accompanying user manual during its warranty period, which b egins on the date
Software is first shipped to Licensee. If any item of Software fails to so function during its warranty period, as the so le
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 Networks during the warranty period al ong with proof of t he date of shipment. This warranty does
not apply if the media ha s been damaged as a result of accident, misuse, or abuse. The Licensee assumes all
responsibility for selection of the Software to achieve License e’s intende d 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 ope rate in the ha rdware or softwar e combination s that
the Licensee may select, c) that the operation of the Software will be uninterrupted or error free, or d) th at al l d efect s
in the operation of the Software will be corrected. Nortel Networks is not obligated to remedy any Software defect
311645-A Rev 00
Page 5
that cannot be reproduced with the late st Software r elease. Th ese warrantie s do no t apply to the S oftware if it ha s been
(i) altered, except by Nortel Networks or in accordance with its instructions; (ii) used in conjunction with another
vendor’s product, resulting in the defect; or (iii) damaged by improp er environ m ent, abuse , mi suse, acci dent , or
negligence. THE FOREGOING WARRANTIES AND LIMITATIONS ARE EXCLUSIVE REMEDIES AND ARE
IN LIEU OF ALL OTHER WARRANTIES EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMIT ATION
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 NORTE L 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 T HIS AGREEM ENT
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 enti r ely at private expense and w ithout the use of any U.S.
Government funds. The license to the U.S. Gov ernm e nt is gran ted 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 c lause o f FAR 52.227-19 and th e limitations set out in this license for civilian
agencies, and subparagraph (c)(1)(ii) of the Rights in Technical Data and Co mputer Software clause of DFARS
252.227-7013, for agencies of the Department of Defense or their successors, whichever is applicab le.
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 and 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 e ffective at th e date of expiration of the
Nortel Networks copyright; those restric tions relatin g to use and disclosu re of Nortel Netwo rks’ co n fiden tia l
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 liabl e to Licensee for damages in any form solely by reason of the termination of this license.
8. Export and r e-e xport. Li censee 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 beh alf of itself and its subsidiaries and a ffi liates, agre es that it will no t, without first obt aining
all export licenses a nd approvals required by the U.S. Government: (i) export, re-export, transfer, or divert any such
Software or technical data, or any direct product t hereof, to any country to which such exports or re-exports are
restricted or embargoed under United States expor t cont rol law s an d regu latio ns, or to any nationa l or re side nt of s uch
restricted or embargo ed coun trie s; or (ii) pro v ide the So ftwa re or related te c hnic al dat a or inform a tion to an y milita ry
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 qu estions concerning this Agreement, contact Nortel Networks, 4401 Great America Parkway,
P.O. Box 58185, Santa Clara, California 95054-8185.
5
Reference for the Contivity VPN Switch Command Line Interface
Page 6
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 TH IS
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 NetworksTM 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 guide assumes
that you are fa miliar with Web browsers and their general operation.
Documentation
27
This document uses the following conventions to distinguish among notes of
varying importance.
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 haza rds involved with
electrical cir cuitry and standard practices for preventing accidents, such
as disconnecting equipment from its power source.
Take notice. Notes contain helpful suggestions or references to
Be careful. In this situat ion, you might do something that
Danger. You are in a situat ion t hat co uld cause bodil y inj ury.
Reference for the Contivity VPN Switch Command Line Interface
Page 28
28 Preface
Related publications
The follow ing 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 latest inf orma ti on, i ncl uding
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
bold Courier text
ping <ip_address>
ping 192.32.10.12
Indicates command names, options, and text that you
, you enter
need to enter.
Example: Use the
Example: Enter
show ip
dinfo
command.
{alerts|routes}
.
braces ({})Indicate require d elements in sy ntax descripti ons 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.
311645-A Rev 00
Page 29
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]
either
show ip interface -alerts
show ip interface
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 textIndicat es 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 yo u 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 t he IP 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 entering the command.
Example: If the command syntax is
show ip {alerts|routes}
show ip alerts or show ip routes
both.
, you enter either
, but not
Reference for the Contivity VPN Switch Command Line Interface
Page 30
30 Preface
Acronyms
This guide uses the following acronyms:
AUIattachment unit interface
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 Digital Network
ISOInternational Organization for St andardizat ion
ITU-TInternational Telecommunication
Union-Telecommunication Standardization Sector
(formerly CCITT)
MACmedia accountants control
MAUmedia access unit
MDI-Xmedium dependent interface crossover
NBMAnonbroadcast multi-access
OSPFOpen Shortest Path First
PPPPoint-to-Point Protocol
SMDSSwitched Multimegabi t Data Service
SNMPSimple Network Management Protocol
STPshielded twisted pair
TPEtwisted pair Ethernet
311645-A Rev 00
Page 31
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 documentation. Then locate the specific 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.
Preface 31
•The “Guides/Books” section lists books on technical topics.
•
The “Technical Manuals” section lists available printed documentation sets.
Make a note of the part numbers and prices of the items that you want to order.
Use the “Marketing Collateral Catalog description” link to place an order and to
print the order form.
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
Page 32
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 Nortel Netw orks s ervic e progr am, c ontact on e of the f ollowing
Nortel Networks Technical Solutions Centers:
Technical Solutions CenterTelephone
EMEA(33) (4) 92-966-968
North America(800) 2LANWAN or (800) 252-6926
Asia Pac i fic(61) (2) 9927-8800
China(800) 810-5000
An Express Routing Code (ERC) is available for many Nortel Networks produc ts
and services. When you use an ERC, your call is routed to a technical support
person who specia lizes in supporti ng that pro duct or ser vice. 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
Page 33
Chapter 1
Introduction
This chapter provid es an int rodu ct ion to the Contivity VPN Switch Command
Line Interfac e (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
33
You then log into the switch using an account with administrator privileges, for
example:
Login: admin
Password: *******
%%
Upon login, the CLI prompt appears (%%), indicating t hat 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 enabled on the switch in or der t o us e
Reference for the Contivity VPN Switch Command Line Interface
Page 34
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 three comma nd modes.
•User Exec Mode
•Privileged Exec Mode
•Global Configuration Mode
311645-A Rev 00
Page 35
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 command s
CES(config)#
with
Telnet
and
password
Mode prompt.
Enter the command
the Privileged Exec Mode prompt.
.
administrator name
enable
configure terminal
at the User Exec
at
The follow ing table summarizes the User Exec Mode commands.
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 systems
show flash: contentsDisplay flash settings
Reference for the Contivity VPN Switch Command Line Interface
Page 36
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/
imported by RIP
configured f o r RIP
from switch
show ip vrrpDisplay IP VRRP settings
show reloadShow details of pending switch
reboot
show sessionsShow current switch sessions
show versionShow switch configuration and
hardware
traceTrace the route to a destination
whoDisplay active Te lnet sessions on
switch
311645-A Rev 00
Page 37
Privileged Exec Mode
This command mode is entered from User Exec mode with the enable command.
The administrator can e xi t fr om thi s mode wit h the disab le command, t he y will 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 follow ing table summarizes the Privileged Exec Mode commands
Chapter 1 Introduction 37
Table 3 Privileged Exec Mode commands
CommandDescription
clear arp-cacheClear ARP cache
clear logging eventsClear event log
configureEnter configuration mode
disableTurn off privileged commands
helpDisplay message about using help
killTerminate a Telnet session
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
more sessions
show arpShow ARP cache contents
show healthShow overall system health
show logging configShow configuration log contents
Reference for the Contivity VPN Switch Command Line Interface
Page 38
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 co ntents
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
CES(config)#
Global Configuration Mode commands
The follow ing table summarizes the Global Configuration Mode commands.
(Mini-CLI)
controlMaintain control tunnel connections
(Mini-CLI)
default logging historySet logging history level to default
value
enable passwordAssign privileged level password
endExit from configure mode
311645-A Rev 00
Page 39
Chapter 1 Introduction 39
Table 4 Global Configuration Mode commands
CommandDescription
exitExit from configure mode
helpDisplay message about using help
ip http serverEnable/dis able HTTP management
ldapControl LDAP server (Mini-CLI)
loadBulk load configur ati on com m and s
(Mini-CLI)
logging historyControl system logging level
logoutExit the Telnet session (Mini-CLI)
resetSet switch system boot mode
configuration
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 locati onSet the locations details for the switch
snmp-server nameSet the administrative name for the
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
(Mini-CLI)
switch
control-B back 1 character
control-C abort command
Reference for the Contivity VPN Switch Command Line Interface
Page 40
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 & command/pa rameter com pletion
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
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
311645-A Rev 00
Page 41
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 Resoluti on Protocol (ARP)
cache. On the Conti vit y VPN Switch, onl y the no f orm of the de f acto co mmand is
supported. There is no command to add a permanent entry to the ARP cache.
Syntax
41
no arp ip-address
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
Page 42
42 Chapter 2 CLI Command Summary
Next command mode
Global Configuration
Related commands
show arp
clear arp-cache
311645-A Rev 00
Page 43
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
Chapter 2 CLI Command Summary 43
Audible alarm is enabled.
Command mode
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
Page 44
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 keywords.
clear arp-cache
Parameters
None
Default
None
Command mode
Privileged Exec
Next command mode
Privileged Exec
Related commands
arp
show arp
311645-A Rev 00
Page 45
clear ip route
This command removes a route from the route table. Note that Static Routes are
not removed fro m 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
Page 46
46 Chapter 2 CLI Command Summary
Related commands
show ip route
Example
CES>clear ip route 10.11.0.12
311645-A Rev 00
Page 47
clear logging events
This command is used to clear the contents of the system events log.
Syntax
clear logging events
Parameters
None
Default
None
Chapter 2 CLI Command Summary 47
Command mode
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
Page 48
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
Privileged Exec
Next command mode
Global configuration
Related commands
disable
enable
end
Examples
CES#configure
CES(config)#end
311645-A Rev 00
Page 49
console mode
Chapter 2 CLI Command Summary 49
Note:
You must have a control tunnel es tablishe d before you can set this
command.
This is a mini-CLI c ommand tha t all o ws emul atio n of CLI c ommands available in
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 mo de causes the CLI to return to Pri vile ged Ex ec mode
on the Telnet session wh ere t he command is issued. Other Telnet sessions wil l not
be forced back to Privileged Exec mode, but they will only supp ort the above CLI
command set.
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
}
Page 50
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 ar e enabled.
Command mode
Global configuration
Next command mode
Global configuration (console mode show) or Privileged Exec
Related commands
reload
reload at
reload in
reload no-sessions
Examples
CES(config)#console mode show
CONSOLE MODE is set to UNRESTRICTED
311645-A Rev 00
Page 51
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 Te lnet session.
reloadStop and perform a cold restart.
These examples show the default console mode setting, and how setting the
console mode to re strict ed force s the use r back t o Pri vile ged Ex ec mode and limi ts
the available CLI commands.
Reference for the Contivity VPN Switch Command Line Interface
Page 52
52 Chapter 2 CLI Command Summary
control
This command allo ws emula tion of CLI commands a v aila ble in ear lier v ersions 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
None
311645-A Rev 00
Page 53
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
Page 54
54 Chapter 2 CLI Command Summary
disable
This command makes t he CLI pars er exit from Privileged Exec mode a nd return
to user Exec mode .
Syntax
disable
Parameters
None
Default
None
Command mode
Privileged Exec
Next command mode
User Exec
311645-A Rev 00
Page 55
Related commands
configure
enable
end
Example
CES#disable
CES>
Chapter 2 CLI Command Summary 55
Reference for the Contivity VPN Switch Command Line Interface
Page 56
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 administra tor i s p rompt ed for a case-sensitive password before the y 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 at tempts to enter the password. After the third incorrect
attempt an error message is displayed (Bad secrets) and the User Exec prompt is
redisplayed.
Syntax
enable
Parameters
None
Default
None
Command mode
User Exec
Next command mode
Privileged Exec
Warnings
%Bad secrets
311645-A Rev 00
Page 57
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
Page 58
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 differ ent from the existing password, a warni ng
message is generated.
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
New password is same as current one.
311645-A Rev 00
Page 59
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
Chapter 2 CLI Command Summary 59
CES>enable
Password: fred
Password: joan
Password: charles
% Bad secrets
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 w s the passwor d being set in glob al conf igurat ion 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
Page 60
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, a nd other sy stem f iles t hat ha ve changed si nce th e last
backup. A switch supports up to three backup FTP servers.
Syntax
exception backup {
hours
no exception backup {
default exception backup
] username user_name password userpassword
Parameters
1|2|3The number of backup FTP se rvers 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
1|2|3
} backup-ip-add [
1|2|3
(defined/undefined)
where the files should be written.
8064 hours.
}
backup-filepath
interval
] [
user_nameThe user name that the switch uses to establish the FTP
user_passwordThe user password that the switch use s to e stablis h th e FTP
Reference for the Contivity VPN Switch Command Line Interface
Page 62
62 Chapter 2 CLI Command Summary
exit
This command allows the administrator to e xit a n y conf i gurat ion mo de or t o clos e
an active Telnet session if they use the command when in User Exec mode.
Syntax
exit
Parameters
None
Default
None
Command mode
Available in all command modes
Next command mode
Either the lower level command mode, or none because the Telnet session is
terminated
311645-A Rev 00
Page 63
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
Page 64
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
None
Example
CES#help
Help may be req uested at an y point in a command by 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?).
311645-A Rev 00
Page 65
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 address for the LDAP server. Can be a dotted IP address
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 fo r the 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 pre sent, th e disti nguish ed name used to con nect to th e LDAP
server
Reference for the Contivity VPN Switch Command Line Interface
Page 66
66 Chapter 2 CLI Command Summary
bind_dn_valueThe bind distinguished name (DN) used to connect to the
LDAP server. This is th e 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 connection ma de to port 389. If ss l-port is speci fied wi thout
providing a port number value, the SSL connection attempt is made to port 636.
Command mode
Global configuration
Next command mode
Global configuration
Prerequisites
None
Related commands
ldap-server
show ldap-server
Example
See the example for the ldap-server command.
311645-A Rev 00
Page 67
hostname
Syntax
Chapter 2 CLI Command Summary 67
This command allows the administrator to specify the DNS host name for the
switch. This name shou ld correspond t o the name in the DNS serv er to iden tify the
management address of the switch that is located on the private network.
hostname
string
Parameters
stringThe DNS name to assign to the s witch. 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
Page 68
68 Chapter 2 CLI Command Summary
Related commands
no hostname
ip domain-name
ip name-server
interface management
Example
CES(config)#hostnam e MarketingCES
This example assigns the name MarketingCES to the switch.
311645-A Rev 00
Page 69
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 IP address t hat i s used to connect 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
Page 70
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 th e IP address 10.0.3.33 to the switch for HTTP, FTP,
Telnet, and SNMP connections.
311645-A Rev 00
Page 71
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, t he switch can stil l
be managed using the Nortel Networks CLI.
Syntax
ip http server
no ip http server
Parameters
None
Default
Chapter 2 CLI Command Summary 71
This feat ure is enabled by default o n the switch.
Command mode
Global configuration
Next command mode
Global configuration
Reference for the Contivity VPN Switch Command Line Interface
Page 72
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
Page 73
kill
Chapter 2 CLI Command Summary 73
This command termi nates an identified Telnet session. The Telnet session ID 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 session ID given by the administrator 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
Page 74
74 Chapter 2 CLI Command Summary
Related commands
who
show sessi ons
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
Page 75
ldap
Chapter 2 CLI Command Summary 75
This is a mini-CLI command to allow emulation of CLI comm ands 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 fr om an LDIF file on the switch
•Show the curren t LDAP server status
Syntax
help
ldap [
Parameters
helpIf present, the ldap command is not Executed, but some Help
exportExport th e contents of the LDAP database to the na med 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 LD AP serv er must be st opped befor e an 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
Page 76
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.
LDAP server is already running.
LDAP server is already stopped .
Invalid LDIF file name.
LDIF file does n ot exist.
Example
CES(config)#ldap show
CES(config)#ldap stop
CES(config)#ldap export
CES(config)#ldap start
311645-A Rev 00
Page 77
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 on e or more Contivities.
Syntax
Chapter 2 CLI Command Summary 77
ldap-server {
Parameters
internalEnter LDAP server co nfiguration mo de for the internal LDAP
externalEnter LDAP server configuration mode for an external LDAP
Default
When initially configured, the switch has an internal LDAP server.
Command mode
Global configuration
internal|externa
server.
server.
l}
Next command mode
LDAP server configuration
Reference for the Contivity VPN Switch Command Line Interface
Page 78
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
This example sets the switch to use the interna l LD AP serv er , st ops the serv er, and
backs up the current server datab ase to an LD IF 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 t he char acter @ and t he domain su f f i x is r emo ve d. Th e swit ch is set t o
use the exter nal LDAP server.
311645-A Rev 00
Page 79
ldap-server source
This command set s the source of the LDAP server used by the switch to either t he
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.
Chapter 2 CLI Command Summary 79
Default
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 for the LDAP server.
Reference for the Contivity VPN Switch Command Line Interface
Page 80
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
Page 81
load
Chapter 2 CLI Command Summary 81
This is a mini-CLI command to allow emulation of CLI comm ands available in
earlier versions of the switch software.
This command allows the administrator to use t he Bulk Load facility to Execut e 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
Page 82
82 Chapter 2 CLI Command Summary
Prerequisites
The LDAP server must be running.
Related commands
ldap
Example
CES(config) #load /ide0 /system/t est.cmd
311645-A Rev 00
Page 83
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 th em to be saved.
This is different from the IOS implementation, where this command only affects
syslog messages.
On the switch a warning is display ed if the level set w ith this com mand 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.
errorsPrevious level plus critical and erro r conditions.
notificationsPrevious level and warnings and notifications.
debuggingAll message levels.
defaultSets logging level back to alerts for future messages.
Default
Defaults to a logging l evel of alerts.
alerts|errors|notifications|debugging
}
The default logging history command sets the level to errors for future messages.
Reference for the Contivity VPN Switch Command Line Interface
Page 84
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
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.
311645-A Rev 00
Page 85
logout
Syntax
Parameters
Chapter 2 CLI Command Summary 85
This is a mini-CLI command to allow emulation of CLI comm ands available in
earlier versions of the switch software.
This command logs the administrator off the swi tch and terminates the Telnet
session. It is equivalent to using the exit command in User Exec mode.
logout
None
Command mode
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
Page 86
86 Chapter 2 CLI Command Summary
more
This command displays a readable file on the switch. The file is displayed on
T e lnet scree n at a time. The user can use the pagina tion ke ys to see the next scr een
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 swi tch, this command is lim ited to files th at are 10KB or smaller. 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 name of th e swit ch f i le t o disp 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 for mat output. If you attempt to print a binary
file in ASCII output 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
Page 87
Printable chara cte rs ar e char acter s whose chara cte r code s are in the range dec imal
32 (space) to decimal 126 (~) inclusive, plus the characters \t (decimal 9),
\n (decimal 10), and \r (decimal 13). Non-pri ntable ch aracter s are repr esented 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.
Chapter 2 CLI Command Summary 87
Cannot display a file that is larger that 10KB.
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
This first example of using more to dis play the co ntents of a config file in ASCII
mode. The second example (with bogus file contents) of the binary output format.
311645-A Rev 00
Page 89
ping
Chapter 2 CLI Command Summary 89
The ping (packe t internet groper function) command provid es a basic ping fa cility.
It sends three 100-byte ping packets.
The ping command does not recognize DNS names with hyphens.
Syntax
ping {
host | address
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
scr_host | scr_address
} [
]
User Exec
Next command mode
User Exec
Reference for the Contivity VPN Switch Command Line Interface
Page 90
90 Chapter 2 CLI Command Summary
Warnings
If the system cannot map an address for a ho st name, 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
host | address
}
CES>ping 10.0.4.44
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.
311645-A Rev 00
Page 91
reload
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 tha t they want the re load to proc eed.
Comments
After a successful reload command, the switch will reboot in approximately 10
seconds. For most Telnet client software, the re boot wil l ca use the Telnet client to
close the connection to the switch.
If there are any outstanding reboot comman ds, they will be canceled. There can
only be one reboot scheduled at any time.
311645-A Rev 00
Page 95
reload at
Syntax
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
power-off If present, the switch will power down after it has completed
restart If present, the switc h 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.
based on a 24 hour clock. If this ti me has al ready passed today,
then the reload will occur at this time tomorrow.
shutdown.
latestThe switch should be reboot ed with t he late st configuration file.
Reference for the Contivity VPN Switch Command Line Interface
Page 96
96 Chapter 2 CLI Command Summary
factoryThe switch should b e reboot ed with the res et configuration file.
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 sy stem maintenance tasks after a reboot.
textIf present, this gives the reason for a reload comm and. This
reason will be displayed on the Admin->Shutdown and
Status->System Web management pages.
If the value for the text parameter contains spaces, it may be
enclosed in double quotes so that it has a single parameter
value.
Default
The default settings fo r this command are determined by any previous reload
command. For the first reload command, the following defaults apply:
restart
boot-drive ide0
config-file latest
Command mode
Privileged Exec
Next command mode
Privileged Exec
311645-A Rev 00
Page 97
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 correcting the p arameters in error.
Configuration file does not exist.
Related commands
reload
reload cancel
Chapter 2 CLI Command Summary 97
reload in
reload no-sessions
show reload
Reference for the Contivity VPN Switch Command Line Interface
Page 98
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
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."
Comments
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 outs tanding r eboot commands , the y will be canceled. There can b e
only be one reboot scheduled at any time.
311645-A Rev 00
Page 99
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
Chapter 2 CLI Command Summary 99
None
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
Page 100
100 Chapter 2 CLI Command Summary
Next command mode
Privileged ExecPrer equisites
A reload must already have been scheduled.
Warnings
No currently scheduled reload operation.
Related commands
reload
reload at
reload in
reload no-sessions
show reload
311645-A Rev 00
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.