nn47263-506 04.01 using command line interface

Upload: rosembergp

Post on 06-Mar-2016

238 views

Category:

Documents


0 download

DESCRIPTION

Using the Command Line InterfaceAvaya Secure Router 2330/4134

TRANSCRIPT

  • Using the Command Line InterfaceAvaya Secure Router 2330/4134

    10.3NN47263-506, 04.01

    October 2010

  • 2010 Avaya Inc.All Rights Reserved.NoticeWhile reasonable efforts have been made to ensure that theinformation in this document is complete and accurate at the time ofprinting, Avaya assumes no liability for any errors. Avaya reserves theright to make changes and corrections to the information in thisdocument without the obligation to notify any person or organization ofsuch changes.Documentation disclaimerAvaya shall not be responsible for any modifications, additions, ordeletions to the original published version of this documentation unlesssuch modifications, additions, or deletions were performed by Avaya.End User agree to indemnify and hold harmless Avaya, Avaya's agents,servants and employees against all claims, lawsuits, demands andjudgments arising out of, or in connection with, subsequentmodifications, additions or deletions to this documentation, to theextent made by End User.Link disclaimerAvaya is not responsible for the contents or reliability of any linked Websites referenced within this site or documentation(s) provided by Avaya.Avaya is not responsible for the accuracy of any information, statementor content provided on these sites and does not necessarily endorsethe products, services, or information described or offered within them.Avaya does not guarantee that these links will work all the time and hasno control over the availability of the linked pages.WarrantyAvaya provides a limited warranty on this product. Refer to your salesagreement to establish the terms of the limited warranty. In addition,Avayas standard warranty language, as well as information regardingsupport for this product, while under warranty, is available to Avayacustomers and other parties through the Avaya Support Web site: http://www.avaya.com/support. Please note that if you acquired theproduct from an authorized Avaya reseller outside of the United Statesand Canada, the warranty is provided to you by said Avaya reseller andnot by Avaya.LicensesTHE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYAWEBSITE, HTTP://SUPPORT.AVAYA.COM/LICENSEINFO/ AREAPPLICABLE TO ANYONE WHO DOWNLOADS, USES AND/ORINSTALLS AVAYA SOFTWARE, PURCHASED FROM AVAYA INC.,ANY AVAYA AFFILIATE, OR AN AUTHORIZED AVAYA RESELLER(AS APPLICABLE) UNDER A COMMERCIAL AGREEMENT WITHAVAYA OR AN AUTHORIZED AVAYA RESELLER. UNLESSOTHERWISE AGREED TO BY AVAYA IN WRITING, AVAYA DOESNOT EXTEND THIS LICENSE IF THE SOFTWARE WAS OBTAINEDFROM ANYONE OTHER THAN AVAYA, AN AVAYA AFFILIATE OR ANAVAYA AUTHORIZED RESELLER, AND AVAYA RESERVES THERIGHT TO TAKE LEGAL ACTION AGAINST YOU AND ANYONEELSE USING OR SELLING THE SOFTWARE WITHOUT A LICENSE.BY INSTALLING, DOWNLOADING OR USING THE SOFTWARE, ORAUTHORIZING OTHERS TO DO SO, YOU, ON BEHALF OFYOURSELF AND THE ENTITY FOR WHOM YOU ARE INSTALLING,DOWNLOADING OR USING THE SOFTWARE (HEREINAFTERREFERRED TO INTERCHANGEABLY AS YOU AND END USER),AGREE TO THESE TERMS AND CONDITIONS AND CREATE ABINDING CONTRACT BETWEEN YOU AND AVAYA INC. OR THEAPPLICABLE AVAYA AFFILIATE (AVAYA).CopyrightExcept where expressly stated otherwise, no use should be made ofmaterials on this site, the Documentation(s) and Product(s) providedby Avaya. All content on this site, the documentation(s) and theproduct(s) provided by Avaya including the selection, arrangement anddesign of the content is owned either by Avaya or its licensors and is

    protected by copyright and other intellectual property laws including thesui generis rights relating to the protection of databases. You may notmodify, copy, reproduce, republish, upload, post, transmit or distributein any way any content, in whole or in part, including any code andsoftware. Unauthorized reproduction, transmission, dissemination,storage, and or use without the express written consent of Avaya canbe a criminal, as well as a civil, offense under the applicable law.Third-party componentsCertain software programs or portions thereof included in the Productmay contain software distributed under third party agreements (ThirdParty Components), which may contain terms that expand or limitrights to use certain portions of the Product (Third Party Terms).Information regarding distributed Linux OS source code (for thoseProducts that have distributed the Linux OS source code), andidentifying the copyright holders of the Third Party Components and theThird Party Terms that apply to them is available on the Avaya SupportWeb site: http://www.avaya.com/support/Copyright/.TrademarksThe trademarks, logos and service marks (Marks) displayed in thissite, the documentation(s) and product(s) provided by Avaya are theregistered or unregistered Marks of Avaya, its affiliates, or other thirdparties. Users are not permitted to use such Marks without prior writtenconsent from Avaya or such third party which may own the Mark.Nothing contained in this site, the documentation(s) and product(s)should be construed as granting, by implication, estoppel, or otherwise,any license or right in and to the Marks without the express writtenpermission of Avaya or the applicable third party.Avaya is a registered trademark of Avaya Inc.All other trademarks are the property of their respective owners.Downloading documentsFor the most current versions of documentation, see the Avaya SupportWeb site: http://www.avaya.com/supportContact Avaya SupportAvaya provides a telephone number for you to use to report problemsor to ask questions about your product. The support telephone numberis 1-800-242-2121 in the United States. For additional supporttelephone numbers, see the Avaya Web site: http://www.avaya.com/support

    2 Using the Command Line Interface October 2010

  • Contents

    Chapter 1: New in this release.................................................................................................5Other changes...................................................................................................................................................5

    Chapter 2: Introduction.............................................................................................................7Navigation.........................................................................................................................................................7

    Chapter 3: CLI fundamentals....................................................................................................9Navigation.........................................................................................................................................................9Top-level commands.........................................................................................................................................9Global commands...........................................................................................................................................10Configuration mode.........................................................................................................................................11Context-sensitive configuration commands.....................................................................................................11CLI user access levels....................................................................................................................................12Multiple concurrent CLI users.........................................................................................................................12Context-sensitive help.....................................................................................................................................13Command-specific help...................................................................................................................................13Command tree................................................................................................................................................14Navigation keys...............................................................................................................................................14Navigation commands.....................................................................................................................................15no command...................................................................................................................................................15Command abbreviations.................................................................................................................................16Command history............................................................................................................................................16Configuration file.............................................................................................................................................16Module slot and port numbering......................................................................................................................16

    Secure Router 4134 Voice Carrier medium module subslots.................................................................18Chapter 4: Boot CLI fundamentals........................................................................................19

    Boot CLI command list....................................................................................................................................19Chapter 5: Basic CLI operations............................................................................................23

    Prerequisites...................................................................................................................................................23Navigation.......................................................................................................................................................23Logging on......................................................................................................................................................24Configuring the router from a terminal............................................................................................................24Configuring users............................................................................................................................................24Modifying the administrator account user name.............................................................................................25Modifying passwords for other users..............................................................................................................26Modifying your own password.........................................................................................................................26Saving the current configuration to file............................................................................................................27Encrypting password display...........................................................................................................................27Adding a header to the configuration file.........................................................................................................28Adding comments at the beginning of a configuration....................................................................................28Adding comments to the end of a configuration..............................................................................................28Configuring the router using configuration files from flash..............................................................................29Configuring the router using configuration files from the network...................................................................29Configuring the timeout for console sessions.................................................................................................30Displaying the console timeout.......................................................................................................................30Displaying configured user accounts..............................................................................................................30Displaying connected users............................................................................................................................30

    Using the Command Line Interface October 2010 3

  • Displaying user account for current session...................................................................................................31Displaying running configuration.....................................................................................................................31Displaying stored configuration.......................................................................................................................31Displaying system configuration......................................................................................................................31

    Chapter 6: File management..................................................................................................33Navigation.......................................................................................................................................................33Copying files to and from compact flash or USB.............................................................................................33Downloading files from the network to compact flash or USB........................................................................34Uploading a file from compact flash or USB to the network............................................................................34Formatting a compact flash or USB device.....................................................................................................35Renaming a file on compact flash or USB......................................................................................................35Removing a file from compact flash or USB...................................................................................................36Uploading the event log to the network...........................................................................................................36Displaying the file list from compact flash or USB...........................................................................................36Displaying image file versions from compact flash or USB.............................................................................36Displaying Boot ROM file information.............................................................................................................37

    4 Using the Command Line Interface October 2010

  • Chapter 1: New in this release

    There is no new content added to Avaya Secure Router 2330/4134 Using the CLI (NN47263-506) forRelease 10.3..

    Other changesThis document is rebranded to Avaya.

    Using the Command Line Interface October 2010 5

  • New in this release

    6 Using the Command Line Interface October 2010

  • Chapter 2: Introduction

    This document describes the basic functionality and navigation of the Command Line Interface (CLI) forthe Avaya Secure Router 2330/4134 (Avaya SR2330/4134).

    Navigation CLI fundamentals on page 9 Boot CLI fundamentals on page 19 Basic CLI operations on page 23 File management on page 33

    Using the Command Line Interface October 2010 7

  • Introduction

    8 Using the Command Line Interface October 2010

  • Chapter 3: CLI fundamentals

    The command line interface (CLI) is the main, text-based interface for configuring, managing, andmonitoring the Avaya Secure Router 2330/4134. You access the CLI through a direct connection to theconsole port, or remotely using Telnet. This section contains information about the basic CLI functionalitywith the Secure Router 2330/4134.

    Navigation Top-level commands on page 9 Global commands on page 10 Configuration mode on page 11 Context-sensitive configuration commands on page 11 CLI user access levels on page 12 Multiple concurrent CLI users on page 12 Context-sensitive help on page 13 Command-specific help on page 13 Command tree on page 14 Navigation keys on page 14 Navigation commands on page 15 no command on page 15 Command abbreviations on page 16 Command history on page 16 Configuration file on page 16 Module slot and port numbering on page 16

    Top-level commandsWhen you log on to the switch, you enter the top level of the CLI hierarchy. From this level,you can access various top-level commands, including debugging, system file configuration,

    Using the Command Line Interface October 2010 9

  • password configuration, testing, and rebooting. The configure command is also available forentering the configuration mode, or configuring the switch from an existing configuration file.The following table lists the commands that are accessible only from the top level of the CLI.Table 1: Top-level commands

    Command Definitionconfigure Configure from [flash | network | terminal].debug Access debug commands.file Access file commands.password Change the user password.reboot Reboot the system.test Access test commands.

    Global commandsFrom the top level of the CLI, you can also access additional operational commands includingclear, pin, save, show, telnet, and trace. These commands are available from any level of theCLI.The following table lists the global commands are available from any level of the CLI.Table 2: Global commands

    Command Definitionclear Access clear commands.ping Invoke ping to IP host.ping6 Invoke pint to IPv6 host.save Save configuration to [local | network].show Access show commands.telnet Open a Telnet connection.trace Trace the route to a destination address or

    host name.trace6 Trace the route to an IPv6 destination

    address or host name.

    CLI fundamentals

    10 Using the Command Line Interface October 2010

  • Configuration modeTo configure the router system parameters, you must enter the configuration mode using theconfigure terminal command. For example:

    SR4134# configure terminalSR4134/configure#

    From the configuration mode, you can configure router system parameters for theSR2330/4134. You can also access configuration commands for specific interfaces, modules,or features. For detailed configuration commands, refer to

    Context-sensitive configuration commandsTo configure parameters for certain interfaces, modules, or features, you must first select thedesired object to configure. For example, you can select an interface from the configurationmode by entering the interface command. Or you can configure the firewall parameters byentering the firewall command.When you select a particular object, the CLI prompt level changes to display the object that isselected. Any subsequent commands that you enter apply only to the selected object until youexit the command level for that object.For example, the following displays the commands required to select Ethernet interface in slot0, port 1 for configuration.

    SR4134# configure terminalSR4134/configure# interface ethernet 0/1Configuring existing Ethernet interfaceSR4134/configure/interface/ethernet (0/1)#

    The commands available differ depending on the particular object selected.

    Configuration mode

    Using the Command Line Interface October 2010 11

  • CLI user access levelsThe CLI supports four levels of privilege.

    Privilege level Privilege name Definition1 (highest) PRIVILEGE_ADMIN Admin level Can access any

    command and configure anyfeature in the router, including userconfiguration and administration.

    2 PRIVILEGE_CONFIGURE Configure level Can configure anyfeature. Cannot add or delete users.

    3 PRIVILEGE_TEST Test level Can only run diagnostictests. Cannot access configurationcommands.

    4 (lowest) PRIVILEGE_NORMAL Normal level Can only enter showor display commands.

    Multiple concurrent CLI usersA single user can issue commands through the console interface. In addition, multipleconcurrent users can telnet and issue commands.

    Important:To avoid multiple users from issuing configuration commands simultaneously, only one useris allowed to enter the configuration mode at one time. A console connection with a consoletimeout value of 0 seconds will prevent other users from entering the configuration modeindefinitely . To work around this issue, enter the debug clear_clisession command.To avoid this issue, you can also configure the console timeout (using theconsole_timeout command).Alternatively, if the active session that is locking other users out of the configuration modeis a Telnet session, you can disconnect the session using the clear telnet_sessioncommand.Use the show users command to identify the session to be cleared.

    CLI fundamentals

    12 Using the Command Line Interface October 2010

  • Context-sensitive helpThe CLI provides text-based, context-sensitive help. To access this help, enter a question mark(?) at the current command level, or after typing a partial or full command string. The CLIdisplays the commands available at that level, or the options available for the specifiedcommand.The following figure shows a sample output for the show ? command.

    In addition, you can also manually scroll through the options available at the current commandlevel or to complete a particular command string by repeatedly pressing the Tab key.

    Command-specific helpThe help command displays help for the command specified in . This helpprovides the same description of command options available through context-sensitive help.However, command-specific help also provides a description of the command itself, as well asthe correct syntax required for the command.The following figure shows a sample output for the help configure command.

    Context-sensitive help

    Using the Command Line Interface October 2010 13

  • Command treeThe tree command displays a tree of all CLI commands associated with the current commandmode or level.The following figure shows a sample output for the tree command.

    Navigation keysYou can change the location of the cursor and edit commands in the CLI using the keycombinations shown in the following table.The help edit command displays a table containing most of the information below.Table 3: help edit output

    Key stroke ActionTAB complete the commandEsc+B go back one wordEsc+F go forward one wordEsc+DEL delete one word left to cursorBackSpace go back and delete one characterCtrl+A go back to the start of the lineCtrl+B / Left arrow () go back one characterCtrl+D / DEL delete a character

    CLI fundamentals

    14 Using the Command Line Interface October 2010

  • Key stroke ActionOR

    if the line is empty, go up one levelCtrl+E go forward to the end of the lineCtrl+F / Right arrow () go forward one characterCtrl-K delete the line ahead of the cursorCtrl+L refresh the lineCtrl+N / Down arrow () go to the next command in historyCtrl+P / Up arrow () go to the previous command in historyCtrl+U delete the entire lineCtrl+W delete one word left to cursorCtrl+Z exit to top level

    Navigation commandsThe following commands provide additional navigation in the CLI.Table 4: Navigation commands

    Command Definitionexit Exit exits the specified number of command levels. When

    this command is executed from the top level, it terminates the CLIsession.

    pop In configuration mode, the pop command sets the command level backto the main configuration mode level ( SR4134/configure# .

    no commandThe no command is always used as a prefix to a command to negate the action performed bythat command. The no command removes or clears the configuration or operation controlledby the specified command.

    Navigation commands

    Using the Command Line Interface October 2010 15

  • Command abbreviationsThe SR2330/4134 accepts abbreviations for commands, as long as there is only one possiblechoice to complete the abbreviated command. For example, sh in 2/3 is an acceptableabbreviation for the show interface command.

    Command historyThe CLI maintains a list of entered commands. From the command line, you can scroll throughthe list of previously executed commands by pressing the up arrow key (). The CLI stores amaximum of 100 commands.

    Configuration fileIn addition to manual configuration, you can set the router system parameters using aconfiguration file stored in flash memory, or on a network server. This is useful for restoring asaved configuration to your router, or for copying a saved configuration to another router.Configuration files have a .cfg extension.Create a config file by using the save command.

    Module slot and port numberingThe SR2330/4134 supports a variety of modules, each with unique configuration requirements.To configure these modules, you must specify the slot in which the module is located, andtypically the individual port on the module to configure, in the format slot/port.As shown in the following figure, the SR4134 chassis provides a slot numbering legend directlyabove Chassis SFP Ethernet ports 0/3 and 0/4. The legend shows how slots are numberedon the Secure Router 4134.

    CLI fundamentals

    16 Using the Command Line Interface October 2010

  • Figure 1: Secure Router 4134 slot numbering legendSlots 1 through 4 are Small Module slots, and slots 5 through 7 are Medium Module slots. Ifyou insert a Large Module, it spans slots 6 and 7. In this case, the Large Module is identifiedin the Command Line Interface (CLI) as slot 6.The slot/port format also applies to the onboard Chassis Ethernet ports, but for these ports,the assigned slot number is 0. As a result, the rear panel Fast Ethernet management port isnumbered 0/0, and the front panel Gigabit Ethernet ports are number 0/1 through 0/4.With the Secure Router 2330, all slots and ports are labelled directly on the chassis.The following figure shows the front panel of the Secure Router 2330.

    Figure 2: Secure Router 2330 front panelThe following table describes the built-in slots and ports available on the front panel of theSecure Router 2330.Table 5: Secure Router 2330 front panel description

    Item Description1 Small Module slot 12 Small Module slot 23 Small Module slot 34 Power input5 Four Fast Ethernet ports (FE 0/1 through FE 0/4)

    Module slot and port numbering

    Using the Command Line Interface October 2010 17

  • Item Description6 Two 10/100/1000Base-T ports (GE 0/5 and 0/6), which use dual RJ-45

    connector with integrated Gigabit Ethernet magnetics7 Two Small Form-factor Pluggable (SFP) ports (GE 0/7 and 0/8), for plug-in SFP

    modules8 Console port9 Compact Flash slot (CF1)10 Ground lug

    For more information about the supported modules for the SR2330/4134, see Avaya SecureRouter 2330/4134 Installation Hardware Components (NN47263-500).

    Secure Router 4134 Voice Carrier medium module subslotsThe Voice Carrier medium module (VCMM) allows you to expand the number of available smallslots on the SR4134. When installed in a medium slot, the module provides four additionalsubslots that can house up to four small FXS or FXO modules. Only FXS or FXO modules canbe installed in the Voice Carrier module.The following figure shows the four-slot Voice Carrier medium module with slot covers installedand identifies the subslot numbers. To configure modules in the Voice Carrier medium module,you must specify the medium slot in which the Voice Carrier module is located, the subslot inwhich the FXS or FXO module is located, and typically the individual port on the module toconfigure, in the format slot/subslot/port.

    Figure 3: Voice carrier medium module subslot numbering

    CLI fundamentals

    18 Using the Command Line Interface October 2010

  • Chapter 4: Boot CLI fundamentals

    The Boot command line interface (CLI) is a text-based interface that provides commands for configuringthe router boot process. You can access the Boot CLI only through a direct connection to the console portand only during the boot process. To access the Boot CLI, during the boot process press any key until theboot prompt appears.This section contains information about the basic Boot CLI commands with the Avaya Secure Router2330/4134.You can specify to boot the router from any of the following locations: TFTP, FTP, CF0, CF1, or USB.CF0 is the main internal Compact Flash memory where the system image and configuration files arestored. CF1 is the external Compact Flash slot.

    Boot CLI command listThe following table contains descriptions of the Boot CLI commands.Table 6: Boot CLI command list

    ? print this list@ boot (load and go)p print boot parametersc change boot parametersg go to addressd adrs[,n] display memorym modify memoryf adrs, nbytes,value

    fill memory

    t adrs, adrs,nbytes

    copy memory

    e print fatal exceptionv print boot logo with versionn netif print network interface device addressavailable boot devices are: "tftp","ftp","cf0","cf1","usb"

    Using the Command Line Interface October 2010 19

  • o show bootrom header informationb show file list in a USB deviceB format a USB deviceL [0|1] show file list in CF0 or CF1.F [0|1] format the CF0 or CF1A show simple PCI device scan resultT dram test after cold resetr show current boot image (Golden/Normal)R select a boot image will be running at the next boots show simple slot insertion statusw print status of watchdog timerV adrs, nbytes,value

    clear NVRAM area with value

    D cold resetX reset to factory (NVRAM/CF)Checksum enable:0 disable checking image checksum1 enable checking image checksumShow header enable:0 disable showing image header contents1 enable showing image header contentsSave bootrom image:0 autoupdate NORMAL boot area rom image by checking version

    autosync GOLDEN boot area rom image by checking baseline_versionbaseline_version : base version for updating GOLDEN boot

    1 save boot image on the NORMAL flash area2 save boot image on the GOLDEN flash area3 No bootrom updateBoot image redundancyNORMAL bootimage

    Default boot image saved on the NORMAL boot area

    GOLDEN bootimage

    Backup boot image saved on the GOLDEN boot area - GOLDEN imagearea should not be corrupted

    Boot CLI fundamentals

    20 Using the Command Line Interface October 2010

  • From the CLI, you can view the configure boot parameters using the show boot command.You can also configure boot parameters using the boot_params command.

    Boot CLI command list

    Using the Command Line Interface October 2010 21

  • Boot CLI fundamentals

    22 Using the Command Line Interface October 2010

  • Chapter 5: Basic CLI operations

    Perform the basic CLI operations to log on to the switch, configure the switch from a terminal, or configurethe switch using saved configuration files from flash or the network.

    PrerequisitesValid CLI username and password. (Default username is admin and default password issetup).

    Navigation Logging on on page 24 Configuring the router from a terminal on page 24 Configuring users on page 24 Modifying the administrator account user name on page 25 Modifying passwords for other users on page 26 Modifying your own password on page 26 Saving the current configuration to file on page 27 Encrypting password display on page 27 Adding a header to the configuration file on page 28 Adding comments at the beginning of a configuration on page 28 Adding comments to the end of a configuration on page 28 Configuring the router using configuration files from flash on page 29 Configuring the router using configuration files from the network on page 29 Configuring the timeout for console sessions on page 30 Displaying the console timeout on page 30 Displaying configured user accounts on page 30 Displaying connected users on page 30

    Using the Command Line Interface October 2010 23

  • Displaying user account for current session on page 31 Displaying running configuration on page 31 Displaying stored configuration on page 31 Displaying system configuration on page 31

    Logging onLog on to the CLI to access the switch configuration commands.Procedure steps

    1. After the Avaya Secure Router 2330/4134 powers on and the following login promptappears:loginenter the username (default is admin)The CLI prompts for the password:password:

    2. Enter your user password (default is setup)For detailed information about configuring passwords and administering users, refer to AvayaSecure Router 2330/4134 Commissioning (NN47263-500).

    Configuring the router from a terminalEnter the configuration command mode from a console terminal or management workstationto manually configure the router system parameters.Procedure steps

    To configure the router from a terminal, enter:configure terminal

    Configuring usersConfigure additional usernames and passwords to provide access to the SR2330/4134 toothers.

    Basic CLI operations

    24 Using the Command Line Interface October 2010

  • To configure users, you must log in with level 1 user privileges using the administrator account.You can configure any new user to have a user privilege level from 2 to 4. The administratoraccount is the only account that has level 1 privileges.Procedure steps

    1. To enter the configuration mode, enter:configure terminal

    2. To create a user, enter:user []The system prompts you to enter a password:Please enter new password:

    3. Enter the password.The system prompts you to confirm the password:Please re-enter password:

    4. Reenter the password.The system provides a system message confirming that the user has been added:password is set user is added

    Modifying the administrator account user nameModify the administrator account user name.To modify the administrator user name, you must log in with level 1 user privileges using theadministrator account (default user name is admin and password is setup).Procedure steps

    1. To enter the configuration mode, enter:configure terminal

    2. To modify the administrator account name, enter:admin_name

    Modifying the administrator account user name

    Using the Command Line Interface October 2010 25

  • Modifying passwords for other usersWhen you are logged in with level 1 privileges using the administrator user account, you canchange the passwords of other users.Procedure steps

    1. To change a user password, enter:passwordThe system prompts you for the user name:name:

    2. Enter the user name.The system prompts you to enter the new password:new password:

    3. Enter the new password.The system prompts you to reenter the new password:re-enter password:

    4. Reenter the new password.The system confirms the password change:password has been changed

    Modifying your own passwordWhen you are logged in using a non-administrator account, you can only change your ownconfigured user password.Procedure steps

    1. To change the existing password for your account, enter:passwordThe system prompts you to enter the old password:old password:

    2. Enter the old password.The system prompts you to enter the new password:

    Basic CLI operations

    26 Using the Command Line Interface October 2010

  • new password:3. Enter the new password.

    The system prompts you to reenter the new password:re-enter password:

    4. Reenter the new password.The system confirms the password change:password has been changed

    Saving the current configuration to fileSave the current configuration to a .cfg file on the flash. Save your configuration to flash eachtime you make configuration changes to allow the system to boot from the latest configurationupon subsequent reboot. You can also save the configuration to a network location using TFTP,providing a backup of your configuration, or to copy the configuration to another router.Procedure steps

    To save the current configuration file, enter:save {local | network }

    Encrypting password displayEncrypt the user passwords to ensure that no one can view them in plain text when they aredisplayed on screen, or viewed in the configuration file. Use the no form of the command todisplay passwords in plain text.Procedure steps

    1. To enter the configuration mode, enter:configure terminal

    2. To encrypt the passwords, enter:[no] secure_passwords

    Saving the current configuration to file

    Using the Command Line Interface October 2010 27

  • Adding a header to the configuration fileAdd a header to add some descriptive information to the top of the configuration file. Themaximum length of the header is 80 characters.Procedure steps

    1. To enter the configuration mode, enter:configure terminal

    2. To add a header to the configuration file, enter:header ""

    3. To save the header information to the configuration file, enter:save local

    Adding comments at the beginning of a configurationAdd comments at the beginning of a configuration. The comments appear after saving theconfiguration using the save local command.The maximum length of the comment string is 80 characters.Procedure steps

    1. To enter the configuration mode, enter:configure terminal

    2. To add comments at the beginning of a configuration, enter:SYS_REM ""

    Adding comments to the end of a configurationAdd comments to the end of a configuration. The comments appear after saving theconfiguration using the save local command.The maximum length of the comment string is 80 characters.

    Basic CLI operations

    28 Using the Command Line Interface October 2010

  • Procedure steps1. To enter the configuration mode, enter:

    configure terminal2. To add comments to the end of a configuration, enter:

    SYS_REM_ ""

    Configuring the router using configuration files from flashCopy a saved .cfg file from flash to the router to reinstate a previously saved configuration.Procedure steps

    1. To configure the router using configuration files saved in flash, enter:configure flashThe router responds with the following prompt:filename:

    2. Enter the full file name, for example .SR4134.cfg

    Configuring the router using configuration files from thenetwork

    Copy a .cfg file from the network to the router to reinstate a previously saved configuration.Procedure steps

    1. To configure the router using configuration files saved in a network location, enter:configure networkThe router responds with the following prompt:host:

    2. Enter the DNS host name or IP addressThe router responds with the following prompt:filename:

    3. Enter the full file name, for example :

    Configuring the router using configuration files from flash

    Using the Command Line Interface October 2010 29

  • SR4134.cfg

    Configuring the timeout for console sessionsConfigure a timeout in seconds for console sessions. The default value is 900 seconds.Procedure steps

    1. To enter the configuration mode, enter:configure terminal

    2. To configure the timeout for a console session, enter:console_timeout

    Displaying the console timeoutDisplay the configured console timeout value.Procedure steps

    To display the timeout value for console sessions, enter:show console_timeout

    Displaying configured user accountsDisplay configured users and their associated account levels.Procedure steps

    To display all configured users and their associated account levels, enter:show user_accounts

    Displaying connected usersDisplay users who are actively connected to the router.

    Basic CLI operations

    30 Using the Command Line Interface October 2010

  • Procedure stepsTo display all users who are actively connected to the router, enter:show users

    Displaying user account for current sessionDisplay the account used to log on to the router for the current session.Procedure steps

    To display the user account used for the current session, enter:show whoami

    Displaying running configurationDisplay the current running configuration.Procedure steps

    To display the running configuration , enter:show configuration running

    Displaying stored configurationDisplay the configuration that is stored in Flash.Procedure steps

    To display the stored configuration , enter:show configuration stored

    Displaying system configurationDisplay the system configuration.

    Displaying user account for current session

    Using the Command Line Interface October 2010 31

  • With release 10.2, the output of the show system configuration is modified so that theslot allocation is shown in consecutive order.Procedure steps

    To display the system configuration , enter:show system configuration

    Basic CLI operations

    32 Using the Command Line Interface October 2010

  • Chapter 6: File management

    Use the file management commands to manage files on the compact flash and USB, including copy,delete, download, and upload.

    Navigation Copying files to and from compact flash or USB on page 33 Downloading files from the network to compact flash or USB on page 34 Uploading a file from compact flash or USB to the network on page 34 Formatting a compact flash or USB device on page 35 Renaming a file on compact flash or USB on page 35 Removing a file from compact flash or USB on page 36 Uploading the event log to the network on page 36 Displaying the file list from compact flash or USB on page 36 Displaying image file versions from compact flash or USB on page 36 Displaying Boot ROM file information on page 37

    Copying files to and from compact flash or USBCopy a file in compact flash memory or USB memory and assign the copy a new name.Procedure steps

    To copy a file to or from compact flash or USB, enter:

    Using the Command Line Interface October 2010 33

  • file copy {/cf0/ | /cf1/ | /usb0/} {/cf0/ | /cf1/ | /usb0/}

    Table 7: Variable definitions

    Variable Value{/cf0/ | /cf1/ | /usb0/}

    Specifies the source filename to be copied.

    {/cf0/ | /cf1/| /usb0/}

    Specifies the destination filename.

    Downloading files from the network to compact flash or USBDownload a file from a remote host to compact flash or USB memory. You can transfer the fileusing either TFTP or FTP. If you use this command with an FTP server, you must specify theFTP user ID and password for authentication.Procedure steps

    To download a file to compact flash or USB, enter:file download {/cf0/ | /cf1/ | /usb0/}

    Table 8: Variable definitions

    Variable Value Specifies the source host (server) IP or IPv6

    address. Specifies the path name of the source file.{/cf0/ | /cf1/ | /usb0/}

    Specifies the location and name of the filedestination.

    Uploading a file from compact flash or USB to the networkUpload a file from compact flash or USB memory to a remote host. You can transfer the fileusing either TFTP or FTP. If you use this command with an FTP server, you must specify theFTP user ID and password for authentication.

    To upload a file from compact flash or USB, enter:

    File management

    34 Using the Command Line Interface October 2010

  • file upload {/cf0/ | /cf1/ | /usb0/} [] [] []

    Table 9: Variable definitions

    Variable Value Specifies the destination host (server) IP or

    IPv6 address. Specifies the destination path name for the

    file.{/cf0/ | /cf1/ | /usb0/}

    Specifies the source filename to beuploaded.

    [] Specifies the outgoing interface.[] Specifies the FTP user ID.[] Specifies the FTP password.

    Formatting a compact flash or USB deviceFormat the compact flash or USB memory.Procedure steps

    To format the compact flash or USB, enter:file format [/cf0 | /cf1 | /usb0]

    Renaming a file on compact flash or USBRename a file on compact flash or USBProcedure steps

    To rename a file on compact flash or USB, enter:

    Formatting a compact flash or USB device

    Using the Command Line Interface October 2010 35

  • file rename {/cf0/ | /cf1/ | /usb0/}

    Removing a file from compact flash or USBRemove a file from compact flash or USBProcedure steps

    To remove a file from compact flash or USB, enter:file rm {/cf0/ | /cf1/ | /usb0/}

    Uploading the event log to the networkUpload the event log to a network location.

    To upload the event log to a network location, enter:file upload_event_log

    Displaying the file list from compact flash or USBDisplay all files that are saved on the compact flash (CF0 or CF1) or USB. By default, CF0 filesare shown.Procedure steps

    To display the file list, enter:[show] file ls [/cf0 | /cf1 | /usb0]

    Displaying image file versions from compact flash or USBDisplay the image file versions that are saved on compact flash (CF0 or CF1) or USB. Bydefault, CF0 files are shown.Procedure steps

    To display the image file versions, enter:

    File management

    36 Using the Command Line Interface October 2010

  • [show] file version [/cf0 | /cf1 | /usb0]

    Displaying Boot ROM file informationthe Display information about the Golden and Normal boot files.Procedure steps

    To display the Boot ROM information, enter:file show_boot

    Displaying Boot ROM file information

    Using the Command Line Interface October 2010 37

  • File management

    38 Using the Command Line Interface October 2010

    ContentsChapter1:New in this releaseOther changes

    Chapter2:IntroductionNavigation

    Chapter3:CLI fundamentalsNavigationTop-level commandsGlobal commandsConfiguration modeContext-sensitive configuration commandsCLI user access levelsMultiple concurrent CLI usersContext-sensitive helpCommand-specific helpCommand treeNavigation keysNavigation commandsno commandCommand abbreviationsCommand historyConfiguration fileModule slot and port numberingSecure Router 4134 Voice Carrier medium module subslots

    Chapter4:Boot CLI fundamentalsBoot CLI command list

    Chapter5:Basic CLI operationsPrerequisitesNavigationLogging onConfiguring the router from a terminalConfiguring usersModifying the administrator account user nameModifying passwords for other usersModifying your own passwordSaving the current configuration to fileEncrypting password displayAdding a header to the configuration fileAdding comments at the beginning of a configurationAdding comments to the end of a configurationConfiguring the router using configuration files from flashConfiguring the router using configuration files from the networkConfiguring the timeout for console sessionsDisplaying the console timeoutDisplaying configured user accountsDisplaying connected usersDisplaying user account for current sessionDisplaying running configurationDisplaying stored configurationDisplaying system configuration

    Chapter6:File managementNavigationCopying files to and from compact flash or USBDownloading files from the network to compact flash or USBUploading a file from compact flash or USB to the networkFormatting a compact flash or USB deviceRenaming a file on compact flash or USBRemoving a file from compact flash or USBUploading the event log to the networkDisplaying the file list from compact flash or USBDisplaying image file versions from compact flash or USBDisplaying Boot ROM file information